🔗 Cómo crear flujos para campañas con Webhooks paso a paso
En este artículo te explicamos cómo configurar flujos en Atom que se disparen mediante Webhooks. Esto te permite automatizar la ejecución de campañas de WhatsApp directamente desde sistemas externos, como tu CRM o ERP.
🏗️ Armado del Flujo con Webhooks
1. Ubicación en Flowbuilder
Dirígete al menú lateral izquierdo: Campañas > Flujos > Crear Flujo.
Selecciona Crear Flujo desde Cero.
Elige el número de WhatsApp desde el cual se enviará la campaña.
Define como disparador (Trigger) el componente Webhook.
2. Configuración del Webhook
Para que el Webhook funcione, debes considerar lo siguiente:
Campo obligatorio: El parámetro por defecto siempre será "phone".
Formato del teléfono: Debe incluir el signo
+y el código de área (ej.+573001234567) sin espacios ni guiones.Campos requeridos: Son los datos indispensables para procesar el envío con éxito. Su contenido varía según los campos de información vinculados a la plantilla de comunicación seleccionada para el cliente.
3. Conexión con Plantillas
Para enviar una campaña, es indispensable conectar el componente Webhook con el componente Plantilla.
Ve a Configuraciones > Mensajería > Plantillas para crear una, o usa la función Crear Plantilla dentro del Flowbuilder.
Si la plantilla tiene variables (campos personalizados), estos se convertirán automáticamente en parámetros obligatorios para el Webhook.
🔗 Obtención de Parámetros y URL
Una vez diseñado el flujo, necesitas los datos para integrarlos en tu CRM o sistema externo. Tienes dos formas de obtenerlos:
Desde el editor (Antes de publicar): Haz doble clic en el componente Webhook y selecciona "Mostrar petición POST". Verás el JSON con los campos entre llaves
{}.
Desde el visor (Flujo activo): En el módulo de Campañas, selecciona el flujo y usa la acción "Ver flujo". Dentro del componente encontrarás:
Botón 1: Copia la URL del Webhook.
Botón 2: Copia los campos en formato JSON.
Ejemplo de estructura JSON:
JSON
{
"empresa": "Dato a enviar",
"first_name": "Dato a enviar",
"nombre_agente": "Dato a enviar",
"phone": "Dato a enviar"
}
🧪 Pruebas con Postman
Antes de poner la campaña en producción, simula la ejecución siguiendo estos pasos:
URL: Copia la URL desde el submódulo de Webhooks en Campañas.
Headers:
Content-Type: application/json
Authorization: Bearer [Tu_Token_API] (Obtén el token en Mi Empresa > Configuración de seguridad).
Body: Selecciona formato raw e ingresa el JSON con los datos de prueba. Todos los valores deben ir entre comillas dobles.
📊 Códigos de Respuesta comunes
Escenario | Código | Cuerpo de la Respuesta |
Envío satisfactorio | 200 |
|
Token inexistente | 401 |
|
Token incorrecto | 404 |
|
Falta parámetro | 500 |
|
Simulación activa | 500 |
|
🔄 Devolver datos mediante Petición HTTP
Si además de recibir datos quieres que el flujo envíe información de vuelta a tu sistema al finalizar:
Inserta el componente Petición HTTP con método POST.
Ingresa la URL de tu sistema.
Activa el interruptor de Cuerpo y redacta el JSON.
Usa la tecla "/" (barra) para insertar dinámicamente los campos de información capturados durante la conversación (ej. la identificación que el cliente escribió en el chat).
Si deseas más información revisa el siguiente artículo: Componente petición HTTP
⚠️ Consideraciones Importantes
Autenticación: El uso de Webhooks requiere obligatoriamente el Token API. Si generas uno nuevo, recuerda actualizarlo en todas tus integraciones activas.
Prioridad de atención: Si el Webhook intenta dispararse pero el cliente ya tiene una conversación activa con un asesor, la ejecución se suspenderá automáticamente para no interferir con la atención humana.
¡Conecta tus sistemas y deja que la automatización haga el resto! 🚀
Los Webhooks son la llave maestra para disparar campañas desde tu CRM de forma inteligente. Asegúrate de probar siempre tus conexiones en Postman, valida que el número telefónico tenga el formato internacional correcto (+ código) y mantén a salvo tu Token API. ¡Listos para enviar! ✅