Referencia de automatizaciones de WhatsApp: disparadores, pasos, variables y límites
Las automatizaciones de easyCoexistence en un número de WhatsApp parten de un mensaje que llega, un contacto que recibe una etiqueta o una llamada de tu sistema. Un mensaje tiene cuatro coincidencias: Cada mensaje, Tiene palabra clave, Primer mensaje y Fuera de horario. Después vienen los pasos, hasta 30 en una línea y 60 en total, con ramas, preguntas y agentes de IA. Cada mensaje activa como máximo una automatización, y las reglas de palabra clave tienen prioridad.
Pasos en una línea, 60 en total, ramas anidadas hasta 4 niveles; Detener y Volver a un paso solo pueden cerrar una línea.
Por automatización, de hasta 100 caracteres cada una; basta con que coincida una, y las mayúsculas no importan.
Caracteres permitidos en las Instrucciones de un paso Responder con IA, cuyas respuestas se limitan a entre 50 y 2000 tokens.
Duración máxima de un solo paso Esperar: 23 horas, para que el siguiente paso de texto siga dentro de la ventana de 24 horas de Meta.
Tiempo que tiene tu webhook para responder antes de que Llamar a mi webhook falle; si la respuesta incluye un campo reply, se envía al cliente.
Retención de las ejecuciones, con cada mensaje inicial y respuesta; el texto de los mensajes se borra pasada la retención que elijas (30, 90 o 365 días, 90 por defecto).
¿Qué disparadores y coincidencias puede usar una automatización de WhatsApp?
El disparador principal, «Llega un mensaje» (message_received), se activa cuando un cliente escribe al número: texto, fotos, video, documentos, audio, stickers, ubicaciones, tarjetas de contacto, respuestas de botones y listas, y pedidos. Una nota de voz se transcribe con tu clave de OpenAI o de OpenRouter y se guarda como «[voice message]» seguido de las palabras, que una palabra clave puede reconocer; sin esa clave queda como «[voice message]». Las reacciones, los estados y los avisos del sistema nunca inician una ejecución, y los chats de grupo no llegan a la API en un número de Coexistencia. Otros dos disparadores no parten de un mensaje. «Un contacto recibe una etiqueta» (tag_added) se activa cada vez que un contacto alcanzable en el número recibe la etiqueta que indicas, desde un flujo, un agente de IA, tú en Conversaciones o update_contact. «Tu sistema llama a una URL» (webhook_received) se activa cuando tu propio sistema hace un POST con un JSON con un número de teléfono a la URL de la automatización, con el secreto de la automatización como token Bearer, para un pedido nuevo o una reserva; el cuerpo, de hasta 20 KB, está disponible como {{vars.webhook.*}}. En ambos, {{message}} está vacío y una persona que no ha escrito en las últimas 24 horas solo puede recibir un send_template. No hay disparador de horario. En el disparador de mensaje, Fuera de horario considera abiertos los días marcados en «Abierto los» entre Desde y Hasta, en una zona horaria IANA como America/Sao_Paulo; un Hasta anterior a Desde es un turno nocturno (de 22:00 a 06:00), y un día sin marcar cuenta como cerrado todo el día. En la API, hours recibe timezone, days (de 1 = lunes a 7 = domingo, los días en que abres), start y end. Primer mensaje se activa cuando easyCoexistence crea un registro para el chat: el primer mensaje de un cliente desde que se activó una automatización en el número, incluidos los clientes de siempre, o el primero tras 30 días sin actividad. Un chat que abriste desde el teléfono ya cuenta como visto.
¿Cómo funcionan los modos de palabra clave?
En «Dónde debe estar la palabra», Contiene («En cualquier parte del mensaje») es el valor por defecto, Empieza con es «Al inicio» y Es exactamente es «Todo el mensaje»; en la API, keywordMode es contains, starts_with o exact. Al comparar, se quitan los espacios al principio y al final del mensaje y se ignoran las mayúsculas, pero no los acentos ni los signos de puntuación, y Contiene también coincide dentro de palabras más largas. El cuadro «Pruébalo», debajo de Palabras clave, responde «Se ejecuta: coincide» junto con la palabra clave, o «No se ejecuta: ninguna palabra clave coincide», para cualquier texto de prueba que escribas.
| Matches | Does not match | |
|---|---|---|
| Contains "price" | What is the price? · PRICES please | How much is it? |
| Contains "oi" | Oi! · Boa noite (inside noite) | Olá |
| Starts with "menu" | Menu please | Can I see the menu? |
| Is exactly "menu" | Menu · menu with spaces around it | menu? · the menu |
| Contains "preço" | Qual o preço? | Qual o preco? |
¿Qué hace cada paso y qué campos recibe?
Los pasos se ejecutan de arriba abajo, hasta 30 en una línea y 60 en una automatización, ramas incluidas, y al menos uno debe hacer algo más que Esperar, Detener, Dividir en caminos, La IA elige el camino y Volver a un paso. Un paso con ramas contiene una línea de pasos por camino más una línea Si no, y las ramas se anidan hasta 4 niveles. En el menú «Elige un paso», cada uno muestra un nombre y una línea breve, ambos citados abajo para los seis pasos básicos. Hacer una pregunta (ask) envía su Mensaje con hasta 10 botones, de los cuales 3 se muestran como botones pulsables y los demás se listan y se responden por número, espera hasta 1380 minutos la respuesta y la guarda en un campo del contacto como texto, correo electrónico, número, teléfono o uno de los botones; si la respuesta es incorrecta, se repite la pregunta hasta 3 veces. Responde un agente (agent) entrega el mensaje a uno de tus agentes de IA, Enviar una imagen o archivo (send_file) envía una imagen o un PDF de tus archivos, y Pasar a una persona (handoff) pausa el bot en ese chat de 1 a 168 horas, 24 por defecto, y te envía un correo. Dividir en caminos (condition) y La IA elige el camino (ai_decide) crean ramas por reglas o por significado. La IA guarda datos (ai_extract), Guardar en el contacto (set_field) y Etiquetar (tag) escriben campos y etiquetas del contacto, y Llamar a una API (http_request) llama a cualquier API HTTPS y conserva su respuesta JSON como {{vars.<name>...}}. Iniciar automatización (start_automation) ejecuta otra automatización para la misma persona, hasta 3 niveles, Volver a un paso (goto) salta al id de un paso para hacer un bucle, y Avisarme (notify_owner) te envía un correo, como máximo 20 por hora por automatización. Si un paso falla, se omiten los pasos siguientes y la ejecución termina como Fallida. Llamar a mi webhook hace un POST con un JSON que incluye event «automation.step», dry_run, run_id, el número, el contacto (wa_id, name), el mensaje (id, type, text, at) y hasta 10 mensajes recientes del chat, firmado en X-EC-Signature como t=<unix>,v1=<HMAC-SHA256 de «<t>.<body>»> con el «Secreto de firma» del paso. La URL debe ser HTTPS y pública, y no se siguen redirecciones.
¿Qué variables pueden rellenar los pasos?
Cuatro se rellenan con los datos del mensaje que inició la ejecución, escritas entre llaves dobles; {{contact.<field>}} añade un campo del contacto (también contact.name y contact.phone) y {{vars.<path>}} lo que guardaron los pasos anteriores, como la respuesta de un paso Llamar a una API. Funcionan en el Mensaje de Responder con texto, en las variables del cuerpo de una plantilla, en las Instrucciones de Responder con IA y en el texto de otros pasos, como Hacer una pregunta; en las variables de una plantilla, se añaden con los chips «Insertar:». Un valor desconocido, como un perfil sin nombre, queda vacío. Los envíos de plantilla solo llevan variables del cuerpo, por posición, así que todavía no se puede elegir una plantilla con variables con nombre, con imagen o variable en el encabezado, o con un botón con variable, y si una variable queda vacía, Meta rechaza el envío.
- {{
first_name}}: la primera palabra del nombre de perfil de WhatsApp del cliente («Nombre»). - {{name}}: el nombre de perfil completo («Nombre completo»).
- {{message}}: el texto del mensaje, o su marcador, como «[image]», más el pie de foto («Su mensaje»).
- {{phone}}: el número del cliente en formato internacional, solo dígitos y sin el signo más, como 5511999998888 («Su teléfono»).
- En una prueba, el cliente es «Cliente de prueba» y el teléfono es 15550000000.
¿Qué ajustes hay y cuáles son sus valores por defecto?
Hay dos ajustes en «Avanzado», el botón junto al interruptor Activado del editor, y el paso de IA tiene otros dos propios. Un campo que no se indica toma su valor por defecto, tanto en el editor como con create_automation. Los tiempos de espera son fijos y no se configuran: una respuesta de IA tiene 45 segundos y un webhook, 20 segundos. El nombre de una automatización admite hasta 120 caracteres. Un agente de IA tiene sus propios ajustes: mensajes anteriores que lee, de 0 a 40 (20 por defecto), respuesta más larga de 100 a 4000 tokens (800 por defecto), hasta 10 llamadas a herramientas por respuesta (5 por defecto) y horas de traspaso, de 1 a 168 (24 por defecto).
¿Qué automatización responde cuando coinciden varias?
Como máximo una, elegida en un orden fijo: primero Tiene palabra clave, luego Primer mensaje, después Fuera de horario y por último Cada mensaje; dentro del mismo tipo, va primero la automatización más antigua. Solo compiten las automatizaciones activadas y no pausadas, así que si la regla de palabra clave está desactivada, o pausada por una clave de IA rechazada, responde en su lugar la automatización general. Hay dos consecuencias que suelen sorprender. Un cliente nuevo que escribe de noche recibe la automatización de Primer mensaje, no la de Fuera de horario, porque Primer mensaje tiene más prioridad. Y un mensaje al que responde una automatización de palabra clave nunca llega a un agente de IA ni a un paso Responder con IA en Cada mensaje, así que, si quieres ambas cosas, pon el agente o el paso de IA dentro de la automatización de palabra clave. Un mensaje que responde a un paso Hacer una pregunta abierto pertenece a esa pregunta, y ninguna otra automatización se inicia con él. Las automatizaciones de etiqueta y de webhook se inician con sus propios eventos y no participan en este orden.
¿Qué protecciones vienen integradas?
El motor las aplica sin necesidad de configurar nada, y cuando detienen una ejecución, los motivos de omisión de la pestaña Ejecuciones las nombran:
- Un mensaje que Meta entrega dos veces inicia una sola ejecución: los duplicados se descartan por id de mensaje.
- Las reacciones, los estados, los envíos de la propia automatización y los ecos de lo que envías desde la app nunca inician una ejecución.
- Responder con texto, Hacer una pregunta, Enviar una imagen o archivo, Responder con IA, la respuesta de un agente y la respuesta de un webhook requieren que el último mensaje del cliente tenga menos de 24 horas; Enviar una plantilla no.
- Si respondes desde la app de WhatsApp Business, la automatización se pausa en ese chat, y una ejecución que estaba en espera allí omite los pasos que le quedan.
- Si un mensaje posterior inicia la misma automatización en un chat, sustituye a la ejecución que seguía en espera en un paso Esperar; un mensaje que responde a una pregunta abierta va a esa pregunta.
- Los envíos desde un número se separan al menos 100 ms, por debajo del límite de Meta de 20 por segundo para números de Coexistencia.
- Si un paso falla, recibes un correo, como máximo uno por automatización cada 6 horas; una clave de IA rechazada pausa las automatizaciones que usan ese proveedor y envía un solo correo.
¿Qué parámetros recibe la herramienta create_automation?
El conector MCP tiene diecinueve herramientas para automatizaciones y lo que usan. Ocho son de automatización: set_inbound_mode, list_automations, create_automation, update_automation, delete_automation, test_automation, list_automation_runs y get_automation_run. Ocho son para agentes y archivos: list_agents, list_files, create_agent, update_agent, delete_agent, add_agent_knowledge, delete_agent_knowledge y test_agent. Tres son para personas: list_conversations, get_conversation y update_contact. create_automation recibe connection_id (de list_numbers), name, enabled, trigger, steps y settings, en snake_case como keyword_mode y max_tokens; camelCase también se acepta. Los objetos de paso son reply_text {text}, send_template {name, language, params}, ai_reply {provider, model, prompt, history, max_tokens}, call_webhook {url} y wait {minutes}, luego ask {text, buttons, save_to, expect, retry_text, wait_minutes}, agent {agent_id, wait_seconds}, send_file {file_id, caption}, condition {paths, otherwise}, ai_decide {provider, model, instructions, paths, otherwise}, ai_extract {provider, model, fields}, set_field {key, value}, tag {action, tag}, http_request {method, url, headers, body, save_as}, start_automation {automation_id}, handoff {hours, note}, notify_owner {text}, goto {to} y stop. update_automation conserva los campos que no indicas, y steps, si se incluye, reemplaza la lista completa. Los errores nombran el campo, por ejemplo «trigger.keywords: Add at least one keyword», «steps.2: Stop must be the last step of its line» o «steps.0: save your openai API key on the Automations page first». Las claves de IA nunca pasan por MCP. En el ejemplo, el paso Esperar de 1 minuto hace que un cliente que envía varias líneas seguidas reciba una sola respuesta.
{
"connection_id": "<connection_id from list_numbers>",
"name": "After-hours assistant",
"enabled": false,
"trigger": {
"type": "message_received",
"match": "outside_hours",
"hours": {
"timezone": "America/Sao_Paulo",
"days": [1, 2, 3, 4, 5, 6],
"start": "08:00",
"end": "18:00"
}
},
"steps": [
{ "type": "wait", "minutes": 1 },
{
"type": "ai_reply",
"provider": "openrouter",
"model": "google/gemini-omni-1.2-flash",
"prompt": "You are the assistant of Ana's Bakery. We are closed and open at 8:00. Answer questions about products; a person confirms orders in the morning.",
"history": 10,
"max_tokens": 600
}
],
"settings": { "takeover_hours": 4, "ai_max_per_hour": 10 }
}Errores comunes
- Usar una palabra clave de dos letras con Contiene. «ya» también coincide con «playa» y «yate», así que la automatización responde mensajes que no le corresponden; usa Es exactamente o una palabra clave más larga.
- Poner solo la forma con tilde. La comparación ignora las mayúsculas pero no los acentos, así que «cuánto» no detecta a quien escribe «cuanto»; agrega las dos.
- Esperar que Primer mensaje excluya a los clientes habituales. Se activa con cualquier cliente cuyo chat easyCoexistence no haya visto en 30 días, así que los clientes de siempre reciben la bienvenida en su primer mensaje después de que la actives.
- Elegir una plantilla que necesita una imagen de encabezado o un botón para copiar código. Las automatizaciones solo rellenan variables del cuerpo, así que el editor la muestra pero no te deja elegirla, y si la configuras por MCP, Meta rechaza el envío y la ejecución falla.
easyCoexistence ejecuta estas automatizaciones en el número de WhatsApp Business que sigues usando en la app, a través de la Cloud API de Meta y de la Coexistencia. Créalas en el editor, en Automatizaciones, Nueva automatización, o deja que ChatGPT o Claude llamen a create_automation y test_automation mediante el conector MCP, que tiene más de 30 herramientas. De US$ 9 a US$ 0.75 por número al mes, un precio que baja a medida que añades números, con los primeros 3 días gratis.
Preguntas frecuentes
¿Una automatización puede ramificarse según lo que diga el cliente?
Sí. Dividir en caminos (condition) crea ramas según el texto del mensaje, un campo del contacto, una etiqueta, una respuesta anterior de una API o tu horario de atención, y La IA elige el camino (ai_decide) decide por significado, en cualquier idioma, con tu propio modelo. Cada camino tiene su propia línea de pasos, y una línea Si no recoge el resto. También puedes dejar la decisión a n8n o a tu backend con Llamar a mi webhook, que puede devolver un {"reply": "..."} distinto para cada caso.
¿Hay un límite de automatizaciones o de ejecuciones?
No hay tope de ejecuciones ni cargo extra por ellas, ni límite de automatizaciones por número. Los límites que se aplican son por chat: respuestas de IA por hora, la regla de 24 horas de Meta para el texto y la pausa después de que respondes desde el teléfono.
¿Puedo mover o copiar una automatización a otro número?
Para moverla, cambia su Conexión en el editor o usa update_automation con un nuevo connection_id; las ejecuciones que seguían en espera en el número anterior terminan como reemplazadas. Para copiarla, pide a tu IA que la lea con list_automations y cree el mismo disparador y los mismos pasos en el otro número.
¿Qué pasa con las ejecuciones en espera cuando edito una automatización?
Siguen su curso. Una ejecución detenida en un paso Esperar se reanuda en el siguiente número de paso de la automatización tal como esté guardada en ese momento, así que una edición puede cambiar lo que envía. Para detenerlas, desactiva la automatización: terminan como Omitidas con «La automatización está desactivada».
Sigue leyendo
¿Listo para empezar?
Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.
Empezar prueba gratisVerificado el