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:- Visita realizada: la arranca tu sistema. Guarda el código de la propiedad en el contacto y manda una plantilla con un botón.
- 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
4. Arranca la automatización desde tu sistema
Cuando una visita pasa a “realizada”, llama aPOST /automations/{id}/runs con el teléfono y los datos de la visita:
visitas.js
201
5. Recibe la calificación
El paso Solicitud HTTP de la encuesta le manda a tu sistema unPOST firmado con el token de la automatización (ats_…). Verifica la firma igual que un webhook, pero con ese token:
encuestas.js
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 eventoautomation.failed y búscala por el runId que guardaste:
Cuida los detalles
Si la interesada está en medio de otra automatización
Si la interesada está en medio de otra automatización
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.Si tu equipo está hablando con ella
Si tu equipo está hablando con ella
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.
No mandes dos veces la misma encuesta
No mandes dos veces la misma encuesta
Guarda el
runId junto a la visita y no vuelvas a llamar si ya tienes uno. La API no deduplica por ti.Mide cómo funciona
Mide cómo funciona
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.

