Webhooks salientes: qué son, crear suscripción y seleccionar eventos
Aprende qué es un webhook saliente en Omnifox y crea tu primera suscripción para recibir eventos en tu sistema en tiempo real.
Mira este paso en el video · Webhooks: crear una suscripción
¿Qué es un webhook saliente?
Un webhook saliente es una notificación automática que Omnifox envía a una URL tuya (un endpoint) cada vez que ocurre un evento: llega un mensaje, se crea un contacto, se cierra una conversación, termina una difusión, etc. En lugar de que tu sistema pregunte "¿pasó algo?" cada cierto tiempo, Omnifox te avisa en el momento con una petición HTTP POST que contiene los datos del evento en formato JSON.
Sirve para integrar Omnifox con tu CRM, tu ERP, una hoja de cálculo, una función serverless o cualquier servicio que pueda recibir una petición web.
Antes de empezar
- Necesitas el permiso Gestionar webhooks (
webhooks.manage) en tu workspace. - Debes tener un endpoint público accesible por HTTPS que responda con un código
2xx(idealmente200) en pocos segundos. - Ten a mano la URL de destino.
Pasos para crear una suscripción
- En el menú lateral abre la sección Webhooks.
- Pulsa Nuevo webhook (arriba a la derecha).
- En Configuración, rellena:
- Nombre: una etiqueta clara, p. ej. Sincronizar CRM.
- URL de destino: la dirección HTTPS donde recibirás los eventos.
- Número de reintentos y Tiempo de espera (segundos): puedes dejar los valores por defecto (3 y 30).
- Deja el interruptor Activo encendido.
- En Secreto de firma verás un secreto generado automáticamente (
whsec_...). Pulsa Copiar y guárdalo: lo usarás para validar la firmaX-Omnifox-Signatureen tu servidor. - En Eventos a suscribir, marca las casillas que te interesen, por ejemplo Mensaje recibido (
message.received) o Conversación creada (conversation.created). Debes seleccionar al menos uno. - Pulsa Crear webhook.
Eventos disponibles
Entre los eventos que puedes suscribir están: Mensaje recibido, Mensaje enviado, Conversación creada, Conversación cerrada, Contacto creado, Contacto actualizado, Difusión completada y Salud del canal cambió. Marca solo los que tu integración realmente necesita para no recibir tráfico de más.
Verificación
Tras crear el webhook, vuelve a la lista de Webhooks: tu nuevo registro aparece con el interruptor Activo en verde. Provoca uno de los eventos suscritos (por ejemplo, envíate un mensaje de prueba) y abre el detalle del webhook para ver la entrega en el Historial de entregas con estado Entregado y código 200.
Si no funciona
- No llega nada: confirma que el interruptor Activo está encendido y que marcaste el evento correcto.
- Tu servidor recibe pero rechaza: asegúrate de responder con un
2xxrápido; si tardas más que el Tiempo de espera, cuenta como fallo. - Errores de certificado: la URL debe ser HTTPS con un certificado válido.
Tip: empieza suscribiendo un solo evento y un endpoint de prueba (por ejemplo, un servicio tipo webhook.site) para ver el payload real antes de conectarlo a tu sistema en producción.
Artículos relacionados
Artículos relacionados
-
Cómo conectar integraciones y apps externas
Conecta Omnifox con tus herramientas favoritas desde el catálogo de integraciones en pocos pasos.
-
Guía completa de integraciones y API
Integraciones y API a fondo, en 30 capítulos: claves API, llamadas reales, webhooks firmados, n8n, MCP y SDK, todo funcionando de verdad.
-
Integrar Omnifox con Azur, Siigo, Alegra, QuickBooks u otro sistema contable o ERP
Omnifox no tiene hoy un conector nativo con sistemas contables o ERP. Te explicamos cómo conectarlos igual con workflows, el nodo HTTP, n8n, Make, Zapier o la API, con ejemplos.
-
Generar y usar API keys y webhooks
Crea claves de API para acceder a Omnifox por código y configura webhooks para recibir eventos en tiempo real.
-
Introducción a las integraciones (webhook / OAuth / API key)
Conecta Omnifox con tus otras herramientas: qué está disponible hoy, qué llega pronto y cuándo usar un webhook, una conexión OAuth o una clave de API.