AutomatizaciónWebhook Saliente

Webhooks Salientes: Enviar Datos del Chatbot a Plataformas Externas

Aprende a enviar datos de conversaciones de WhatsApp a CRMs, hojas de cálculo y otras plataformas mediante webhooks salientes.

Los webhooks salientes permiten que tu chatbot de WhatsApp envíe datos automáticamente a plataformas externas como CRMs, Google Sheets, Make.com, Zapier o sistemas propios para centralizar la información de tus leads.

¿Qué es un Webhook Saliente?

Un webhook saliente (outbound webhook) es una URL a la que tu chatbot envía datos automáticamente cuando ocurre un evento específico. Es como un "mensajero digital" que lleva la información del chatbot a otras aplicaciones.

¿Para Qué Sirve?

Tipos de Datos que Puedes Enviar

DatoDescripciónUso típico
Nombre del contactoNombre del usuarioCrear perfil en CRM
Número de teléfonoWhatsApp ID del usuarioIdentificador único
MensajeTexto completo del mensajeAnálisis de conversaciones
Fecha/HoraCuándo ocurrió la conversaciónMétricas y reportes
EtiquetasTags asignados al contactoSegmentación
Bot activadoQué flujo se ejecutóOptimización de chatbot
Respuesta del botLo que el bot respondióAuditoría de calidad

Cómo Configurar un Webhook Saliente

Accede a la configuración de webhooks

En E-SMART360, ve a Configuración > Integraciones > Webhooks o APIs and Webhooks.

Crea un nuevo webhook

Haz clic en "Nuevo webhook saliente" o "Create Outbound Webhook".

Configura los parámetros esenciales

  • URL del endpoint: La dirección donde se enviarán los datos (ej: tu API de CRM)
  • Método HTTP: Generalmente POST o PUT
  • Headers: Configura autenticación (Bearer token, API key, etc.)
  • Content-Type: application/json (recomendado)

Selecciona los datos a enviar

Elige qué campos del contacto y la conversación enviar. Generalmente puedes mapear:

{
  "name": "{{contact_name}}",
  "phone": "{{contact_phone}}",
  "message": "{{message_text}}",
  "timestamp": "{{message_timestamp}}",
  "tags": "{{contact_tags}}",
  "bot_name": "{{matched_bot}}",
  "bot_response": "{{bot_reply}}"
}

Prueba la conexión

E-SMART360 ofrece un botón "Probar conexión" o "Test". Envía un webhook de prueba y verifica que tu sistema externo reciba los datos correctamente.

Guarda y activa

Una vez que la prueba sea exitosa, guarda el webhook. Dependiendo de la configuración, puede activarse para:

  • Todas las conversaciones: Cada mensaje entrante/saliente
  • Eventos específicos: Solo cuando se active un bot en particular
  • Condiciones: Solo cuando se cumplan ciertos criterios

Configuración Avanzada

Filtros por Eventos

Puedes configurar que el webhook solo se dispare en eventos específicos:

Se envía solo cuando un usuario escribe por primera vez. Ideal para CRMs.

Mapeo de Datos Personalizado

Para sistemas que requieren nombres de campo específicos:

// Ejemplo para HubSpot CRM
{
  "properties": [
    {
      "property": "firstname",
      "value": "{{contact_name}}"
    },
    {
      "property": "phone",
      "value": "{{contact_phone}}"
    },
    {
      "property": "whatsapp_lead_source",
      "value": "Chatbot E-SMART360"
    }
  ]
}

Consideraciones de seguridad:

  • Nunca envíes datos sensibles (contraseñas, información bancaria) por webhook sin cifrado
  • Usa siempre HTTPS en la URL del endpoint
  • Implementa autenticación (API key o token) en tu endpoint receptor
  • Verifica los límites de tasa para no saturar tu sistema externo

Integraciones Populares

PlataformaCaso de usoMétodo
HubSpotCrear contacto + dealAPI de HubSpot via webhook
SalesforceRegistrar leadREST API
Google SheetsBitácora de conversacionesMake.com / Zapier como intermediario
NotionBase de datos de leadsNotion API
SlackNotificar al equipoSlack Webhook
Make.comEscenario complejo multi-pasoWebhook de Make

Solución de Problemas

ProblemaCausaSolución
El webhook no se envíaURL inválida o fuera de servicioVerifica que el endpoint esté activo
Error 401/403Autenticación incorrectaRevisa el token o API key
Datos incompletosMapeo incorrecto de variablesVerifica los nombres de campo
Límite de tasa excedidoDemasiadas solicitudesImplementa rate limiting o batching
TimeoutEl endpoint tarda en responderOptimiza tu endpoint receptor

Recomendación: Usa Make.com o Zapier como intermediario. Así puedes reenviar los datos a múltiples destinos sin configurar webhooks individuales para cada uno.

Próximos Pasos