LiveConnect WhatsApp
ES EN
Hablar con un experto
WhatsApp Guía técnica · Webhooks

Webhooks de WhatsApp Business API

Cómo funcionan los eventos en tiempo real de la API de WhatsApp, qué se puede construir con ellos y cuándo conviene no construirlos desde cero.

WhatsApp Business API Actualizado el
TA
Tienda Aurora
en línea
Hola 👋 ¿Tienen el bolso Aurora en color arena?
10:24
¡Sí! Está disponible 🟢. Precio: $189.000 con envío gratis. ¿Te comparto el link de pago?
10:24 ✓✓
Perfecto, lo quiero 🙌
10:25
Pago seguro · $189.000
pay.tiendaaurora.co
Aquí tienes 👆 Te confirmo apenas se acredite.
10:25 ✓✓
⚡ Respuesta automática · chatbot LiveConnect
Cuenta verificada
API Oficial
Multiagente
Un número, todo el equipo

Un webhook de WhatsApp Business API es una notificación HTTP que Meta envía automáticamente a un endpoint de tu sistema cada vez que ocurre un evento relevante en tu número de WhatsApp: llega un mensaje nuevo, cambia el estado de uno enviado (entregado, leído, fallido) o se actualiza la calidad del número. En vez de que tu sistema tenga que preguntarle constantemente a la API "¿hay algo nuevo?", es la WhatsApp Business Platform la que avisa en el momento en que algo sucede.

Por qué existen los webhooks en la API de WhatsApp

La WhatsApp Business API no funciona como la app de WhatsApp Business que cualquier persona descarga en su celular: es una API sobre la que se construyen sistemas, no una interfaz para humanos. Para que esos sistemas puedan reaccionar a una conversación en tiempo real —asignarla a un agente, dispararle a un chatbot, actualizar un ticket— necesitan enterarse del evento al instante, no revisarlo cada cierto tiempo. Los webhooks resuelven exactamente eso: Meta publica el evento una sola vez, con baja latencia, y tu servidor decide qué hacer con él.

Esto es lo que hace posible que, por ejemplo, un mensaje entrante dispare en segundos un flujo de chatbots con IA, una regla de asignación de conversaciones o una actualización automática en tu CRM, sin que nadie tenga que refrescar una pantalla.

Qué tipos de eventos llegan por webhook

Aunque el detalle exacto puede variar según la versión de la API, los eventos que casi toda integración necesita manejar son:

  • Mensajes entrantes: texto, imagen, audio, documento, ubicación, respuesta a un botón o lista interactiva, o el envío de un WhatsApp Flow.
  • Estados de mensaje saliente: enviado, entregado, leído o fallido — clave para saber si una plantilla o un recordatorio realmente llegó al cliente.
  • Cambios de calidad o estado del número: avisos sobre la calidad del número de WhatsApp Business o restricciones de mensajería.
  • Eventos de plantillas: aprobación, rechazo o pausa de una plantilla de mensaje por parte de Meta.
  • Eventos de cuenta: cambios en la verificación del negocio o en la configuración de la cuenta de WhatsApp Business.

Cada evento llega como un JSON con la información relevante; tu endpoint debe identificar el tipo de evento y decidir qué proceso de negocio disparar.

Cómo funciona en la práctica (a alto nivel)

  1. Configuras una URL propia (HTTPS, con un token de verificación) en el panel del número de WhatsApp Business o del proveedor que te da acceso a la API.
  2. Cuando ocurre un evento, Meta hace una petición POST a esa URL con el payload del evento.
  3. Tu servidor debe responder rápido (en pocos segundos) confirmando la recepción; si no responde a tiempo, Meta reintenta el envío.
  4. Tu sistema procesa el evento de forma asíncrona: lo guarda, lo enruta, actualiza un registro o dispara una automatización.

El punto que casi toda guía técnica repite: el endpoint debe confirmar la recepción casi de inmediato y dejar el procesamiento pesado (lógica de negocio, llamadas a otros sistemas) para después, en segundo plano. Un endpoint lento no solo retrasa tu propia automatización: puede hacer que el mismo evento se reintente varias veces y termine procesado por duplicado si no deduplicas.

Construir tu propio listener vs. usar una plataforma que ya lo resuelve

Listener propio sobre la API Plataforma con webhooks ya resueltos
Quién mantiene el endpoint Tu equipo de desarrollo El proveedor
Reintentos y deduplicación de eventos Hay que implementarlos a mano Ya están resueltos
Escalar ante picos de mensajes Requiere infraestructura propia Absorbido por la plataforma
Disponibilidad 24/7 del endpoint Responsabilidad interna Parte del servicio
Conectar el evento a atención multiagente, CRM y chatbot Hay que construirlo Incluido de fábrica
Riesgo ante cambios de la API de Meta Lo asume tu equipo Lo absorbe el proveedor

Ninguna de las dos opciones es "la correcta" en abstracto: depende de qué tan personalizado necesitas que sea el procesamiento de cada evento y de si tu empresa ya tiene (o quiere tener) un equipo dedicado a mantenerlo.

Cuándo conviene construir tu propio webhook y cuándo no

Construir un listener propio tiene sentido cuando el evento de WhatsApp necesita disparar una lógica muy específica del negocio que ningún proveedor va a resolver genéricamente: por ejemplo, actualizar un sistema interno de inventario con reglas particulares, o alimentar un modelo de datos propietario. En ese caso, trátalo como un componente de producción más: con monitoreo, alertas si el endpoint falla y un responsable claro.

No conviene construirlo desde cero cuando lo que en realidad se necesita es lo de siempre: que un mensaje entrante llegue a un agente disponible, que un chatbot responda preguntas frecuentes, que el estado de un recordatorio se refleje en el historial del cliente. Eso ya lo resuelve una plataforma omnicanal como LiveConnect sin que el webhook sea algo que tu equipo tenga que operar.

Qué se puede automatizar con los webhooks (y cómo lo hace LiveConnect)

En LiveConnect, los webhooks de la WhatsApp Business API ya están conectados a la operación: un mensaje entrante llega a la bandeja compartida, se enruta por reglas de asignación de conversaciones, puede disparar un chatbot con IA antes de pasar a un humano, y los estados de entrega de plantillas y recordatorios quedan reflejos en el historial del contacto. Nada de eso exige que tu empresa programe o mantenga un endpoint propio.

Para quienes sí necesitan que ciertos eventos lleguen también a un sistema externo (su propio CRM, un ERP, un data warehouse), lo recomendable no es espejar cada evento sino sincronizar solo los que disparan un proceso de negocio real — el mismo criterio que aplica al integrar WhatsApp Business API con tu CRM o con un ERP.

Errores comunes al trabajar con webhooks de WhatsApp

  • No responder rápido al webhook: si el endpoint tarda demasiado, Meta reintenta el mismo evento, lo que puede duplicar procesos si no hay deduplicación.
  • Procesar todo de forma síncrona: mezclar la confirmación de recepción con lógica de negocio pesada hace que el endpoint se vuelva el cuello de botella de toda la integración.
  • No validar el origen del evento: un endpoint público sin verificación de firma o token queda expuesto a payloads falsos.
  • Subestimar el mantenimiento: un webhook que funciona hoy puede dejar de hacerlo si cambia la versión de la API o el formato del payload, y sin monitoreo nadie se entera hasta que un cliente reclama.
  • Construir el listener antes de tener claro el proceso de negocio: automatizar un flujo de asignación o escalamiento que todavía no está definido a mano casi siempre obliga a rehacer el desarrollo.

Cómo empezar

Si tu equipo técnico va a construir el listener, define primero qué eventos necesita tu negocio (no todos), quién lo mantiene y cómo se monitorea. Si prefieres que la atención en tiempo real, el enrutamiento y la automatización ya vengan resueltos sin tener que operar un webhook propio, conoce los planes y precios de LiveConnect.

¿Tienes dudas sobre qué eventos necesitas realmente para tu caso? Escríbenos por WhatsApp y lo revisamos juntos.

Preguntas frecuentes

¿Qué es un webhook de WhatsApp Business API, en palabras simples?

Es un aviso automático que Meta envía a tu sistema cada vez que pasa algo en tu número de WhatsApp —llega un mensaje, cambia el estado de uno enviado— para que tu software reaccione en tiempo real sin tener que estar preguntando constantemente a la API.

¿Necesito saber programar para usar WhatsApp Business API con webhooks?

Solo si vas a construir tu propio listener. Si usas una plataforma como LiveConnect, los webhooks ya están conectados a la bandeja de atención, el chatbot y el CRM, sin que tengas que desarrollar ni mantener un endpoint.

¿Qué pasa si mi servidor no responde a tiempo al webhook?

Meta reintenta el envío del mismo evento. Si tu endpoint no deduplica, ese reintento puede procesar la misma información dos veces, por eso conviene que el endpoint confirme la recepción casi de inmediato y procese el resto en segundo plano.

¿LiveConnect permite enviar eventos de WhatsApp hacia mi propio sistema?

Sí, es posible sincronizar hacia un CRM o ERP externo los eventos que disparan un proceso de negocio real (una venta cerrada, un ticket escalado), en vez de espejar toda la conversación mensaje por mensaje.

¿Los webhooks tienen un costo adicional?

El webhook en sí es parte de cómo funciona la API; lo que puede implicar costo es el desarrollo y mantenimiento de un listener propio, o en una plataforma como LiveConnect, está incluido dentro del plan.

¿Cuáles son los eventos más importantes para empezar?

Mensajes entrantes y estados de mensaje saliente (entregado, leído, fallido) cubren la mayoría de los casos de uso iniciales; los eventos de calidad del número y de plantillas se vuelven relevantes a medida que crece el volumen de envío.

Volver al blog
Fundamentos

¿Qué es WhatsApp Business y el API Oficial?

Existen dos formas de usar WhatsApp para tu empresa. Entender la diferencia es clave para elegir la que hará crecer tu operación sin límites.

WhatsApp Business App (QR)

La app gratuita, pensada para negocios pequeños. Se conecta escaneando un código QR desde un teléfono.

Perfiles de negocio y catálogo básico
Un dispositivo, pocos agentes en simultáneo
Sin automatización avanzada ni integraciones
Recomendado para empresas
WhatsApp

API Oficial · WhatsApp Business Platform

La plataforma oficial de Meta para empresas. Diseñada para atender a escala, con verificación, automatización e integraciones — el motor detrás de LiveConnect.

Múltiples agentes sobre un mismo número
Chatbots, IA, campañas y links de pago
Cuenta verificada e integración con tus sistemas
Por qué el API Oficial

Los beneficios que solo el API Oficial te da

Atención multiagente

Todo tu equipo atiende desde un único número, con asignación, transferencias y trazabilidad.

Chatbots e IA 24/7

Automatiza preguntas frecuentes, califica prospectos y responde al instante, a cualquier hora.

Cuenta verificada

Genera confianza con el nombre verificado de tu empresa y el check oficial de WhatsApp.

Campañas y mensajes masivos

Reactiva clientes, envía promociones y recordatorios con plantillas aprobadas y segmentación.

Integraciones y API

Conecta tu CRM, ERP, eCommerce y flujos internos. Webhooks, links de pago y créditos LC.

Métricas y control

Mide tiempos de respuesta, conversión, carga por agente y campañas — decisiones con datos.

Comparativa

QR vs. API Oficial

Ambos usan WhatsApp. La diferencia está en cuánto puede crecer tu operación.

Capacidad
Conexión QR
API Oficial
Agentes en simultáneo
Limitado
Ilimitados por plan
Chatbots e IA
Cuenta verificada oficial
Campañas y mensajes masivos
Con riesgo
Integraciones (CRM, ERP, API)
Estabilidad y cumplimiento
Riesgo de bloqueo
Respaldo oficial
Casos de uso por vertical

Una conversación, cada industria

Cada sector tiene conversaciones repetitivas y ventas que se pierden. LiveConnect las convierte en procesos medibles.

Retail y comercio

Responde precio y stock, muestra catálogo y cierra con link de pago sin salir del chat.

eCommerce

Acompaña al comprador indeciso, recupera carritos y resuelve el postventa por WhatsApp.

Restaurantes y domicilios

Toma pedidos y reservas con bots en horas pico y confirma con pago automático.

Salud y estética

Agenda citas, envía recordatorios y reduce inasistencia con seguimiento ordenado.

Educación

Atiende admisiones y matrículas sin perder aspirantes por falta de respuesta.

Inmobiliario

Califica prospectos, asigna asesores y da seguimiento hasta la visita o el cierre.

Automotor

Une ventas, taller y repuestos en una sola operación conversacional.

Turismo y hotelería

Cotiza, reserva y acompaña la experiencia — responder primero gana la reserva.

Finanzas y seguros

Organiza solicitudes con trazabilidad, tickets y recordatorios de renovación.

También: logística, ferretería, agro, belleza, contact center, gobierno y más. Cuéntanos tu industria
META BUSINESS PARTNER

Por qué activar el API con LiveConnect

Como Meta Business Partner, no solo te damos la plataforma: te acompañamos desde la activación hasta que tu operación funcione.

Activación guiada

Verificación de la cuenta y puesta en marcha del API, sin fricción técnica.

Onboarding real

Configuramos bots, equipos y flujos según tu operación en los primeros días.

Soporte en español

Acompañamiento cercano y en tu idioma, no un ticket que nadie responde.

Plataforma propia

LiveConnect es nuestra plataforma: evolución, integraciones y buenas prácticas incluidas.

Planes y precios

Un plan para cada etapa

Precios en USD / mes. El costo de mensajería del API Oficial de WhatsApp se factura aparte por Meta según el uso.

Con el plan anual ahorras un 20% en tu compra.

Mini

Facturación anual

$36USD/mes

Un solo pago de $432 USDAhorras $108 al año

Empezar mi prueba gratis
  • 3 Chatbots
  • 3 Usuarios
  • 300 Conversaciones
  • 50 Conversaciones atendidas por IA
  • 1 Conexión a WhatsApp
  • 1 Conexión a Facebook
  • 1 Conexión a Instagram
  • 1 Conexión a Telegram (BotFather)
  • 1 LiveChat para Sitios Web
  • 3 GB de Almacenamiento

Básico

Facturación anual

$48USD/mes

Un solo pago de $576 USDAhorras $144 al año

Empezar mi prueba gratis
  • 5 Chatbots
  • 5 Usuarios
  • 600 Conversaciones
  • 100 Conversaciones atendidas por IA
  • 1 Conexión a WhatsApp
  • 1 Canal de Facebook
  • 1 Canal de Instagram
  • 1 Conexión a Telegram (BotFather)
  • 1 LiveChat para Sitios Web
  • 5 GB de Almacenamiento
Más elegido

Estándar

Facturación anual

$71USD/mes

Un solo pago de $852 USDAhorras $216 al año

Empezar mi prueba gratis
  • 20 Chatbots
  • 10 Usuarios
  • 2.000 Conversaciones
  • 250 Conversaciones atendidas por IA
  • 1 Conexión a WhatsApp
  • 1 Conexión a Instagram
  • 2 Canales de Facebook
  • 1 Conexión a Telegram (BotFather)
  • 3 LiveChat para Sitios Web
  • 10 GB de Almacenamiento

Profesional

Facturación anual

$127USD/mes

Un solo pago de $1.524 USDAhorras $384 al año

Empezar mi prueba gratis
  • 50 Chatbots
  • 50 Usuarios
  • 3.000 Conversaciones
  • 500 Conversaciones atendidas por IA
  • 1 Conexión a WhatsApp
  • 1 Conexión a Instagram
  • 3 Canales de Facebook
  • 1 Conexión a Telegram (BotFather)
  • 5 LiveChat para Sitios Web
  • 20 GB de Almacenamiento

Enterprise

Facturación anual

$479USD/mes

Un solo pago de $5.748 USDAhorras $1.440 al año

Empezar mi prueba gratis
  • Chatbots Ilimitados
  • 100 Usuarios
  • 15.000 Conversaciones
  • 1.500 Conversaciones atendidas por IA
  • 6 Conexiones a WhatsApp
  • 3 Conexiones a Instagram
  • 5 Canales de Facebook
  • 2 Conexión a Telegram (BotFather)
  • 5 LiveChat para Sitios Web
  • 25 Créditos LC (IA, CRM, integraciones)
¿No sabes cuál elegir? Hacemos un diagnóstico rápido contigo. Habla con un experto →
Preguntas frecuentes

Resolvemos tus dudas

¿Qué es el API Oficial de WhatsApp Business?

Es la plataforma oficial de Meta (WhatsApp Business Platform) que permite a las empresas atender a escala: múltiples agentes sobre un mismo número, chatbots, IA, campañas, cuenta verificada e integraciones con tus sistemas.

¿Necesito el API o me sirve la conexión por QR?

Si eres un equipo pequeño y bajo volumen, el QR puede bastar. Si necesitas varios agentes, automatización, campañas, verificación o integraciones, el API Oficial es el camino. Te ayudamos a decidir según tu operación.

¿LiveConnect es Meta Business Partner?

Sí. Somos Meta Business Partner, lo que significa que activamos y acompañamos el API Oficial de WhatsApp Business de forma autorizada, con buenas prácticas y soporte cercano.

¿Puedo usar varios agentes con un solo número?

Sí. Con LiveConnect y el API Oficial, todo tu equipo atiende desde una misma línea de WhatsApp, con asignación de conversaciones, transferencias, etiquetas e historial.

¿Los precios incluyen el costo de mensajería de WhatsApp?

Los planes corresponden a la plataforma LiveConnect. El costo de conversaciones del API Oficial lo define Meta según el tipo y volumen de mensajes. En el diagnóstico te explicamos cómo estimarlo.

¿Cuánto tarda la activación?

Depende de la verificación de tu empresa y de tener el número disponible. Nuestro equipo te guía en cada paso para que quede operando lo antes posible.

Empieza hoy

Activa WhatsApp Business API con un partner que te acompaña

Cuéntanos sobre tu operación y te ayudamos a elegir el plan y poner todo en marcha.

Sobre el API Oficial de WhatsApp