Configurar o webhook de SMS (Twilio) para receber mensagens
Conecte seu número Twilio ao Omnifox e aponte o webhook de mensagens para que cada SMS recebido abra uma conversa no Inbox.
O que você vai conseguir
O canal SMS usa a Twilio para enviar e receber mensagens de texto. Para receber, é preciso dizer à Twilio para onde avisar quando chega um SMS: essa é a URL de webhook de entrada do Omnifox. Conectado, cada mensagem abre uma conversa no Inbox.
Requisitos
- Uma conta Twilio com um número habilitado para SMS.
- O Account SID e o Auth Token do seu painel da Twilio.
- O número no formato E.164 (com o prefixo
+, ex.:+15551234567).
Passos
- No Omnifox, vá em Canais e clique em Conectar canal.
- Escolha SMS (Twilio) na lista.
- Cole o seu Account SID e o Auth Token, e informe o Número de telefone em E.164.
- Copie a Webhook URL que o Omnifox mostra:
https://omnifox.io/api/webhooks/sms. - Salve o canal.
- Abra o console da Twilio: Phone Numbers → Manage → Active Numbers → selecione o seu número.
- Na seção Messaging, em "A message comes in", escolha Webhook, cole a URL do passo 4 e deixe o método como HTTP POST.
- Salve as alterações na Twilio.
Como verificar
De outro telefone, envie um SMS para o número da Twilio. Em segundos deve aparecer uma nova conversa no Inbox do Omnifox com o texto da mensagem, e o remetente fica salvo como contato. Responda pelo Inbox para confirmar o envio de volta.
Se não funcionar
- O SMS não chega ao Inbox: verifique se a Webhook URL na Twilio é exatamente
https://omnifox.io/api/webhooks/smse se o método é POST, não GET. - A Twilio reporta erro 11200 / 403: o Omnifox valida a assinatura da Twilio (cabeçalho
X-Twilio-Signature). Confirme que o Auth Token salvo no canal está correto e vigente; se você o girou na Twilio, atualize no canal. - Não roteia: o Omnifox identifica o canal pelo número destinatário (o seu número Twilio). Confirme que o número do canal é o mesmo que recebe o SMS.
Dicas
- Se você usa um Messaging Service da Twilio em vez de um número avulso, configure o webhook de entrada no nível do serviço apontando para a mesma URL.
- Mantenha o Auth Token sincronizado: girá-lo na Twilio sem atualizar o canal quebra a verificação de assinatura e as mensagens param de entrar.
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.