Receber e-mails no Omnifox: webhook e encaminhamento

Conecte seu e-mail como canal e faça as mensagens recebidas chegarem ao Inbox usando o webhook do Omnifox e o encaminhamento do seu provedor.

Jun 25, 2026

O que você vai conseguir

O canal Email transforma cada mensagem recebida em uma conversa dentro do Inbox do Omnifox, igual a uma mensagem de WhatsApp ou webchat. Para isso, seu provedor de e-mail precisa encaminhar as mensagens recebidas para a URL de webhook de entrada que o Omnifox gera para você.

Este guia é para quem já tem um domínio de e-mail e quer receber as respostas dos clientes em um só lugar.

Requisitos

  • Um canal de Email criado no Omnifox (com From Email e From Name preenchidos).
  • Uma conta em um provedor de inbound parse: SendGrid Inbound Parse ou Mailgun Routes (os dois que o Omnifox interpreta de forma nativa).
  • Acesso ao DNS do domínio de recebimento ou às regras de encaminhamento da sua caixa.

Passos

  1. Vá em Canais no menu lateral e clique em Conectar canal.
  2. Escolha Email (SMTP / IMAP) na lista de canais.
  3. Em Provedor deixe SMTP e preencha os dados de saída: SMTP Host, Porta (geralmente 587), Usuário, Senha e Criptografia (TLS). Informe From Email e From Name — esse endereço é o que vai receber as mensagens.
  4. Copie a Inbound Webhook URL mostrada na tela. Ela tem o formato https://omnifox.io/api/webhooks/email.
  5. Salve o canal.
  6. No seu provedor de entrada, aponte as mensagens recebidas para essa URL:
    • SendGrid: Settings → Inbound Parse → Add Host & URL. Informe o subdomínio de recebimento (ex.: inbox.seudominio.com), cole a URL do webhook e adicione o registro MX indicado pelo SendGrid.
    • Mailgun: Receiving → Create Route → ação Forward apontando para a URL do webhook.
  7. Se você só quer encaminhar uma caixa existente (Gmail, Outlook), crie uma regra de encaminhamento automático para o endereço de parse do seu provedor.

Como verificar

Envie um e-mail de teste para o seu endereço de recebimento. Em poucos segundos deve abrir uma nova conversa no Inbox com o assunto e o corpo da mensagem. O remetente fica salvo como contato.

Se não funcionar

  • Nada chega: verifique se o registro MX aponta para o seu provedor e se o endereço de recebimento é exatamente igual ao From Email do canal. O Omnifox roteia o e-mail recebido pelo endereço destinatário.
  • Chega no SendGrid/Mailgun mas não no Omnifox: confira se a URL do webhook está sem erros e se o domínio resolve por HTTPS.
  • Corpo vazio: alguns encaminhamentos enviam só HTML; o Omnifox prefere o texto simples quando existe, então ative "incluir texto simples" no seu provedor.

Dicas

  • Use um subdomínio dedicado (ex.: suporte.seudominio.com) para não mexer no MX do seu e-mail principal.
  • Tem várias caixas? Crie um canal de Email por endereço e deixe cada um rotear pelo próprio destinatário.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp