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.

Jun 26, 2026

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 (idealmente 200) en pocos segundos.
  • Ten a mano la URL de destino.

Pasos para crear una suscripción

  1. En el menú lateral abre la sección Webhooks.
  2. Pulsa Nuevo webhook (arriba a la derecha).
  3. 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).
  4. Deja el interruptor Activo encendido.
  5. En Secreto de firma verás un secreto generado automáticamente (whsec_...). Pulsa Copiar y guárdalo: lo usarás para validar la firma X-Omnifox-Signature en tu servidor.
  6. 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.
  7. 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 2xx rá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

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp