Configurar numero padrao (E.164) e verificacao de assinaturas do Telnyx

Defina o numero de saida padrao no formato E.164 e, opcionalmente, adicione a chave publica Ed25519 para a Omnifox verificar a assinatura dos webhooks da Telnyx.

Jun 26, 2026

Depois de conectar o canal Telnyx Programmable Voice, vale a pena ajustar duas configuracoes: o numero padrao de onde saem as chamadas e, opcionalmente, a verificacao de assinaturas dos webhooks. Este guia e de nivel intermediario.

O formato E.164

A Telnyx (e a telefonia em geral) usa o formato E.164: o sinal +, o codigo do pais e o numero, sem espacos nem hifens. Exemplos:

  • Estados Unidos: +15125551234
  • Brasil: +5511XXXXXXXXX
  • Portugal: +351XXXXXXXXX

Se o numero nao estiver em E.164, as chamadas de saida podem falhar ou sair com um identificador incorreto.

Passo 1: Definir o numero padrao

  1. Na Omnifox va em Canais e abra o seu canal Telnyx Programmable Voice (ou conecte-o em Conectar canal se ainda nao existir).
  2. No campo Default From Number (E.164) digite o seu numero Telnyx no formato E.164, por exemplo +15125551234.
  3. Salve. A partir dai, as chamadas de saida sem um numero explicito usarao este como remetente.

Esse numero precisa ser um que voce realmente possua na Telnyx e que esteja associado a conexao do canal.

Passo 2 (opcional): Verificacao de assinaturas Ed25519

A Telnyx assina cada webhook com Ed25519 e envia a assinatura no cabecalho telnyx-signature-ed25519. Se voce fornecer a chave publica a Omnifox, nos verificamos essa assinatura e rejeitamos qualquer webhook que nao venha de fato da Telnyx. E uma camada extra de seguranca, recomendada para producao.

  1. Na Telnyx, va a sua conexao: Connection -> Webhook -> Signing Key e copie a chave publica (formato base64).
  2. Na Omnifox, no canal Telnyx, cole esse valor no campo Public Key (Ed25519, base64).
  3. Salve.

Se voce deixar esse campo vazio, a Omnifox aceitara os webhooks sem verificar a assinatura (continua funcionando, mas sem essa protecao).

Como verificar

  • Numero padrao: faca uma chamada de saida de teste e confirme que o identificador que o destinatario ve e o seu numero E.164.
  • Assinaturas: com a chave publica configurada, faca uma chamada recebida real. Se ela entra normalmente, a assinatura esta sendo validada. Se as chamadas pararem de entrar logo apos colar a chave, a chave publica nao confere.

Se nao funciona

  • As chamadas de saida saem com numero errado ou falham: confira se o numero esta em E.164 (com + e codigo do pais) e se pertence a sua conexao na Telnyx.
  • As chamadas pararam de entrar apos configurar a assinatura: voce copiou a chave errada ou de outra conexao. Volte a Telnyx, copie a chave publica correta em Connection -> Webhook -> Signing Key, ou esvazie o campo para aceitar sem verificacao enquanto resolve.

Dicas

  • Comece sem chave publica para confirmar que as chamadas entram, e depois adicione a verificacao de assinaturas; assim voce isola qualquer problema.
  • Guarde sempre o numero padrao em E.164 em toda a plataforma para evitar inconsistencias.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp