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.

Jun 26, 2026

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

  1. Entre no seu Mission Control Portal da Telnyx.
  2. Va em API Keys (menu da conta).
  3. Crie uma API Key nova (ou copie uma existente). Ela comeca com KEY....
  4. Guarde em local seguro: a chave completa so aparece uma vez.

Passo 2: Obter o Connection ID

  1. Na Telnyx abra Voice -> Call Control / Connections.
  2. Abra a sua conexao de voz (ou crie uma do tipo Call Control).
  3. Copie o Connection ID (um numero longo). E ele que roteia as chamadas.

Passo 3: Conectar o canal na Omnifox

  1. Na Omnifox va em Canais e clique em Conectar canal.
  2. Escolha o tipo Telnyx Programmable Voice.
  3. 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.
  4. 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

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp