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.
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
- Na Omnifox va em Canais e abra o seu canal Telnyx Programmable Voice (ou conecte-o em Conectar canal se ainda nao existir).
- No campo Default From Number (E.164) digite o seu numero Telnyx no formato E.164, por exemplo
+15125551234. - 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.
- Na Telnyx, va a sua conexao: Connection -> Webhook -> Signing Key e copie a chave publica (formato base64).
- Na Omnifox, no canal Telnyx, cole esse valor no campo Public Key (Ed25519, base64).
- 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
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.