Configurar o Email com SendGrid ou Mailgun (por API key)

Como conectar o canal de e-mail usando a chave de API do SendGrid ou do Mailgun, e quando essa opção é melhor que o SMTP.

Jun 25, 2026

O que você vai configurar

O canal de Email do Omnifox permite enviar e receber e-mails como mais uma conversa na Caixa de entrada. Você pode conectá-lo de duas formas: com um provedor por API ou por SMTP tradicional. Este guia cobre a opção por chave de API.

O seletor Provedor oferece exatamente três opções: SMTP, SendGrid e Mailgun.

Chave de API ou SMTP, qual escolher?

  • Chave de API (SendGrid ou Mailgun): você cola uma única chave. Boa entregabilidade e nenhuma porta para abrir. É a opção mais simples para enviar em escala.
  • SMTP: pede servidor, porta, usuário, senha e criptografia. Escolha essa se você já tem uma caixa corporativa ou se o seu provedor não é nenhum dos dois acima.

Provedores por API exigem um domínio remetente verificado. Canais com SMTP próprio autenticado ficam isentos, porque o seu servidor já autentica o remetente.

Requisitos

  • Uma conta no SendGrid ou no Mailgun.
  • Seu domínio verificado nesse provedor, com SPF e DKIM configurados.
  • Uma chave de API gerada no painel do provedor.

Passos

  1. No menu lateral, abra Canais e clique em Conectar novo canal.
  2. Escolha Email como tipo de canal.
  3. Escreva o Nome do canal: é obrigatório antes de continuar.
  4. Na seção Envio (correio de saída), abra o seletor Provedor e escolha SendGrid ou Mailgun.
  5. Cole sua chave no campo API Key.
  6. Preencha Email remetente (o endereço de onde sai o e-mail, por exemplo [email protected]) e Nome do remetente (o nome que o cliente vê, por exemplo Suporte).
  7. Clique em Continuar para salvar o canal.

O endereço do Email remetente precisa pertencer a um domínio verificado no seu provedor. Caso contrário, o SendGrid ou o Mailgun vão recusar o envio.

Receber e-mails

O recebimento é configurado à parte, na seção Recebimento (correio de entrada), e usa credenciais próprias. São dois métodos:

  • Webhook — seu provedor encaminha as mensagens para uma URL do Omnifox. Copie a URL do webhook de entrada que aparece no formulário e cole na seção de entrada do seu provedor: Inbound Parse no SendGrid, Routes no Mailgun.
  • IMAP — o Omnifox se conecta a uma caixa e traz as mensagens.

Verificação

  1. A partir do canal recém-criado, envie um e-mail de teste para um endereço seu.
  2. Responda a esse e-mail da sua caixa pessoal.
  3. A resposta deve aparecer na Caixa de entrada do Omnifox.

Se algo não funcionar

  • Os e-mails não saem: confira se a API Key está correta e tem permissão de envio.
  • Caem no spam ou são recusados: falta verificar o domínio (SPF e DKIM), ou o Email remetente não corresponde ao domínio verificado.
  • Aparece o aviso de domínio remetente verificado: com SendGrid ou Mailgun esse requisito é obrigatório. Verifique o domínio ou use um canal com SMTP próprio.
  • As respostas não chegam: a URL do webhook de entrada não está bem configurada no provedor, ou os registros MX não apontam para o serviço de entrada.

Dicas

  • Use um endereço dedicado como suporte@ ou ola@ em vez do e-mail pessoal de alguém: assim todo o atendimento fica centralizado.
  • Se você prefere não depender de um provedor externo, a opção SMTP funciona com qualquer caixa corporativa.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp