Blog
BlogShopifyGuías

Qué es un webhook, explicado con un ejemplo de tienda

Un webhook es un aviso automático: cuando pasa algo en una app, le entrega los datos a otra. Te lo explicamos con una tienda que envía cada lead a su CRM.

Team DivoChat6 min de lectura

Si alguna vez conectaste dos herramientas, seguro te pidieron «la URL del webhook». Suena técnico, pero la idea es sencilla y la usas sin saberlo cada vez que una app te avisa de algo. En esta guía te explicamos qué es un webhook, en qué se diferencia de una API y cómo lo usa una tienda para que cada lead llegue solo a su CRM.

Qué es un webhook

Un webhook es un aviso automático que una aplicación le envía a otra cuando pasa algo. La aplicación que avisa no espera a que le pregunten: en cuanto ocurre el evento, «toca la puerta» de la otra y le entrega los datos.

Piénsalo como el timbre de tu casa. No sales a la puerta cada cinco minutos a ver si llegó alguien: el visitante toca y tú abres. Un webhook funciona igual:

  • El evento: lo que dispara el aviso. Por ejemplo, «llegó un lead nuevo».
  • La dirección: una URL que te da la aplicación que va a recibir el aviso. Es la «puerta» donde se toca.
  • Los datos: lo que viaja en el aviso, casi siempre en formato JSON (texto ordenado en campos y valores).

Tú solo copias esa URL de una herramienta y la pegas en la otra. Desde ese momento, cada vez que pase el evento, los datos viajan solos.

Webhook o API: cuál es la diferencia

Las dos sirven para que dos aplicaciones se hablen, pero lo hacen al revés. Con una API, la aplicación que necesita los datos tiene que preguntar: «¿hay leads nuevos?». Si pregunta cada hora, se entera con hasta una hora de atraso; si pregunta cada minuto, gasta muchas consultas para nada. Con un webhook, la aplicación que tiene los datos avisa en cuanto pasa algo.

API (se consulta)Webhook (avisa)
Quién empiezaEl que necesita los datos preguntaEl que tiene los datos avisa
Cuándo llegan los datosCuando alguien preguntaEn el momento del evento
Ejemplo cotidianoRevisar el buzón cada ratoQue el cartero toque el timbre
Para qué sirve mejorBuscar o cambiar datos cuando tú quieresEnterarte de algo apenas pasa

No compiten: muchas herramientas usan las dos. El webhook avisa de que llegó un lead y, si hace falta, una API sirve después para buscar o actualizar más datos.

El ejemplo: una tienda que avisa a su CRM

Imagina una tienda Shopify que vende radios. Laura ve un anuncio en Instagram, entra, arma una cotización con tres radios y la envía por WhatsApp con el formulario de la tienda. El vendedor la atiende, pero el CRM donde el equipo sigue a cada cliente no sabe nada de ella hasta que alguien copia sus datos a mano. Y cuando lo hace, casi nunca anota de qué anuncio vino.

Con un webhook, eso pasa solo. Desde la versión 1.2, DivoChat para Shopify tiene una pestaña llamada Integraciones: pegas la URL que te da tu CRM o tu herramienta de automatización y, cada vez que llega un lead, DivoChat le avisa con todos sus datos.

Qué avisos envía

  • Llega un lead nuevo: cuando el cliente llena el formulario, envía una cotización o inicia un pago con «Pagar ya».
  • Cambias el estado de un lead: cuando lo marcas como contactado, ganado o perdido en el panel. El aviso trae el estado nuevo y el anterior.

Qué datos viajan

Cada aviso es un JSON plano, fácil de leer y de relacionar en cualquier herramienta. Así se ve uno, recortado y con datos inventados:

{
  "event": "lead.created",
  "lead_type": "quote",
  "name": "Laura Gómez",
  "phone": "+573001234567",
  "email": "laura@ejemplo.com",
  "value": 658700,
  "currency": "COP",
  "items_text": "• 3 × Radio R7 (UHF)",
  "utm_source": "meta",
  "utm_medium": "cpc",
  "utm_campaign": "b2b",
  "first_utm_source": "google",
  "device": "mobile"
}
  • Los datos que dejó el cliente: nombre, WhatsApp, correo, empresa, ciudad y nota.
  • Los productos con cantidades y precios, y el valor total.
  • La campaña que lo trajo: el último contacto (utm_*), el primero (first_utm_*), los IDs de clic de Google, Meta, TikTok y Microsoft, la página de entrada y el dispositivo.

Ese último punto es el que más vale. El CRM no solo sabe que Laura existe: sabe que llegó por la campaña «b2b» de Meta y que la primera vez te encontró en Google. DivoChat recuerda el último anuncio 30 días y el primer contacto 90, así que el origen no se pierde aunque el cliente vuelva otro día. Lo explicamos en por qué tus clientes aparecen como «Directo».

A dónde puede llegar

Funciona con GoHighLevel, Zapier, Make, n8n y cualquier herramienta que reciba webhooks. GoHighLevel lo recibe directo con su disparador Inbound Webhook (tienes el paso a paso en cómo enviar los leads de Shopify a GoHighLevel). Desde Zapier, Make o n8n, el lead puede seguir a Kommo, Pipedrive, Google Sheets o donde trabaje tu equipo.

Qué pasa si el aviso no llega

A veces la puerta no abre: el CRM está caído o la URL quedó mal copiada. Un buen webhook no se rinde al primer intento. En DivoChat:

  • La herramienta que recibe debe responder que llegó bien (un código 2xx) en 8 segundos o menos.
  • Si no responde, DivoChat reintenta solo al minuto, a los 10 minutos y a la hora.
  • Después de 4 intentos, el envío queda como Fallido en «Últimos envíos» y lo puedes reintentar con un botón.
  • Con «Enviar lead de prueba» compruebas la conexión sin esperar a un cliente real.

Cómo sabe tu CRM que el aviso es real

Cualquiera que conozca una URL podría intentar enviarle datos falsos. Por eso los webhooks serios van firmados: el que avisa y el que recibe comparten un secreto, y cada envío lleva una firma calculada con ese secreto. Si la firma no coincide, el aviso no viene de quien dice.

  • Cada envío de DivoChat va firmado (HMAC-SHA256) y lleva el secreto en una cabecera, para las herramientas que no pueden verificar firmas.
  • Solo se envía a direcciones públicas y seguras (https).
  • El registro de envíos se borra a los 30 días.

Si no programas, no tienes que hacer nada de esto: GoHighLevel, Zapier, Make y n8n reciben el aviso igual. Si tu equipo arma su propio receptor, la verificación está en la documentación.

Preguntas frecuentes

  • ¿Necesito saber programar para usar un webhook? No. Copias una URL, la pegas y relacionas los campos en tu CRM o en Zapier o Make.
  • ¿Llegan los leads que ya tenía? No. Desde que lo activas, cada lead nuevo llega solo. Los anteriores se exportan a CSV desde «Leads y cotizaciones».
  • ¿Si cambio el estado en mi CRM, cambia en DivoChat? No. El aviso va de DivoChat a tu CRM.
  • ¿Cuánto cuesta? Integraciones va incluida en el plan de 10 USD al mes de DivoChat para Shopify, con 7 días de prueba. Tu CRM y las herramientas de automatización tienen sus propios precios.

Si quieres que cada lead de tu tienda llegue solo a tu CRM con la campaña que lo trajo, sigue la guía de Integraciones. Y si usas otro CRM o quieres ver qué conexiones tiene DivoChat, mira los complementos.

Cada clic a WhatsApp, un lead con origen

DivoChat pide los datos antes de abrir el chat y le cuenta a Meta, Google y tu CRM de dónde llegó cada cliente.