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.
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
- Entra a tu Mission Control Portal de Telnyx.
- Ve a API Keys (menu de la cuenta).
- Crea una API Key nueva (o copia una existente). Empieza por
KEY.... - Guárdala en un lugar seguro: solo se muestra completa una vez.
Paso 2: Obtener el Connection ID
- En Telnyx abre Voice -> Call Control / Connections.
- Abre tu conexion de voz (o crea una de tipo Call Control).
- Copia el Connection ID (un numero largo). Ese es el identificador que enruta las llamadas.
Paso 3: Conectar el canal en Omnifox
- En Omnifox ve a Canales y pulsa Conectar canal.
- Elige el tipo Telnyx Programmable Voice.
- 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.
- 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
Artículos relacionados
-
Cómo conectar Telegram
Conecta un bot de Telegram a tu bandeja de Omnifox en pocos minutos usando BotFather.
-
Guía completa del Webchat (chat para tu sitio web)
El Webchat a fondo, en 32 capítulos: instalarlo, apariencia, idiomas, formulario, departamentos, horario, disparadores, IA, la bandeja, identificación segura y API de JavaScript, con un sitio real de punta a punta.
-
Códigos de error de WhatsApp (Meta): qué significan y qué hacer
Tabla con los códigos de error de Meta más comunes al enviar por WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) y cómo resolver cada uno.
-
Pasar de WhatsApp por QR a Coexistence o Cloud API
Cuando termines de probar con el código QR, pasa tu número a la conexión oficial: sin topes, con plantillas, difusiones y sin riesgo de bloqueo por volumen.
-
Comentarios de Instagram y Facebook: responder y moderar desde Omnifox
Ve y responde los comentarios de tus publicaciones y anuncios de Facebook e Instagram, en público o en privado, y configura respuestas automáticas.