Todos los artículos

Envía los contactos de tus DM a tu CRM con webhooks

Por , fundador de Chat335 min de lectura
Una burbuja de chat que envía un flujo de datos a una base de datos y a una caja de tarjetas de contacto

Un contacto que solo existe en los mensajes de Instagram es un contacto que se olvida. La persona pidió una cotización, se postuló para una colaboración o se unió a una lista de espera, y una semana después nadie recuerda quién era.

Los webhooks lo arreglan. Un webhook es un mensaje que tu automatización envía a otro sistema en el momento en que algo ocurre. Pon uno en una automatización de DM y cada contacto llega a donde tu equipo ya trabaja: un CRM, una hoja de cálculo, una mesa de ayuda o tu propia base de datos.

Los dos nodos

Las automatizaciones de Chat33 tienen dos nodos para hablar con otros sistemas.

Enviar datos a un webhook envía una solicitud POST con una descripción en JSON de lo que acaba de pasar a una URL que tú eliges. Es la opción simple, hecha para herramientas receptoras.

Llamar a una API llama a una URL con el método que elijas: GET, POST, PUT o DELETE. Con POST y PUT incluye los mismos datos en el cuerpo. Cada solicitud lleva los ID de la automatización y del contacto como encabezados, X-Flow-Id y X-Contact-Id. Úsalo cuando llames a tu propia API.

Ambos son de un solo sentido: envían datos hacia fuera, y la automatización sigue sin usar la respuesta. Las automatizaciones también corren de arriba abajo de principio a fin; no se detienen a esperar el siguiente mensaje de la persona. Una pregunta que haces en una automatización la responde otra automatización, activada por la respuesta.

Qué envía el webhook

Un nodo Enviar datos a un webhook envía un cuerpo como este:

{
  "event": "flow_webhook",
  "flowId": "flow_123",
  "contactId": "contact_456",
  "recipientId": "1784...",
  "platform": "instagram",
  "triggerText": "Hi, I'd like a quote for 50 units",
  "triggerType": "dm_keyword",
  "keyword": "QUOTE",
  "postId": null,
  "commentId": null,
  "contact": {
    "name": "Anna",
    "externalId": "1784...",
    "platform": "instagram"
  },
  "timestamp": "2026-04-04T10:15:00.000Z"
}

El campo más útil suele ser triggerText: el mensaje o comentario que inició la automatización, con las palabras de la propia persona. keyword es la palabra clave del disparador que coincidió, y en un comentario, postId y commentId indican de qué publicación vino.

Lo que no incluye: direcciones de correo ni números de teléfono. Instagram no los comparte con las apps, así que si tu CRM necesita datos de contacto, pídelos en la conversación o envía un enlace a un formulario.

Si el dato que necesitas es una dirección de correo, un paso Pedir correo la solicita en el DM, y Chat33 puede enviar cada dirección que recopila directo a HubSpot o Mailchimp, sin webhook. Capta contactos de Instagram en HubSpot muestra esa configuración.

Adónde enviarlo

Sirve cualquier cosa que pueda recibir una solicitud HTTPS:

  • El webhook de entrada de una plataforma de automatización. La mayoría ofrece un disparador de tipo "recibir webhook" que te da una URL. Desde ahí, agrega una fila a una hoja de cálculo, crea un contacto en el CRM o publica en un chat de equipo.
  • El webhook de entrada de tu CRM, si tiene uno.
  • Tu propio backend, mediante el nodo Llamar a una API.

Si prefieres llamar a Instagram desde tu propio código, la guía de la API de DM de Instagram muestra lo que eso implica.

Cómo configurarlo

  1. Obtén la URL receptora de la herramienta que va a aceptar los datos.
  2. Agrega un nodo Enviar datos a un webhook a la automatización que se ejecuta cuando la persona ya te dijo algo útil, por ejemplo la automatización de la palabra clave cotizar que responde al toque en "Pedir cotización".
  3. Pega la URL.
  4. Activa la automatización y dispárala desde una segunda cuenta de Instagram.
  5. Revisa en la herramienta receptora la solicitud de prueba y luego asigna los campos que necesites.

Una automatización de captación de contactos: una palabra clave de cotización etiqueta al contacto, un paso de webhook envía el contacto a un CRM, y la persona recibe una confirmación con respuestas rápidas cuyas respuestas activan sus propias automatizaciones.

Proteger el endpoint

La solicitud del webhook no está firmada, así que trata la propia URL como el secreto:

  • Usa una URL larga y aleatoria o incluye un token secreto en la cadena de consulta que tu receptor verifique.
  • Acepta solo los campos que esperas e ignora todo lo demás.
  • Comprueba que flowId coincida con una de tus automatizaciones antes de actuar sobre los datos.
  • Usa HTTPS.

Fiabilidad

Cada nodo hace un intento con un tiempo de espera de 10 segundos. Si el lado receptor está caído en ese momento, ese evento no se entrega de nuevo.

Para la mayoría de las captaciones de contactos eso está bien, porque la conversación sigue en Mensajes de Chat33 y el contacto sigue etiquetado. Para algo crítico, haz que el receptor responda rápido (guardar primero, procesar después) y combina el webhook con un paso Etiquetar para poder encontrar siempre los contactos en Chat33 si se perdió alguno. Nuestra guía de etiquetas tiene un esquema de nombres que funciona bien para esto.

Automatizaciones de contactos que vale la pena construir

  • Solicitudes de cotización: palabra clave cotizar, etiqueta y webhook, y luego una pregunta con respuestas rápidas cuyas opciones activan cada una su propia automatización (y su propio webhook, si la respuesta importa para tu CRM).
  • Consultas de colaboración: palabra clave colaborar, enlace al media kit, webhook a la hoja que lee tu representante. Mira automatización de DM para creadores.
  • Listas de espera: palabra clave de respuesta a historia, una confirmación, una etiqueta y un webhook para que el conteo se actualice en tiempo real.
  • Venta al por mayor: un paso Revisar una condición que mira si el mensaje contiene "mayorista" y envía solo esos contactos a tu embudo B2B.
Integraciones de Chat33

Webhooks, solicitudes HTTP y el resto de las formas en que Chat33 se conecta con las herramientas que ya usas.