Central de Ajuda MailGrid

Como podemos ajudar?

Tutoriais e respostas sobre configuração de SMTP, autenticação de domínio, painel de relatórios, ferramentas, API, webhooks, entregabilidade, planos e tudo sobre o seu envio de emails transacionais.

11 categorias · carregando respostas…

Esta central de ajuda resolveu a sua dúvida?

Se você não encontrou o que precisava — ou mesmo assim quer falar com a nossa equipe — é só abrir um chamado. Respondemos todos os dias.

Abrir chamado de suporte

Primeiros Passos

Entenda o que é a MailGrid, como funciona o período de teste e o que você precisa para começar a enviar.

O que é a MailGrid?

A MailGrid é um serviço de SMTP dedicado para emails transacionais, da Hedder Tecnologia — no mercado há mais de 15 anos. Ao contratar, você recebe dados de autenticação SMTP (servidor, porta, usuário e senha) para configurar na sua aplicação, sistema ou script de envios.

A MailGrid não é uma plataforma de email marketing — não há editor de templates nem gerenciamento de listas. O serviço fornece a infraestrutura de envio; você integra ao seu próprio sistema, via SMTP, RELAY ou API.

Precisa enviar email marketing ou campanhas? A MailGrid não autoriza esse uso em nenhum plano. Para isso, conheça o xMailer, outro serviço da Hedder Tecnologia.
O que são emails transacionais e para que serve o SMTP?

Emails transacionais são aqueles em que a entrega do conteúdo é essencial para o destinatário. Diferente do email marketing, a maior parte do conteúdo é dedicada a entregar a informação que o próprio destinatário espera. Exemplos comuns:

  • Confirmação de cadastro, compra ou transação
  • Boletos e notas fiscais (NFe)
  • Notificações automáticas de sistemas e aplicações
  • Avisos para alunos, clientes ou colaboradores
  • Newsletters e comunicados para a sua base, desde que com opt-in (autorização prévia)

Não autorizamos o envio de email marketing/propaganda em nenhum plano — isso preserva a reputação dos nossos IPs e garante melhor entregabilidade para os envios transacionais de todos os clientes.

Como funciona o período de teste grátis?

Você não precisa pagar antes de a sua conta ser ativada. A MailGrid oferece 5 dias grátis, contados a partir do cadastro, para você testar o serviço.

Sua conta é ativada após a validação do cadastro pelo time de contas. Ao final do período de testes, você recebe as instruções para efetivar a contratação, com o pagamento referente aos 30 dias seguintes.

Fiz o cadastro. Quais são os próximos passos?

Depois do cadastro, o caminho até o primeiro envio é este:

  1. Aguarde a validação do cadastro. Nossa equipe confere seus dados — normalmente em até 1 hora, dentro do horário comercial.
  2. Configure os registros DNS. Logo após o cadastro, você recebe por email os registros SPF, DKIM e DMARC para validar o seu domínio remetente.
  3. Receba os dados de acesso. Com a conta ativada, chegam por email os dados de autenticação SMTP e o acesso ao painel de relatórios.
  4. Configure o envio na sua aplicação usando os dados SMTP e faça um teste. Veja a seção Configuração SMTP.
Quanto tempo demora a ativação da conta?

Após o cadastro, os dados são validados e a conta é ativada em até 1 hora dentro do horário comercial. Ao ativar, você recebe por email:

  • Dados de autenticação SMTP (servidor, porta, usuário, senha)
  • Link e dados de acesso ao painel de relatórios
  • Os registros DNS — SPF, DKIM e DMARC — para validar o seu domínio
Preciso mudar minha hospedagem ou meu provedor de email?

Não. O SMTP da MailGrid funciona em paralelo com qualquer provedor de email que você já usa. Os seus emails atuais continuam funcionando normalmente, sem qualquer alteração — a MailGrid é usada exclusivamente para os envios feitos pela sua aplicação ou sistema, sem consumir os limites do seu provedor atual.

Você também não precisa registrar um novo domínio: pode usar o domínio que já possui, desde que ele tenha uma entrada DNS de MX válida.

Autenticação de Domínio

Os registros DNS que comprovam que o domínio é seu e melhoram a entregabilidade: SPF, DKIM, DMARC e o MX obrigatório.

O que significa "validar o meu domínio"?

Por questões de segurança, precisamos confirmar que o domínio realmente é seu ou da sua empresa. Por isso fornecemos 3 entradas de DNS para validação: SPF, DKIM e DMARC.

Essas entradas autenticam os seus envios, maximizando a taxa de entrega e reduzindo a rejeição das mensagens. Sem elas, é provável que suas mensagens sejam filtradas direto para o spam ou rejeitadas pelos servidores de destino.

Os registros exatos do seu domínio são fornecidos pela nossa equipe (e ficam disponíveis no painel, em Dados SMTP → Domínios de remetente). Os formatos abaixo são apenas exemplos do padrão de cada registro.
Onde eu insiro esses registros DNS?

Os registros são inseridos na zona de DNS do seu domínio — normalmente no painel de quem cuida do seu domínio (registro.br, seu provedor de hospedagem, Cloudflare, etc.). O passo a passo geral:

  1. Acesse o painel do seu provedor de DNS e localize a área de "Zona DNS", "Editar DNS" ou "Registros".
  2. Crie cada registro (SPF, DKIM e DMARC) com o tipo, nome/host e valor informados pela MailGrid.
  3. Salve e aguarde a propagação: de alguns minutos até 48 horas, dependendo do provedor.
  4. Acompanhe a validação no painel MailGrid, em Domínios de remetente. Quando os três registros forem reconhecidos, o domínio é liberado para envio.
Como configurar o SPF

O SPF (Sender Policy Framework) é uma entrada do tipo TXT no DNS que informa quais servidores estão autorizados a enviar emails em nome do seu domínio. O servidor da MailGrid precisa constar nesse registro para que seus emails não sejam rejeitados ou marcados como spam.

O formato geral é:

v=spf1 include:servidor.mailgrid.com.br ~all

Se o seu domínio já tem um SPF (por exemplo, do seu provedor de email), você não cria um segundo — apenas adiciona o include da MailGrid ao registro existente. Só pode haver um registro SPF por domínio.

Depois de inserir, a propagação leva de alguns minutos até 48 horas.

Como configurar o DKIM

O DKIM (DomainKeys Identified Mail) adiciona uma assinatura criptográfica às suas mensagens. Quando o servidor do destinatário recebe o email, ele verifica se a assinatura é válida — ou seja, se a mensagem realmente foi enviada pelo servidor autorizado e não foi alterada no caminho.

É um registro TXT, publicado em um subdomínio, no formato:

mailgrid._domainkey.seudominio.com.br TXT
"v=DKIM1; k=rsa; p=CHAVE_PUBLICA"
Combinado com SPF e DMARC, o DKIM aumenta a confiança dos servidores destinatários na autenticidade das suas mensagens — desde que o seu domínio tenha boa reputação de envios — reduzindo a chance de caírem no spam.
Como configurar o DMARC

O DMARC define a política do que deve acontecer com emails que falham na verificação de SPF ou DKIM. Também é publicado como um registro TXT no DNS:

_dmarc.seudominio.com.br TXT
"v=DMARC1; p=none; rua=mailto:dmarc@seudominio.com.br"

O parâmetro p define a política: none (apenas monitora), quarantine (envia para spam) ou reject (rejeita). Para começar, recomendamos p=none, que monitora sem impactar a entrega dos seus emails; depois de acompanhar os relatórios, você pode endurecer a política.

O que é o registro MX e por que ele é obrigatório?

O registro MX direciona os emails recebidos pelo seu domínio para os servidores que hospedam suas contas de email. Ele é fornecido pelo seu provedor de hospedagem ou de emails — não pela MailGrid.

Mesmo enviando pelo nosso SMTP, o seu domínio remetente precisa ter uma entrada MX válida. Sem ela, os provedores dos destinatários não conseguem validar o remetente (Sender Verify) e rejeitam as mensagens como suspeitas de spam.

Já configurei tudo, mas o domínio não valida. O que verificar?

Pontos mais comuns quando a validação não conclui:

  • Propagação em andamento — aguarde: pode levar até 48 horas.
  • Nome/host do registro errado — alguns provedores já acrescentam o domínio automaticamente; confira se não ficou duplicado (ex.: mailgrid._domainkey.seudominio.com.br.seudominio.com.br).
  • Dois registros SPF — só pode existir um; junte os include em um único registro.
  • Aspas ou espaços a mais ao colar o valor TXT.
  • MX ausente no domínio remetente.

Persistindo, abra um chamado informando o domínio — a nossa equipe confere os registros com você.

Configuração SMTP

Dados de conexão, tutorial passo a passo, exemplos de código, softwares compatíveis, RELAY e o que fazer quando a conexão falha.

Dados de conexão do servidor SMTP

Todos os dados de conexão ficam no painel, em Dados SMTP → Informações técnicas, e também são enviados no email de ativação. Os parâmetros de conexão são:

CampoValor
Servidor (host)Exibido em Informações técnicas no painel e no email de boas-vindas
Portas25, 465 ou 587
CriptografiaOpcional — STARTTLS ou TLS (recomendado). Versões suportadas: TLS 1.2 e 1.3
Requer autenticaçãoSim
Tipo de autenticaçãoLOGIN ou PLAIN
Usuário e senhaAs credenciais de uma das suas Contas SMTP
Recomendamos usar sempre a porta 587 com STARTTLS (ou 465 com TLS). A porta 25 costuma ser bloqueada por operadoras e provedores de nuvem.
Tutorial: configurar o envio SMTP na sua aplicação

Independente da linguagem ou do software, o processo é sempre o mesmo:

  1. Pegue os dados de conexão em Informações técnicas (host e portas) e as credenciais em Contas SMTP (usuário e senha).
  2. Preencha na sua aplicação: host, porta (587), criptografia (STARTTLS), autenticação ativada, usuário e senha.
  3. Defina o remetente (From/De) usando um endereço do seu domínio validado — ex.: nfe@seudominio.com.br.
  4. Envie um email de teste para você mesmo e confira o recebimento.
  5. Confirme no painel, em Relatório de envios, que a mensagem saiu com status "Entregue".
Prefere testar sem mexer no seu sistema? Use a ferramenta Testar conta SMTP do painel, que dispara um email de teste com as credenciais escolhidas.
Exemplo de envio com PHP (PHPMailer)

Exemplo mínimo usando a biblioteca PHPMailer, uma das mais usadas em PHP:

// use PHPMailer\PHPMailer\PHPMailer;
$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host       = 'seu-servidor.mailgrid.com.br'; // veja em Informações técnicas
$mail->SMTPAuth   = true;
$mail->Username   = 'suaconta@seudominio.com.br';   // sua Conta SMTP
$mail->Password   = 'sua_senha_smtp';
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->Port       = 587;

$mail->setFrom('nfe@seudominio.com.br', 'Sua Empresa');
$mail->addAddress('cliente@exemplo.com');
$mail->Subject = 'Sua nota fiscal';
$mail->isHTML(true);
$mail->Body    = '<p>Segue a sua nota fiscal em anexo.</p>';

$mail->send();

O mesmo padrão vale para outras linguagens: basta apontar o cliente SMTP para o host, a porta 587 com STARTTLS e as credenciais da sua conta.

Quais softwares e clientes de email são compatíveis?

Qualquer sistema, software ou cliente de email com suporte a autenticação SMTP é compatível com a MailGrid — por exemplo, Microsoft Outlook, Mac Mail, Windows Live Mail, Opera Mail, além de sistemas próprios em PHP, Java, Python, Node.js, .NET, entre outros.

Meu sistema não tem suporte a SMTP. O que faço?

Mesmo que sua aplicação não suporte o protocolo SMTP nativamente, você pode enviar suas mensagens usando nossa API HTTP/JSON, integrando diretamente ao seu sistema. Veja a seção API e Webhooks.

Posso integrar via RELAY no meu próprio servidor de emails?

Sim. Se você possui um servidor de emails interno (por exemplo, Microsoft Exchange ou IIS) e deseja enviar emails externos com mais qualidade de entrega, segurança e rapidez, basta contratar um plano com RELAY e fazer a integração, autenticada por login ou por endereço IP.

O recurso de SMTP + API + RELAY está disponível a partir do plano Performance.

Não consigo conectar ao servidor SMTP. E agora?

Verifique, nesta ordem:

  1. Usuário e senha — confira se são exatamente os de uma Conta SMTP ativa (cuidado com espaços ao copiar).
  2. Porta e criptografia — tente 587 com STARTTLS. Se estiver em uma rede que bloqueia a porta 25, troque para 587 ou 465.
  3. Tipo de autenticação — deve ser LOGIN ou PLAIN, com autenticação ativada.
  4. Bloqueio de IP no firewall — veja o item abaixo.
Meu IP foi bloqueado no firewall por tentativas de login

Nossos servidores têm firewall e proteção contra força bruta, que impede invasores de tentar adivinhar senhas. Se a sua aplicação errar as credenciais repetidamente, o seu IP entra nesse mesmo bloqueio:

  1. Mais de 10 tentativas com dados incorretos (usuário, senha, método de autenticação ou criptografia errados).
  2. Bloqueio temporário de 15 minutos — liberado automaticamente, sem precisar abrir chamado.
  3. Bloqueio permanente — se as tentativas continuarem, o desbloqueio passa a ser manual, mediante chamado ou contato com a central de atendimento.
Antes de solicitar desbloqueio, corrija a causa (normalmente credenciais ou porta erradas). Caso contrário, o IP será bloqueado de novo. Para pedir a verificação/desbloqueio, abra um chamado informando o seu IP.

Domínios e Remetentes

Como adicionar domínios remetentes, usar remetentes ilimitados e entender o que a MailGrid faz (e não faz) no recebimento.

Como adicionar um domínio remetente

No painel, acesse Dados SMTP → Domínios de remetente e siga:

  1. Clique em "Adicionar domínio" e informe o domínio próprio que deseja usar.
  2. O sistema gera os registros SPF, DKIM e DMARC específicos para esse domínio.
  3. Insira-os no DNS do domínio e aguarde a propagação (veja Autenticação de Domínio).
  4. Após a validação dos registros, o domínio fica liberado para envio.
Domínio não validado = emails descartados. Se você enviar com um domínio que não foi adicionado e validado, as mensagens são automaticamente descartadas com erro e o destinatário não recebe nada.
Quantos domínios posso adicionar por plano?

O número de domínios remetentes varia conforme o plano contratado — dos planos de entrada até os planos com domínios ilimitados. Apenas domínios próprios, registrados e online são aceitos; domínios de provedores gratuitos não são permitidos.

Veja o comparativo completo na seção Planos e Pagamento.

O que são remetentes ilimitados?

Em todos os planos, você pode enviar emails com remetentes ilimitados dentro de um mesmo domínio validado — usando uma única conta de autenticação SMTP. Assim, você dispara mensagens de financeiro@seudominio, nfe@seudominio, notificacoes@seudominio, etc., apenas informando o remetente desejado no campo From/De da sua aplicação.

Por segurança, os remetentes são validados antes dos envios: devem ser endereços existentes dentro do domínio validado.

Posso enviar com vários remetentes usando uma só conta?

Sim. Mesmo com um plano que tenha apenas uma conta de autenticação, você pode enviar usando diferentes remetentes, contanto que sejam endereços válidos e existentes no seu domínio validado. As contas de autenticação servem para autenticar a conexão; o remetente é definido no campo From/De da mensagem.

Recebo também acesso POP e IMAP?

Não. A MailGrid comercializa apenas o serviço SMTP para envio de emails, não o recebimento. Os acessos POP e IMAP continuam sendo fornecidos pelo seu provedor de hospedagem, onde você já mantém as contas de email do seu domínio.

E se eu também precisar de caixas postais (recebimento)?

O painel oferece, em Dados SMTP → Recebimento de emails, a opção de contratar caixas postais profissionais por meio da SoftServer Brasil, empresa do mesmo grupo (Hedder Tecnologia) — assim você unifica envio e recebimento com filtragem de spam e vírus, suporte em português e cobrança em reais. É um serviço opcional e independente do seu plano de SMTP.

Contas SMTP e Segurança

Contas de autenticação, senhas, verificação em duas etapas, sub-usuários, cópia de segurança e o PIN de atendimento.

O que é uma conta SMTP e quantas posso ter?

Uma conta SMTP é o par usuário + senha que a sua aplicação usa para autenticar a conexão de envio. O número de contas SMTP depende do plano contratado, e são úteis para configurar diferentes sistemas ou aplicações e filtrar os envios por conta no painel de relatórios.

Lembre-se: você não precisa de uma conta por remetente — os remetentes já são ilimitados dentro do domínio validado. As contas separam sistemas, não endereços.

Como criar, editar ou excluir uma conta SMTP

No painel, acesse Dados SMTP → Contas SMTP:

  1. Clique em "Adicionar conta" para criar uma nova credencial de autenticação.
  2. Use o botão editar para alterar a senha de uma conta existente.
  3. Use excluir para remover contas que não estão mais em uso.
Ao trocar ou excluir a senha de uma conta SMTP, os envios feitos com a senha antiga falham imediatamente. Atualize a configuração em todos os sistemas que usam essa conta.
Como trocar a senha do painel

Acesse cliente.mailgrid.com.br, abra Meu cadastro e use a opção de alterar senha. Esqueceu a senha? Use "Esqueci minha senha" na tela de login para redefini-la por email.

Como ativar a verificação em duas etapas (2FA)

A verificação em duas etapas pede um código adicional no login, além da sua senha — assim, mesmo que alguém descubra a sua senha, não consegue entrar. No painel, acesse Segurança. Há duas opções:

  • Aplicativo autenticador (recomendado): a opção mais segura, por não depender de sinal ou email. Compatível com Google Authenticator, Microsoft Authenticator, Authy, 1Password e outros.
  • Email ou SMS: o código chega por email ou por mensagem no celular (o celular precisa estar validado).

Para usar o aplicativo autenticador:

  1. Instale um aplicativo autenticador no seu celular.
  2. Escaneie o QR Code exibido na tela de Segurança (ou digite a chave manual).
  3. Informe o código gerado pelo app para confirmar a ativação.
Ao ativar a autenticação por aplicativo, a de email/SMS é desativada — e vice-versa. No próximo login, o código adicional passa a ser solicitado.
O que são sub-usuários do painel?

A partir do plano Profissional, você pode criar sub-usuários com diferentes níveis de acesso ao painel — total, apenas configurações, apenas dados SMTP, financeiro ou apenas relatórios. Ideal para dar acesso à sua equipe sem expor todos os dados da conta. A gestão fica em Sub-usuários, no painel.

O que é a cópia de segurança de emails?

É um recurso, disponível a partir do plano Performance, que copia de forma transparente e silenciosa todos os emails enviados pela sua conta para uma ou mais caixas postais que você definir.

Ajuda a reduzir o risco de vazamento de informações, avaliar a performance de envios da sua equipe e servir como contraprova em eventuais processos.

O que é o PIN de atendimento?

O PIN de atendimento identifica você como titular da conta durante o atendimento telefônico ou por outros canais. Ele fica visível na parte superior do seu painel de cliente (e em Informações técnicas) e é solicitado para confirmar a sua identidade antes de liberar informações da conta.

Por segurança, o PIN é atualizado automaticamente uma vez por semana.

Painel e Relatórios

Acompanhe cada envio, analise bounces e erros, veja os top senders, exporte CSV e entenda o que o painel mostra.

Como acesso o painel?

O painel fica em cliente.mailgrid.com.br. O endereço e os dados de acesso são enviados junto com as demais informações da conta no email de boas-vindas. Se não tiver mais esses dados, solicite o reenvio ao suporte.

Quais relatórios existem no painel?

Em Dados SMTP → Relatórios, você encontra:

  • Relatório de envios — o status individual de cada mensagem enviada.
  • Top Senders — os remetentes que mais enviam, para entender de onde vem o seu volume.
  • Análise de bounces — gráficos e lista dos endereços que devolveram.
  • Relatório consolidado — os totais do período em uma visão única.
  • Gráficos de envios — a evolução dos envios ao longo do tempo.
  • Erros de devolução — os motivos técnicos das rejeições e devoluções.
Que status um envio pode ter?

Os principais status exibidos são:

  • Entregue — email aceito pelo servidor do destinatário.
  • Hard bounce — endereço inexistente ou recusado em definitivo.
  • Soft bounce — falha temporária: caixa cheia, servidor fora do ar.
  • Rejeitado — recusado pelo servidor de destino.
  • Em fila — aguardando processamento (respeitando a velocidade do plano).
O painel não exibe abertura de emails ou cliques em links. Para esse tipo de rastreamento, utilize uma ferramenta de analytics de sua preferência, como o Google Analytics.
Como analisar e reduzir bounces

Use a Análise de bounces e os Erros de devolução para identificar os endereços inválidos da sua base e removê-los periodicamente. Uma taxa alta de bounces prejudica a reputação do seu IP e domínio e piora a entregabilidade dos próximos envios.

Dica: antes de enviar para listas antigas, passe os endereços pelo Validador de emails do painel.

Como exportar relatórios em CSV

Na tela de relatórios, escolha o período desejado e clique em "Exportar" para baixar o arquivo CSV — útil para análises em planilhas ou ferramentas de BI.

Por quanto tempo os relatórios ficam armazenados?

O painel mantém o histórico de envios dos últimos 90 dias. Para análises de longo prazo, recomendamos exportar os relatórios periodicamente em CSV.

Onde vejo o consumo do meu plano?

No Dashboard e em Informações técnicas você acompanha o limite mensal do plano, a velocidade de envio, as conexões simultâneas e o volume já enviado no mês. Ao atingir 90% do limite, você recebe um aviso no painel e por email.

Ferramentas de Envio

Recursos do painel, em Dados SMTP → Ferramentas, para testar e melhorar seus envios antes de disparar de verdade.

Validador de emails

Verifica a validade de um endereço de email antes de você enviar, ajudando a higienizar a sua base e reduzir bounces. A análise inclui checagem de sintaxe, existência do registro MX do domínio e um SMTP Probe — uma verificação direta no servidor do destinatário.

Alguns provedores bloqueiam, por política de segurança, essas conexões de verificação. Quando isso acontece, o resultado do SMTP Probe fica inconclusivo — isso é uma restrição do servidor remoto e não afeta a entrega real dos seus emails autenticados.
Analisador de mensagem

Avalia a sua mensagem antes do disparo e aponta o que pode prejudicar a entrega. Ele mostra:

  • Score anti-spam — quão propensa a mensagem está a ser filtrada.
  • Prévia de renderização — como o email deve aparecer para o destinatário.
  • Análise de links e outros pontos do conteúdo.

Ideal para revisar assunto e conteúdo HTML antes de colocar um novo template em produção.

Testar conta SMTP (disparador de teste)

Dispara um email de teste usando as credenciais de uma das suas contas SMTP, direto do painel — sem precisar mexer no seu sistema. É a forma mais rápida de confirmar que uma conta está funcionando e que o remetente escolhido está liberado, isolando se o problema está na credencial ou na sua aplicação.

API e Webhooks

Integre a MailGrid ao seu sistema por JSON e receba notificações automáticas de entrega e bounce.

O que dá para fazer com a API?

A API permite operar a MailGrid direto do seu sistema, via JSON:

  • Envio de emails transacionais.
  • Relatório de envios — status individual de cada mensagem.
  • Relatório consolidado — totais do período em uma requisição.
  • Domínios de remetente — adicionar, consultar e remover.
  • Contas SMTP — adicionar, trocar senha e remover.
  • Webhooks — receber avisos automáticos de entrega e bounce.

A base da API é https://api.mailgrid.net.br/. Os principais endpoints:

AçãoMétodoEndpoint
Enviar emailPOSTapi.mailgrid.net.br/sendmail/
Verificar domínioPOSTapi.mailgrid.net.br/domain/check/
RelatóriosPOSTapi.mailgrid.net.br/report/

Todas as chamadas são via POST, com corpo em JSON (UTF-8) e o cabeçalho Content-Type: application/json. A referência completa dos parâmetros e exemplos em várias linguagens está em docs.mailgrid.com.br.

O endpoint legado api.mailgrid.net.br/send/ continua ativo e operacional, mas não recebe mais atualizações — use o /sendmail/ em integrações novas.
Como gerar e usar o token de autenticação

No painel, acesse Integrações → API e clique em "Gerar token". Esse token identifica a sua conta e autentica todas as requisições — trate como uma senha.

  1. Gere o token na tela da API.
  2. Envie-o no cabeçalho de autenticação de cada requisição.
  3. Se precisar revogar, gere um novo — o anterior é invalidado imediatamente.
Gerar um novo token faz as integrações que usam o token antigo pararem na hora. Atualize a sua aplicação com o novo valor.
Exemplo de requisição à API

Um envio autenticado com o seu token, via curl. As credenciais SMTP (host, usuário e senha) vão no próprio corpo JSON, junto com os dados da mensagem:

# Troque SEU_TOKEN pelo token gerado no painel
curl -X POST "https://api.mailgrid.net.br/sendmail/" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -d '{
    "host_smtp": "seu-servidor.mailgrid.net.br",
    "usuario_smtp": "suaconta@seudominio.com.br",
    "senha_smtp": "sua_senha_smtp",
    "emailRemetente": "nfe@seudominio.com.br",
    "nomeRemetente": "Sua Empresa",
    "emailDestino": ["cliente@exemplo.com"],
    "assunto": "Sua nota fiscal",
    "mensagem": "<p>Segue a sua nota fiscal.</p>",
    "mensagemTipo": "html"
  }'

Campos obrigatórios: host_smtp, usuario_smtp, senha_smtp, emailRemetente, emailDestino, assunto e mensagem. O emailDestino é um array (máx. 100 por chamada). Também há campos opcionais para CC, BCC, Reply-To, anexos em base64 e variáveis. Em caso de sucesso, a resposta traz "status": "MSG ENVIADA" e "codigo": "200".

Cada requisição pode ter até 100 destinatários e o total da mensagem (com anexos) não deve passar de 50 MB. Lista completa de parâmetros e exemplos em PHP, Python, Node.js, Java, C# e mais: docs.mailgrid.com.br.
Boas práticas de segurança com o token
  • Envie as requisições sempre por HTTPS.
  • Guarde o token em variável de ambiente, fora do código versionado.
  • Nunca use o token em JavaScript de página pública ou repositório aberto.
  • Suspeitou de vazamento? Gere um novo token na hora.
O que são webhooks e como configurá-los

Com webhooks, a MailGrid envia uma requisição HTTP para a sua URL sempre que um evento monitorado acontece — assim você atualiza o seu sistema em tempo real, sem ficar consultando relatórios. Para configurar, acesse Integrações → Webhooks:

  1. Clique em "Novo webhook" e informe a URL de destino que receberá as notificações.
  2. Selecione ao menos um evento para monitorar (veja abaixo).
  3. Opcionalmente, informe um email de alerta.
  4. Defina a situação como ativa e salve. Um token é gerado para você validar a autenticidade das chamadas recebidas.

Detalhes do formato do payload em docs.mailgrid.com.br/webhooks.

Quais eventos os webhooks notificam?

Você escolhe quais eventos quer receber:

  • Entregas com sucesso — a mensagem foi aceita pelo servidor de destino.
  • Hard bounces — endereço inexistente ou recusado em definitivo.
  • Soft bounces — falha temporária: caixa cheia ou servidor fora do ar.
Ao editar um webhook, o token pode ser renovado ao salvar — atualize a validação no seu endpoint se isso acontecer.

Entregabilidade

Por que emails caem no spam, blacklists, velocidade de envio, limites do plano e excedentes.

Por que meus emails estão caindo no spam?

As causas mais comuns são:

  • SPF, DKIM ou DMARC não configurados ou configurados incorretamente
  • IP ou domínio com má reputação, ou listado em blacklists
  • Conteúdo do email com padrões identificados como spam
  • Alta taxa de bounces ou de reclamações pelos destinatários
  • Base de contatos desatualizada, com muitos endereços inválidos

Comece verificando se SPF, DKIM e DMARC estão corretos (Autenticação de Domínio), rode o Analisador de mensagem no conteúdo e confira se o IP está em blacklist.

Meu IP está em blacklist — o que fazer?

Blacklists são bancos de dados de IPs com histórico de envio de spam. Verifique se o seu IP está listado em ferramentas como MXToolbox ou MultiRBL, pesquisando pelo endereço IP fornecido pela MailGrid.

O processo de remoção (delisting) depende de cada blacklist — a maioria oferece um formulário próprio no site. Em alguns casos, a listagem expira automaticamente entre 7 e 30 dias.

No plano Profissional, você já recebe um IP dedicado incluso, com reputação aquecida e livre de blacklists. No Performance, o IP dedicado é opcional (+R$ 149,90/mês); no Start, os envios saem por IPs compartilhados, todos aquecidos e com ótima reputação.
Como funciona a velocidade de envios por hora?

Cada plano tem uma velocidade máxima de envios por hora. Se você disparar mais emails do que esse limite de uma só vez, os excedentes entram em fila e são processados respeitando a velocidade do seu plano. Não há limite diário de envios.

Exemplo: em um plano de 1.000 emails/hora, se você disparar 2.000 emails de uma vez, os 1.000 excedentes entram em fila para a próxima hora.

O que acontece quando atinjo o limite mensal do plano?

No painel você acompanha o limite mensal e o volume já enviado. Ao atingir 90% do limite, você recebe um aviso no painel e por email. Ao chegar a 100%, os envios não são bloqueados — continuam ocorrendo normalmente como excedentes.

Ao final do período contratado, o sistema soma os excedentes e emite uma fatura avulsa. Cada envio excedente é cobrado a R$ 0,004 por email além do limite do plano.

Como reduzir bounces e proteger a reputação?

Boas práticas que mais impactam a entrega:

  • Mantenha SPF, DKIM e DMARC válidos em todos os domínios remetentes.
  • Envie apenas para contatos que autorizaram (opt-in) e remova endereços que deram hard bounce.
  • Use o Validador de emails antes de enviar para listas antigas.
  • Revise o conteúdo no Analisador de mensagem.
  • Evite anexos pesados e links encurtados suspeitos.
A MailGrid garante 100% de entrega na caixa de entrada?

Fornecemos IPs com excelente reputação e todas as configurações de autenticação (DNS reverso, SPF, DKIM, DMARC). Ainda assim, alguns provedores aplicam filtros de spam próprios, que podem classificar uma mensagem legítima como spam ou até devolvê-la.

Por isso, a MailGrid não garante que 100% das mensagens chegarão à caixa de entrada — esse é um fator fora do nosso controle, que depende das regras de cada provedor de destino.

Planos e Pagamento

Comparativo de planos, formas de pagamento, faturas, upgrade, cancelamento e nota fiscal.

Comparativo de planos

São três planos, cada um com faixas de volume que você escolhe na contratação. O Performance é o mais vendido.

PlanoEnvios/mêsVelocidade/hDomíniosRELAYIP dedicadoA partir de
Start100 mil · 200 mil · 500 mil1.00010IPs compartilhadosR$ 99,90/mês
Performance1 mi · 2 mi · 3 mi10.000300Opcional (+R$ 149,90)R$ 259,90/mês
Profissional5 mi · 10 mi · 15 mi25.000IlimitadosInclusoR$ 899,90/mês

Todos os planos incluem SMTP + API + Webhooks, SPF/DKIM/DMARC, painel de relatórios e suporte especializado. RELAY e cópia de segurança de emails estão disponíveis a partir do Performance; DNS reverso personalizado, sub-usuários e IP dedicado incluso ficam no Profissional.

Pagamento anual tem 10% de desconto. Sem fidelidade — contrate e cancele quando quiser. Envio excedente ao limite mensal: R$ 0,004 por email.

Valores e detalhes atualizados em mailgrid.com.br/precos. Precisa de mais volume? Solicite uma proposta personalizada com infraestrutura dedicada e múltiplos IPs.

Quais formas de pagamento são aceitas?

A MailGrid aceita boleto bancário, PIX, cartões de crédito (Visa, Mastercard, Elo, Hipercard e American Express) e PayPal. Cartão, PIX e PayPal têm aprovação instantânea; boleto é confirmado em até 1 dia útil.

Pagamento mensal ou anual?

Oferecemos pagamentos mensais ou anuais, conforme a sua necessidade. No mensal, o vencimento ocorre em um dia específico todos os meses; no anual, uma vez por ano. Você pode configurar a cobrança recorrente no painel, em Financeiro.

Como funciona o envio das faturas?

As faturas mensais são enviadas no dia 1 ou 3 de cada mês para o(s) email(s) cadastrado(s) na conta. A MailGrid não envia faturas por correio — apenas por email, com um lembrete adicional 10 dias antes do vencimento e novamente no dia do vencimento. Você também consulta as faturas no painel, em Financeiro. Emitimos Nota Fiscal de Serviços para todos os planos.

Sou cobrado mesmo se não enviar nenhum email?

Sim. Os planos são mensais, com renovação automática — a cobrança é pela disponibilidade do serviço, não por créditos de envio. As faturas continuam sendo emitidas até que você solicite o cancelamento, ou até a conta ser cancelada automaticamente após 30 dias de atraso no pagamento.

Como faço upgrade ou downgrade de plano?

Você pode alterar o plano a qualquer momento, sem burocracia, no painel — em Informações técnicas → Alterar plano (ou na área de upgrade da conta). É a forma recomendada quando o seu volume cresce e os excedentes passam a compensar um plano maior.

Como cancelar e existe multa?

Não há fidelidade nem multa em nenhum plano. O cancelamento é feito diretamente no seu painel de cliente, no menu Minha Conta, a qualquer momento.

Conforme os Termos de Uso, valores pagos não são reembolsáveis após 7 dias do prazo legal de desistência da compra.
A MailGrid emite nota fiscal?

Sim. Somos uma empresa brasileira e emitimos Nota Fiscal de Serviços para todos os planos contratados. As notas fiscais são enviadas junto com as faturas de cobrança.

Suporte e Atendimento

Canais, horários, abertura de tickets, PIN de segurança e onde acompanhar o status dos serviços.

Quais são os canais de atendimento?
  • Tickets de suporte — todos os dias, 24 horas
  • Telefone — segunda a sexta, das 8h às 18h — (11) 5196-4517
  • WhatsApp — disponível para planos com essa modalidade, segunda a sexta, das 8h às 18h
Como abrir um ticket de suporte

No painel, acesse Ajuda e suporte → Novo ticket (ou Meus tickets para acompanhar os chamados abertos). Descreva o problema com o máximo de detalhes — domínio, conta SMTP envolvida, mensagens de erro e horário — para agilizar a resposta. Você também pode abrir um chamado pelo site, em mailgrid.com.br/atendimento.

Como me identifico no atendimento (PIN)?

Ao entrar em contato por telefone, informamos e confirmamos o seu PIN de atendimento para liberar informações da conta com segurança. Ele fica no topo do painel e em Informações técnicas, e é atualizado automaticamente uma vez por semana. Veja mais em Contas SMTP e Segurança.

A MailGrid ajuda na configuração inicial?

Sim. Nosso time de especialistas acompanha você desde a confirmação do domínio até a configuração da conta SMTP na sua aplicação, caso seja necessário. Para acompanhar a disponibilidade da plataforma em tempo real, consulte também status.mailgrid.com.br.

Nenhum resultado encontrado

Tente outra palavra-chave ou abra um chamado de suporte.

Não encontrou o que precisava?

Nosso suporte responde tickets todos os dias, 24 horas.

Abrir chamado de suporte