Telnyx é uma plataforma de comunicações em nuvem que permite que você envie e receba mensagens SMS através de sua rede de nível de operadora. Com respond.io, você pode gerenciar tanto Telnyx SMS quanto Telnyx Calls em um só lugar.
Antes de começar
Você precisará:
Uma conta Telnyx ativa
Um número de telefone Telnyx com capacidade de SMS
Como configurar o Telnyx SMS
Faça login na sua conta Telnyx.
Compre ou use um número de telefone Telnyx existente que suporte SMS.
No Portal Telnyx, vá para Comunicações em Tempo Real > Números > Comprar Números.
Filtre por números com capacidade de SMS.
Complete a compra.
Como conectar o Telnyx SMS ao respond.io
No respond.io, vá para Configurações do Espaço de trabalho > Adicionar Canal.
Localize o Canal Telnyx SMS e clique em Conectar.
Selecione o número de telefone Telnyx que você deseja usar.
Clique em Salvar Alterações para concluir a configuração.
Uma vez conectado, qualquer SMS enviado para o seu número Telnyx aparece no seu Espaço de trabalho.
Como configurar o Canal SMS do Telnyx
O Canal SMS do Telnyx usa um nome de canal para referência interna.
Vá para Configurações do Espaço de trabalho > Canais.
Localize o Canal Telnyx SMS e clique em Gerenciar > Conta.
Digite o nome do Canal de sua preferência.
Salvar alterações.
Notas e limitações
Limites de tamanho de arquivo: Imagens, áudio e vídeo de até 1MB cada.
Status da mensagem: Os status Enviado, Entregue e Falha são suportados; o status Lido não está disponível.
Mascaramento de número de telefone não está disponível para Telnyx SMS.
Limite de caracteres da mensagem: respond.io detecta a codificação da sua mensagem e aplica o limite real de caracteres da Telnyx antes do envio — 1,530 caracteres para conteúdo GSM-7, 670 caracteres para conteúdo UTF-16 (por exemplo, árabe, emoji). Mensagens dentro do limite são enviadas como uma única mensagem; as que o excedem são divididas em menos segmentos, corretamente ordenados.
Elegibilidade para transmissões
As transmissões de Telnyx SMS só podem ser enviadas a Contatos que tenham enviado ou recebido uma mensagem pelo Canal Telnyx SMS.
Como as transmissões são limitadas a Contatos com interação prévia via Telnyx SMS, você pode notar o seguinte:
Segmentos: Podem incluir Contatos que nunca enviaram mensagens para você via Telnyx SMS, mas esses Contatos não receberão transmissões.
Relatórios: As métricas de envio e de entrega podem ser inferiores ao número total de Contatos no Segmento selecionado.
Filtragem de Contatos: A filtragem pelo Canal Telnyx SMS mostra apenas Contatos com histórico de interação prévia no Telnyx SMS.
Nota: Os Contatos ativados por chamadas Telnyx podem não ser incluídos nas transmissões SMS, já que apenas Contatos com interação prévia por mensagens são elegíveis.
FAQ e solução de problemas
Por que minha mensagem é dividida em várias mensagens de texto?
respond.io detecta a codificação da sua mensagem e aplica o limite real de caracteres da Telnyx antes do envio:
GSM-7 (texto padrão): até 1,530 caracteres
UTF-16 (por exemplo, árabe, emoji): até 670 caracteres
Mensagens dentro do limite são enviadas como um único texto, em ordem.
Mensagens que excedem o limite ainda são divididas em segmentos. A ordem dos segmentos não é garantida pela operadora, portanto mensagens muito longas ainda podem chegar fora de ordem — porém com muito menos frequência do que antes.
Por que as mensagens aparecem como "Sent" mas o Contato nunca as recebe?
Isso pode acontecer quando o perfil de mensagens do número Telnyx não está atribuído.
O número não está roteado para SMS de entrada/saída, e a Telnyx não enviará um webhook de falha de entrega, então o respond.io mostra "Sent" sem atualização de status posterior.
O que você pode fazer
Faça login no portal Telnyx e confirme que um perfil de mensagens está atribuído ao número de telefone afetado.
Se você também vir um erro "403 - Account inactive", sua conta pode estar sem fundos — confirme com o suporte da Telnyx.
Por que não consigo selecionar meu número Telnyx durante a configuração?
A plataforma não oferece suporte à conexão de números Hosted SMS da Telnyx. Ela só detecta números comprados diretamente através da Telnyx, portanto números Hosted SMS — números que mantêm o serviço de voz com a operadora original e encaminham apenas SMS pela Telnyx — nunca aparecem na lista de seleção de números, mesmo quando estão ativos, com capacidade para SMS e atribuídos a um perfil de mensagens na Telnyx.
O que você pode fazer
Compre um novo número compatível com SMS diretamente pela Telnyx.
Transfira totalmente o número existente para a Telnyx em vez de mantê-lo hospedado.
Vote na solicitação de suporte Hosted SMS para apoiar essa funcionalidade.
