Registrar el webhook de Telnyx y troubleshooting de llamadas

Cómo registrar la Webhook URL de tu canal Telnyx en Mission Control y diagnosticar por qué una llamada no aparece en la Bandeja de entrada.

Jun 26, 2026

¿Qué es esto y cuándo te sirve

El canal Telnyx (Voz programable) conecta tu número de Telnyx con Omnifox para hacer y recibir llamadas dentro de la Bandeja de entrada. Para que cada evento de la llamada (entrante, contestada, colgada, grabación) aparezca en la conversación, Telnyx tiene que avisarle a Omnifox por un webhook. Si el webhook no está bien registrado, las llamadas se realizan pero no se ven en el inbox, o ni siquiera entran.

Este artículo es para un nivel intermedio: ya conectaste el canal y necesitas registrar el webhook en Telnyx y diagnosticar por qué una llamada no llega.

Requisitos

  • Un canal Telnyx ya creado en Canales → Conectar canal → Telnyx.
  • Acceso al portal Telnyx Mission Control.
  • A mano: tu API Key, el Connection ID y, opcional pero recomendado, la Signing Key (clave pública Ed25519) de la Connection.

Pasos para registrar el webhook

  1. En Omnifox abre Canales, entra a tu canal Telnyx y copia el campo Webhook URL (de solo lectura). Tiene el formato https://omnifox.io/api/webhooks/telnyx.
  2. En Telnyx ve a Voice API → Connections y abre la Connection que usas para este número. Su id es el Connection ID que pegaste en Omnifox.
  3. En la pestaña Webhook de la Connection, pega la Webhook URL de Omnifox en Webhook URL y elige HTTP POST.
  4. Copia la Signing Key que Telnyx muestra en esa misma sección y pégala en Omnifox, en el campo Public Key del canal. Con esto Omnifox verifica la firma Ed25519 de cada evento. Si lo dejas vacío, Omnifox acepta los eventos sin verificar firma (menos seguro).
  5. Confirma que el Connection ID y la API Key del canal en Omnifox coinciden con los del portal y guarda.

Verificación

  • Haz una llamada de prueba real al número. En la conversación del contacto deberías ver, en orden, los eventos: Llamada entrante, Llamada contestada y Llamada finalizada con la duración.
  • Cuando exista grabación, aparece la línea Grabación disponible con el enlace al MP3.
  • Omnifox enruta cada evento buscando el Connection ID del payload; por eso el id del canal debe ser exactamente el de la Connection que dispara la llamada.

Si no funciona

  • No aparece ningún evento: la Webhook URL no está pegada en la Connection correcta, o la Connection que recibe la llamada no es la del Connection ID configurado en Omnifox.
  • Llega un 403 / firma inválida: la Signing Key pegada en Public Key no corresponde a esa Connection. Cópiala de nuevo desde Connection → Webhook → Signing Key, o vacía el campo temporalmente para confirmar que el resto del flujo funciona.
  • "no channel route": el connection_id del evento no coincide con ningún canal. Revisa que el Connection ID en Omnifox esté escrito sin espacios.
  • Las llamadas salientes fallan: suele faltar el número origen (Default From). Configúralo en el canal o pásalo desde la pantalla de llamada.

Tips

  • Mantén siempre la Signing Key configurada en producción: es la única forma de garantizar que los eventos vienen realmente de Telnyx.
  • Si rotas la API Key en Telnyx, actualízala también en Omnifox (ver el artículo de editar credenciales) o las llamadas salientes dejarán de crearse.

Artículos relacionados

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp