O SendGrid é uma solução de e-mail transacional popular que permite enviar e-mails programaticamente com alta taxa de entrega. Este tutorial mostra como configurar e usar o SMTP do SendGrid para envio de e-mails.
Pré-requisitos:
Conta no SendGrid
Acesso ao painel da sua hospedagem
API Key gerada no painel do SendGrid
Passo 1: Criar uma conta no SendGrid
Registrar-se no SendGrid
- Acesse o site do SendGrid e crie uma conta, caso ainda não tenha.
Configurar um domínio de envio
-
Após criar a conta, será necessário configurar um domínio de envio.
-
O processo envolve adicionar registros DNS ao seu domínio (como CNAME e TXT) para autenticar os e-mails.
-
Siga as instruções exibidas no painel do SendGrid para concluir a verificação do domínio.
Passo 2: Gerar uma API Key
-
No painel do SendGrid, vá para Settings > API Keys.
-
Clique em "Create API Key".
-
Insira um nome para a chave, selecione as permissões apropriadas (geralmente "Full Access") e clique em "Create & View".
-
Copie a chave gerada e guarde-a com segurança — você precisará dela na configuração SMTP.
Passo 3: Configurar as credenciais SMTP
Para enviar e-mails com o SMTP do SendGrid, utilize as seguintes credenciais:
-
Servidor SMTP:
smtp.sendgrid.net
-
Porta SMTP:
587
(TLS) ou465
(SSL) -
Usuário:
apikey
(literalmente a palavra “apikey”) -
Senha: Sua API Key gerada anteriormente
Passo 4: Testar a configuração SMTP
Testar com clientes de e-mail
-
Abra um cliente de e-mail (como Outlook, Thunderbird ou Apple Mail).
-
Adicione uma nova conta de e-mail.
-
Preencha as informações do servidor SMTP, porta e credenciais.
-
Envie um e-mail de teste para verificar se está tudo funcionando corretamente.
Verificar o log de envio
-
Confirme o recebimento do e-mail de teste na caixa do destinatário.
-
Verifique também os logs no cliente de e-mail ou ferramenta usada para verificar possíveis erros no envio.
Solução de problemas comuns
Erro de autenticação
-
Verifique se está utilizando
apikey
como nome de usuário e a API Key correta como senha. -
Confirme que a API Key tem as permissões adequadas.
Erro de conexão
-
Verifique o servidor SMTP (
smtp.sendgrid.net
) e a porta usada (587 ou 465). -
Assegure-se de que sua conexão com a internet está estável.
Considerações finais
Usar o SMTP do SendGrid é uma solução eficiente para enviar e-mails programaticamente, especialmente em ambientes de produção. Além disso, o SendGrid oferece:
-
Alta capacidade de envio
-
Relatórios de entrega e engajamento
-
Ferramentas para análise e rastreamento de e-mails
Para sistemas de atendimento, ele é ideal para gerenciar notificações e mensagens de suporte automatizadas.