Conectar o Telnyx (Programmable Voice): credenciais da API e conexao
Conecte sua conta Telnyx a Omnifox para fazer e receber chamadas. Voce so precisa da sua API Key e do Connection ID da sua conexao de voz.
O Telnyx Programmable Voice permite fazer e receber chamadas dentro da Omnifox usando a sua propria conta Telnyx. Para conectar voce precisa apenas de dois dados: a sua API Key e o Connection ID da sua conexao de voz. Este guia e para quem esta comecando.
Requisitos
- Uma conta ativa na Telnyx (Mission Control Portal).
- Pelo menos um numero de telefone comprado na Telnyx.
- Uma Voice Connection do tipo Call Control configurada na Telnyx.
- Permissao para gerenciar canais na Omnifox.
Passo 1: Obter a API Key na Telnyx
- Entre no seu Mission Control Portal da Telnyx.
- Va em API Keys (menu da conta).
- Crie uma API Key nova (ou copie uma existente). Ela comeca com
KEY.... - Guarde em local seguro: a chave completa so aparece uma vez.
Passo 2: Obter o Connection ID
- Na Telnyx abra Voice -> Call Control / Connections.
- Abra a sua conexao de voz (ou crie uma do tipo Call Control).
- Copie o Connection ID (um numero longo). E ele que roteia as chamadas.
Passo 3: Conectar o canal na Omnifox
- Na Omnifox va em Canais e clique em Conectar canal.
- Escolha o tipo Telnyx Programmable Voice.
- Preencha o formulario:
- API Key: a chave do Passo 1 (de Mission Control -> API Keys).
- Connection ID: o ID do Passo 2.
- Default From Number (E.164): opcional aqui; tratamos em artigo proprio.
- Salve para criar o canal.
Passo 4: Apontar o webhook da Telnyx para a Omnifox
Para que a Telnyx avise a Omnifox sobre as chamadas recebidas, copie a URL de webhook que a Omnifox mostra ao criar o canal e cole na sua conexao Telnyx, em Connection -> Webhooks. Salve as alteracoes na Telnyx.
Como verificar
- Em Canais, o novo canal Telnyx deve aparecer como ativo.
- Faca uma chamada recebida real para o seu numero Telnyx: ela deve cair na Omnifox. Um teste de verdade pega problemas que o salvamento nao mostra.
- Se fizer uma chamada de saida de teste, confirme que sai com o seu numero.
Se nao funciona
- O canal nao recebe chamadas: confira a URL de webhook em Connection -> Webhooks e se a conexao e do tipo Call Control.
- Erro de autenticacao: a API Key foi copiada errada ou revogada na Telnyx. Gere uma nova e cole de novo.
- Connection ID invalido: confirme que copiou o ID da conexao, nao o do numero nem o do perfil de mensagens.
Dicas
- Use uma API Key dedicada para a Omnifox; assim voce pode revoga-la sem afetar outras integracoes.
- O proximo passo recomendado e definir o numero padrao e, para mais seguranca, verificar as assinaturas dos webhooks.
Artigos relacionados
Artigos relacionados
-
Códigos de erro do WhatsApp (Meta): o que significam e o que fazer
Tabela com os códigos de erro da Meta mais comuns ao enviar pelo WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) e como resolver cada um.
-
Como conectar o Telegram
Conecte um bot do Telegram à sua caixa de entrada do Omnifox em minutos usando o BotFather.
-
Comentários do Instagram e do Facebook: responder e moderar pelo Omnifox
Veja e responda os comentários das suas publicações e anúncios do Facebook e do Instagram, em público ou no privado, e configure respostas automáticas.
-
Enviar e receber vídeos em cada canal: formatos e tamanhos máximos
Quais vídeos você pode enviar e receber pelo WhatsApp, Instagram, Messenger, Telegram, chat do site e e-mail, com os tamanhos máximos reais e o que fazer com um vídeo pesado.
-
Conectar o WhatsApp escaneando um código QR
Vincule seu WhatsApp ao Omnifox em um minuto, como no WhatsApp Web. Ideal para testar: tem limites, não permite campanhas e não é a API oficial.