Cómo hacer que tu agente de IA inicie una conversación o envíe un recordatorio
Para escribirle al cliente sin un nuevo mensaje entrante, envía desde tu escenario una solicitud POST /api/connect/send con el conversation_id guardado y el texto del mensaje. AnyLinga enviará el mensaje al cliente en nombre de tu IA.
Cómo funciona el envío sin un mensaje entrante
El escenario debe guardar previamente el conversation_id de la solicitud entrante. Con este identificador puedes enviar un recordatorio a una conversación existente de tu cuenta.
La entrega funciona igual que una respuesta normal: reply_text se traduce al idioma del cliente y el mensaje aparece en el chat de Kommo.
Cómo enviar un mensaje desde el escenario
1. Guarda el identificador de la conversación
- Toma el
conversation_idde la solicitud entrante y guárdalo en tu escenario.
2. Configura la solicitud HTTP
- Usa
POST /api/connect/senden el mismo servidor indicado en URL de callback. Reemplaza la ruta/api/connect/callbackpor/api/connect/send. - Envía el mismo encabezado
Authorization: Bearer <Token de callback>.
3. Completa el cuerpo de la solicitud y envíala
- Indica
conversation_idyreply_texty/otemplate_ids. - Para un recordatorio de texto, usa el ejemplo de abajo. Si envías plantillas, incluye hasta 5 plantillas en
template_ids.
{
"conversation_id": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7a9c4f12",
"reply_text": "Hola. Preguntaste por el envío, ¿todavía te interesa?"
}
Cuándo puedes escribir por WhatsApp
En WhatsApp y WhatsApp Business API solo puedes enviar un mensaje dentro de las 24 horas posteriores al último mensaje del cliente.
Después, la solicitud devolverá 409 con el cuerpo {"error": "outside_window"}. La restricción también se aplica a las plantillas. En los demás canales no se realiza esta comprobación.
Códigos de respuesta
| Código | Qué significa |
|---|---|
200 | Enviado. |
400 | Falta conversation_id o no se incluyó ni reply_text ni template_ids. |
401 | Token incorrecto. |
404 | No se encontró la conversación o la plantilla. |
409 outside_window | Pasaron más de 24 horas desde el último mensaje del cliente en WhatsApp. |
500 / 502 | No se pudo entregar. |
Preguntas relacionadas
cómo enviar una plantilla, foto o video · qué campos recibe el escenario · cómo conectar un agente de IA mediante n8n
¿Tienes preguntas?
Respondemos en horario laboral.