Como enviar um e-mail SMTP

Você também pode enviar e-mails com a IU e com a API.

O que é SMTP?

SMTP (Simple Mail Transfer Protocol, protocolo simples de transferência de e-mail) é uma maneira rápida e fácil de enviar e-mails de um servidor para outro. O SendGrid oferece um serviço SMTP que permite que você forneça seu e-mail com nossos servidores em vez de seu próprio cliente ou servidor. Isso significa que você pode contar com a entrega do SendGrid em escala para atender às suas necessidades de SMTP.

A API SMTP do SendGrid também permite que você especifique instruções personalizadas de manuseio de e-mail usando uma lista codificada JSON chamada cabeçalho X-SMTPAPI. O cabeçalho X-SMTPAPI é analisado pelo SendGrid para modificar sua mensagem da maneira especificada.

Para uma análise mais aprofundada do que é o SMTP, os benefícios de enviar um e-mail com SMTP e como o SendGrid pode ajudar, consulte o Curso rápido de serviço SMTP em nosso blog.

Como enviar um e-mail SMTP de teste com Telnet

Esta página vai ajudá-lo a enviar uma primeira mensagem de teste usando Telnet. Depois de concluir esse processo, você estará mais bem preparado para explorar e criar mensagens usando o cabeçalho X-SMTPAPI.

Pré-requisitos

Certifique-se de executar os pré-requisitos a seguir para concluir este tutorial.

Cadastre-se no SendGrid
Crie e armazene uma [API Key | Chave API] do SendGrid(https://app.sendgrid.com/settings/api_keys) com permissões "Mail Send" de acesso total.
Verifique sua Sender Identity | Identidade do remetente
Abra o terminal, também conhecido como prompt de comando ou linha de comando. Você usará o terminal para codificar sua API key (chave API) e inserir os comandos que iniciam uma conexão Telnet.

Nos exemplos de código a seguir, os símbolos de maior e menor estão envolvendo valores de espaço reservado (por exemplo, <YOUR_API_KEY>). Você deve substituir os símbolos de maior e menor e o texto dentro deles por um valor real. Por exemplo, echo -n '<YOUR_API_KEY>' | openssl base64 se torna echo -n 'SG.someactualkey' | openssl base64 se sua chave API for SG.someactualkey.

Em alguns casos, você verá dois conjuntos de símbolos maior e menor envolvendo um espaço reservado. Nesse caso, um conjunto de símbolos maior e menor é necessário no valor real e não deve ser substituído. Por exemplo, From: "Example" <<example@example.com>> vai se tornar From: "Example" <example@example.com>.

Depois de abrir o terminal e salvar a chave API, você deve codificar a chave API em Base64. Observe que não é seguro colocar sua chave API em uma página web externa para uma conversão, portanto, recomendamos usar uma conversão em seu terminal. Se você estiver no Mac ou Linux, poderá usar o pacote OpenSSL pré-instalado para codificar uma string Base64 com o seguinte comando.

echo -n '<YOUR_API_KEY>' | openssl base64

Salve sua chave codificada para mais tarde. Além disso, certifique-se de não ter incluído nenhum caractere de nova linha ou espaço em branco por acidente. Isso pode acontecer ao copiar a chave codificada de uma shell que quebra linhas de saída. O SMTP é um protocolo orientado por linha, e os caracteres de alimentação de linha impedem que você faça a autenticação com êxito.

O Telnet não registra backspace corretamente, portanto, você deve digitar seus comandos corretamente ou copiá-los e colá-los nesta página.

Enviar um e-mail SMTP usando Telnet:

Pode ser necessário instalar o Telnet em sua máquina. O Telnet é fornecido nativamente em alguns sistemas operacionais; no entanto, versões recentes do MacOS não incluem mais o Telnet, e o Telnet deve ser ativado manualmente no Windows 10.

Você pode instalar o Telnet no MacOS usando Homebrew.

Para ativar o Telnet no Windows 10, navegue até recursos do Windows > Ative ou desative os recursos do Windows no Painel de controle do Windows. Marque a caixa ao lado de Cliente Telnet e selecione OK.

Inicie uma sessão Telnet digitando o seguinte no terminal:

TELNET smtp.sendgrid.net 25

O SendGrid aceita ligações não encriptadas e TLS em portas 25, 587, & 2525. Você também pode conectar via SSL na porta 465. Muitos provedores de hospedagem e ISPs bloqueiam a porta 25 como uma prática padrão. Se a sua sessão Telent atingir continuamente o tempo limite ou não se conectar usando a porta 25, é provável que seu provedor de serviços de Internet ou provedor de hospedagem esteja bloqueando a porta. Você pode entrar em contato com seu host/provedor de serviços de Internet para descobrir quais portas estão abertas para o relé SMTP de saída. Recomendamos o uso da porta 587 para evitar qualquer limitação de taxa que seu host de servidor possa aplicar.

Depois de se conectar ao SendGrid com êxito, faça login no servidor digitando o seguinte:

AUTH LOGIN

O servidor de e-mail responderá com 334 VXNlcm5hbWU6, que é uma solicitação codificada Base64 para seu nome de usuário.

Insira YXBpa2V5 e pressione Enter no teclado. O Twilio SendGrid exige que você faça a autenticação usando uma chave API. Ao usar a Autenticação Básica e uma chave API, você deve usar a string apikey no lugar do nome de usuário da sua conta. A string apikey é YXBpa2V5 quando codificada em Base64, e é por isso que a usamos nesta etapa.

O servidor de e-mail responderá com 334 UGFzc3dvcmQ6. Esta resposta é uma solicitação codificada Base64 para sua senha (sua chave API).

Digite sua chave API convertida Base64 na próxima linha como a senha e pressione Enter.

O servidor de e-mail responderá com 235 Authentication successful. Chegar até aqui indica que sua conexão com o smtp.sendgrid.net pela porta escolhida está aberta e que sua chave API é válida.

Em seguida, adicione o e-mail do qual você está enviando usando comando SMTP MAIL FROM e pressione Enter.

MAIL FROM: <SENDER_EMAIL>

O servidor de e-mail responderá com 250 Sender address accepted.

Adicione o e-mail para o qual você está enviando usando o comando SMTP RCPT TO e pressione Enter.

RCPT TO: <RECIPIENT_ADDRESS>

Note que você pode adicionar mais endereços RCPT TO durante este passo. Repita o processo adicionando outro comando RCPT TO e pressionando Enter para cada destinatário para o qual deseja enviar a mensagem.

O servidor de e-mail responderá com 250 Recipient address accepted depois que cada destinatário for adicionado.

Na próxima linha, digite DATA e pressione Enter.

O servidor de e-mail responderá com 354 Continue. Ao contrário dos comandos MAIL FROM e RCPT TO, que fazem parte do envelope de e-mail, o comando DATA não deve conter informações que encaminham seu e-mail de um remetente para um destinatário. Em vez disso, DATA permite que você modifique o conteúdo da sua mensagem.

Como opção, adicione um cabeçalho de e-mail para adicionar o nome e o endereço de e-mail do destinatário ao cabeçalho do e pressione Enter. Observe que o nome deve ser colocado entre aspas, e o endereço deve ser envolvido em um símbolo maior e menor.

To: "<RecipientName>" <<RecipientEmailAddress>>

Em seguida, adicione um cabeçalho de para adicionar o nome e o endereço de e-mail do remetente ao cabeçalho do e-mail e pressione Enter. Se um cabeçalho de não estiver incluído, o SendGrid bloqueará seu e-mail porque ele não segue as diretrizes de conformidade (https://tools.ietf.org/html/rfc5322) [RFC 5322]. Observe que o nome deve ser colocado entre aspas, e o endereço deve ser envolvido em um símbolo maior e menor.

From: "<SenderName>" <<SenderEmail>>

Inclua uma linha de assunto e pressione Enter.

Subject: <EMAIL_SUBJECT>

Pressione Enter novamente para adicionar uma linha de retorno de carro. Em seguida, adicione o conteúdo do corpo da mensagem e pressione Enter.

"<MESSAGE>"

Por exemplo:

"Este é um teste para o relé SMTP."

Por fim, envie o e-mail digitando um ponto, ., e pressionando Enter.

O servidor de e-mail retornará 250 Ok: queued as <examplestring1234>. Isso significa que o e-mail foi colocado na fila para ser enviado. A fila se move muito rapidamente, e você verá o e-mail entregue aos destinatários designados em breve.

Saia da conexão Telnet digitando quit e pressionando Enter.

O comando completo deve ser parecido com o exemplo a seguir.

235 Authentication successful
MAIL FROM:tiramisu@example.com
250 Sender address accepted
RCPT TO:person1@sendgrid.com
250 Recipient address accepted
DATA
354 Continue
From: "Tira Misu" <tiramisu@example.com>
To: "Pessoa 1" <person1@sendgrid.com>
Assunto: Mensagem de assunto de teste
"Este é o corpo de mensagem de teste."
.
250 Ok: queued as Yo60h6C5ScGPeP5fUWU3K

Agora que você enviou um e-mail de teste, aprenda a integrar seus servidores com nosso serviço SMTP.

Limite de tamanho da mensagem: O tamanho total da mensagem não deve exceder 20 MB. Isso inclui a mensagem em si, os cabeçalhos e o tamanho combinado de quaisquer anexos.

Deseja ajuda especializada para que seu programa de e-mail comece com o pé direito?

Economize tempo e sinta-se confiante de que está preparado para o sucesso de longo prazo com a implementação de e-mail. Nossos especialistas trabalharão como uma extensão de sua equipe para garantir que seu programa de e-mail esteja configurado corretamente e fornecendo valor para sua empresa.

SERVIÇOS DE IMPLEMENTAÇÃO →

Recursos adicionais

Precisa de ajuda?

Às vezes, todos nós precisamos. Receba ajuda agora da equipe de suporte do Twilio SendGrid.

Enfrentando dificuldades de codificação? Confie na sabedoria da multidão navegando pela tag SendGrid em Stack Overflow ou visite o Stack Overflow Collective da Twilio.