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.

Jun 25, 2026

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

  1. No Omnifox, vá em Canais e clique em Conectar canal.
  2. Escolha SMS (Twilio) na lista.
  3. Cole o seu Account SID e o Auth Token, e informe o Número de telefone em E.164.
  4. Copie a Webhook URL que o Omnifox mostra: https://omnifox.io/api/webhooks/sms.
  5. Salve o canal.
  6. Abra o console da Twilio: Phone Numbers → Manage → Active Numbers → selecione o seu número.
  7. 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.
  8. 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/sms e 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

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp