Tu sistema marca como realizada la visita al depto de Plaza Mitre (código AP-101) y, a los pocos segundos, la interesada recibe por WhatsApp: “¡Hola Sofía! Gracias por visitar la propiedad AP-101. ¿Nos cuentas qué te pareció?”, con un botón. Si lo toca, una automatización le pregunta cómo fue la visita, guarda la respuesta, te la manda a tu sistema y, si algo salió mal, le pasa la conversación a tu equipo. A diferencia de mandar un mensaje con POST /messages, acá tu sistema solo avisa qué pasó. Qué se le dice al cliente, qué se pregunta y a quién se deriva lo cambia tu equipo desde el editor de automatizaciones, sin tocar código.
Necesitas el plan Escala o Enterprise (por la API) y una clave de API.

Por qué son dos automatizaciones

Cuando tu sistema arranca la automatización, la interesada no te escribió hace poco: la ventana de 24 horas está cerrada. Con la ventana cerrada, WhatsApp solo deja mandar plantillas aprobadas, y una Pregunta fallaría. Por eso se arma en dos partes:
  1. Visita realizada: la arranca tu sistema. Guarda el código de la propiedad en el contacto y manda una plantilla con un botón.
  2. Encuesta: arranca cuando la interesada toca el botón. Como acaba de escribir, la ventana está abierta y se le puede preguntar.

1. Prepara la plantilla y el campo

  • En Contactos › Campos, crea un campo de texto con la clave ultima_visita.
  • En Plantillas, crea una de categoría Utilidad con un botón de respuesta rápida Calificar la visita:
    ¡Hola [nombre]! Gracias por visitar la propiedad [propiedad]. ¿Nos cuentas qué te pareció? Son 10 segundos 🙌

2. Arma la automatización “Visita realizada”

Publícala. El id de la automatización lo necesitas para la llamada; lo ves en la URL de Ver URL y token si le agregas un disparador Webhook entrante, o en la dirección del editor.

3. Arma la automatización “Encuesta”

Conecta las dos salidas de la solicitud HTTP (Éxito y Error) a la condición: si tu sistema no responde, la interesada igual recibe su respuesta.
Cuerpo de la solicitud HTTP
Pruébala con Probar con un contacto en tu propio número antes de publicar. Mira Probar y seguir las ejecuciones.

4. Arranca la automatización desde tu sistema

Cuando una visita pasa a “realizada”, llama a POST /automations/{id}/runs con el teléfono y los datos de la visita:
visitas.js
201
Si cierras muchas visitas juntas (por ejemplo, al terminar la agenda del día), no las mandes todas a la vez: ve de a una y deja un pequeño intervalo entre llamadas. Mira Límites.

5. Recibe la calificación

El paso Solicitud HTTP de la encuesta le manda a tu sistema un POST firmado con el token de la automatización (ats_…). Verifica la firma igual que un webhook, pero con ese token:
encuestas.js
La función verificarFirma está en Conectar con tu sistema, en Node y Python.

6. Entérate si algo falló

Si la plantilla no se pudo mandar (por ejemplo, el número no tiene WhatsApp o la plantilla dejó de estar aprobada), la ejecución de Visita realizada falla. Suscribe tu webhook al evento automation.failed y búscala por el runId que guardaste:

Cuida los detalles

Una conversación tiene una sola automatización en curso a la vez. Si ya hay una, la llamada responde 409 con “Esta conversación ya tiene una automatización en curso.” Reintenta más tarde o deja pasar esa encuesta.
Cuando alguien del equipo responde en el chat, las automatizaciones dejan de responder en esa conversación durante 24 horas, para no interrumpir. Si la interesada toca el botón en ese lapso, la Encuesta no arranca: el mensaje le llega a tu equipo en el chat, como cualquier otro.
Guarda el runId junto a la visita y no vuelvas a llamar si ya tienes uno. La API no deduplica por ti.
Sobre el lienzo de cada automatización ves cuántas ejecuciones pasaron por cada paso: cuántas encuestas arrancaron, cuántas llegaron a la pregunta y cuántas por cada respuesta.