Conectar Telnyx (Programmable Voice): credenciales API y conexion

Conecta tu cuenta de Telnyx a Omnifox para recibir y hacer llamadas. Solo necesitas tu API Key y el Connection ID de tu conexion de voz.

Jun 26, 2026

Telnyx Programmable Voice te permite recibir y realizar llamadas dentro de Omnifox usando tu propia cuenta de Telnyx. Para conectarlo solo necesitas dos datos: tu API Key y el Connection ID de tu conexion de voz. Esta guia es para usuarios que recien empiezan.

Requisitos

  • Una cuenta activa en Telnyx (Mission Control Portal).
  • Al menos un numero de telefono comprado en Telnyx.
  • Una Voice Connection de tipo Call Control configurada en Telnyx.
  • En Omnifox, permiso para gestionar canales.

Paso 1: Obtener la API Key en Telnyx

  1. Entra a tu Mission Control Portal de Telnyx.
  2. Ve a API Keys (menu de la cuenta).
  3. Crea una API Key nueva (o copia una existente). Empieza por KEY....
  4. Guárdala en un lugar seguro: solo se muestra completa una vez.

Paso 2: Obtener el Connection ID

  1. En Telnyx abre Voice -> Call Control / Connections.
  2. Abre tu conexion de voz (o crea una de tipo Call Control).
  3. Copia el Connection ID (un numero largo). Ese es el identificador que enruta las llamadas.

Paso 3: Conectar el canal en Omnifox

  1. En Omnifox ve a Canales y pulsa Conectar canal.
  2. Elige el tipo Telnyx Programmable Voice.
  3. Completa el formulario:
    • API Key: la clave del Paso 1 (de Mission Control -> API Keys).
    • Connection ID: el ID del Paso 2.
    • Default From Number (E.164): opcional aqui, lo cubrimos en su propio articulo.
  4. Pulsa para guardar y crear el canal.

Paso 4: Apuntar el webhook de Telnyx a Omnifox

Para que Telnyx avise a Omnifox de las llamadas entrantes, copia la URL de webhook que Omnifox muestra al crear el canal y pégala en tu conexion de Telnyx, en Connection -> Webhooks. Guarda los cambios en Telnyx.

Como verificar

  • En Canales, el nuevo canal de Telnyx debe aparecer como activo.
  • Haz una llamada entrante real a tu numero de Telnyx: deberia entrar a Omnifox. Una prueba de verdad detecta problemas que el guardado no muestra.
  • Si configuras una llamada saliente de prueba, confirma que sale con tu numero.

Si no funciona

  • El canal no recibe llamadas: revisa que la URL de webhook este correcta en Connection -> Webhooks y que la conexion sea de tipo Call Control.
  • Error de autenticacion: la API Key esta mal copiada o fue revocada en Telnyx. Genera una nueva y vuelve a pegarla.
  • Connection ID invalido: confirma que copiaste el ID de la conexion, no el del numero ni el del perfil de mensajeria.

Tips

  • Usa una API Key dedicada para Omnifox; asi puedes revocarla sin afectar otras integraciones.
  • El siguiente paso recomendado es fijar el numero por defecto y, si quieres mayor seguridad, verificar las firmas de los webhooks.

Articulos relacionados

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp