Este documento descreve o processo simplificado de uso de API e SMTP para enviar e-mails rapidamente.
Para compreender rapidamente o DirectMail, percorra o fluxograma a seguir. O documento contém explicações detalhadas sobre os nós correspondentes.
Ativar o Direct Mail
Ativação pela conta principal: Acesse a página do produto DirectMail e clique em Buy Now para adquirir um pacote de recursos pré-pagos do DirectMail. Você também pode clicar em Activate Now para ativar o DirectMail com o método de faturamento pagamento conforme o uso.
Ativação por conta RAM: Use a conta principal para conceder as permissões AliyunDirectMailFullAccess e AliyunDirectMailReadOnlyAccess à conta RAM no console RAM.
Nota: Certifique-se de que sua conta Alibaba Cloud já passou pela verificação de nome real antes de comprar e ativar o DirectMail.
Clique em aqui para concluir a verificação de nome real.
Selecione a região de envio
Selecione uma destas regiões: China (Hangzhou), Singapore ou Germany and United States. Os nomes de domínio e endereços de remetente de uma região são válidos apenas nela. Endereços de remetente criados em determinada região só enviam e-mails por meio do Console, da API ou do SMTP dessa mesma região.
Como selecionar a região:
Premissa: As diferentes regiões determinam o local de armazenamento dos dados. Se houver clientes fora da China envolvidos, consulte seu departamento jurídico para escolher uma região com base nas leis e regulamentações de conformidade de dados aplicáveis.
Caso sua aplicação de envio de e-mails esteja implantada na China, recomendamos a região China (Hangzhou).
Quando o programa de envio estiver implantado fora da China e a maioria dos endereços de destinatários também estiver no exterior, selecione Singapore, Germany and United States.
Se a aplicação de envio de e-mails estiver implantada fora da China, mas a maior parte dos endereços de destinatários residir na China, adote uma das seguintes recomendações conforme seu cenário de negócios:
a. Ao usar uma aplicação de envio de e-mails via SMTP implantada nos EUA ou em Singapore, recomendamos a região China (Hangzhou). Os e-mails são roteados automaticamente para essa região por meio dos nós da rede de entrega de conteúdo (CDN) localizados nos EUA ou em Singapore.
b. Para os demais cenários, recomendamos a região Singapore.
Crie e configure o nome de domínio
Crie um nome de domínio de envio ao usar o DirectMail pela primeira vez. Configure o nome de domínio pelo método de configuração automática ou configuração manual. Para mais detalhes, consulte as etapas 1 a 4 em Configurar envio de e-mail.
Crie endereços de remetente
Crie endereços de remetente: Esses endereços representam o e-mail do remetente e aparecem nas mensagens recebidas pelos destinatários.
Verifique endereço de resposta: Durante a configuração dos endereços de remetente, especifique um endereço de resposta para receber e-mails.
Defina senha SMTP: Para enviar e-mails via SMTP, defina uma senha SMTP durante a configuração dos endereços de remetente.
Para mais informações, consulte Configurar um endereço de remetente.
Enviar e-mails chamando a API
Endpoints da API: Para mais informações, consulte Endpoints da API.
Interfaces para entrega de e-mail: SingleSendMail e BatchSendMail.
Chame a API por assinatura ou SDK. A Alibaba Cloud fornece códigos de exemplo para ambos os métodos, sendo o SDK o mais utilizado. Este tópico usa o método SDK como exemplo.
Assinatura: Para mais informações, consulte Assinaturas de solicitação.
SDK:
Gere código automaticamente com o OpenAPI Explorer. Use o OpenAPI Explorer para depuração, selecione uma linguagem de programação, configure os parâmetros e baixe o código gerado automaticamente. Use o SDK V2.0 ou V1.0. Recomendamos a versão V2.0.

Outros métodos de SDK. Baixe o pacote do SDK na Referência do SDK ou instale-o via Maven e, em seguida, envie e-mails com base no código de exemplo.

Nota: Especifique os valores obrigatórios para os parâmetros AccessKeyID e AccessKeySecret no código. O AccessKey ID e o AccessKey Secret são as credenciais usadas para acessar a API da Alibaba Cloud. Crie uma AccessKey na página Gerenciamento de AccessKey no Console de Gerenciamento da Alibaba Cloud.

Enviar e-mails via SMTP
Servidores SMTP: Endpoints do serviço SMTP.
Exemplos:
A documentação oficial da Alibaba Cloud oferece exemplos de código em diversas linguagens de programação. Para obter um exemplo específico para sua linguagem, consulte a Referência SMTP.
Usaremos o código Java como exemplo aqui.
Configure um ambiente de desenvolvimento Java e baixe o editor de código necessário.
Localize o Exemplo de chamada SMTP em Java, clique em no ícone de cópia na seção de amostra de código, cole o exemplo no editor e substitua os valores dos parâmetros de exemplo pelos valores reais.

Relatórios de entrega
Visualize as estatísticas dos e-mails enviados por todos os endereços de remetente associados à conta principal usando um dos métodos abaixo:
Caminho: DirectMail-->Reporting. Nesta página, verifique a visão geral de entregas, o log de entregas e os endereços inválidos. Para mais detalhes, consulte Estatísticas de dados.
2. Cinco interfaces estão disponíveis para consultar a visão geral de entregas. Para detalhes sobre essas interfaces, consulte APIs para dados de envio. Quanto ao método de chamada, siga as orientações apresentadas anteriormente na seção de envio por API.
