como chamar BatchSendMail para enviar e-mails em lote - : Central de Documentação do Alibaba Cloud

Testar

Execute esta operação diretamente no OpenAPI Explorer para evitar o cálculo manual de assinaturas. Após uma chamada bem-sucedida, o OpenAPI Explorer gera automaticamente exemplos de código SDK.

Parâmetros da solicitação

Nome	Tipo	Obrigatório	Exemplo	Descrição
AccountName	String	Sim	test@example.com	Endereço do remetente configurado no console.
AddressType	Integer	Sim	1	0: Conta aleatória 1: Endereço do remetente
ReceiversName	String	Sim	test2	Nome de uma lista de destinatários pré-criada com dados carregados. Observação: Para evitar falhas no envio, aguarde pelo menos 10 minutos após o acionamento da tarefa antes de excluir a lista.
TemplateName	String	Sim	test1	Nome de um modelo pré-criado e aprovado.
Action	String	Não	BatchSendMail	Parâmetro obrigatório. Defina o valor como BatchSendMail.
ClickTrace	String	Não	0	1: Ativa o rastreamento de dados. 0 (padrão): Desativa o rastreamento de dados.
TagName	String	Não	test3	Nome da tag de e-mail.
ReplyAddress	String	Não	test2***@example.net	Endereço de resposta.
ReplyAddressAlias	String	Não	Alice	Alias do endereço de resposta.
UnSubscribeLinkType	String	Não	default	Define o tipo de link de cancelamento de inscrição a ser gerado. Para mais informações, consulte Instruções do recurso de cancelamento de inscrição. Disabled: Geração desativada. default: Aplica a política padrão. O sistema gera um link de cancelamento ao enviar e-mails de um endereço de remetente em lote para domínios específicos, incluindo aqueles com palavras-chave como "gmail", "yahoo", "google", "aol.com", "hotmail", "outlook" ou "ymail.com". Gerado para instrumentação futura. en-us: Gera um link. Reservado para instrumentação de conteúdo futuro.
UnSubscribeFilterLevel	String	Não	mailfrom_domain	Nível de filtro. Para mais informações, consulte Ajuda do Recurso de Cancelamento de Inscrição. disabled: Sem filtragem. default: Aplica a política padrão. A filtragem ocorre no nível do endereço do remetente em lote. mailfrom: Filtra no nível do endereço do remetente. mailfrom_domain: Filtra no nível do domínio de e-mail. edm_id: Filtra no nível da conta.

Parâmetros de resposta

Nome	Tipo	Exemplo	Descrição
EnvId	String	xxx	ID do evento.
RequestId	String	12D086F6-8F31-4658-84C1-006DED011A85	ID da solicitação.

Exemplos

Exemplo de solicitação

https://dm.aliyuncs.com/?Action=BatchSendMail
&AccountName=test@example.com
&AddressType=1
&ReceiversName=test2
&TemplateName=test1
&<Common request parameters>

Exemplos de resposta bem-sucedida

Formato XML

<BatchSendMailResponse>
      <RequestId>12D086F6-8F31-4658-84C1-006DED011A85</RequestId>
      <EnvId>xxx</EnvId>
</BatchSendMailResponse>

Formato JSON

{
        "EnvId":"xxx",
        "RequestId":"12D086F6-8F31-4658-84C1-006DED011A85"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidMailAddressName.Malformed	The specified MailAddress name is wrongly formed.	Formato inválido para o endereço do remetente. O endereço deve conter o símbolo de arroba (@). O nome de domínio aceita dígitos, letras, sublinhados (_), hifens (-) e pontos (.). O nome da conta também aceita dígitos, letras, sublinhados (_), hifens (-) e pontos (.).
400	InvalidReceiverName.Malformed	The specified receiver name is wrongly formed.	Formato inválido para o endereço do destinatário. O endereço deve conter o símbolo de arroba (@). O nome de domínio aceita dígitos, letras, sublinhados (_), hifens (-) e pontos (.). O nome da conta também aceita dígitos, letras, sublinhados (_), hifens (-) e pontos (.).
400	InvalidTemplateName.Malformed	The specified template name is wrongly formed.	Formato inválido para o nome do modelo. O limite máximo é de 30 caracteres.
404	InvalidMailAddress.NotFound	The specified mailAddress does not exist.	O endereço do remetente especificado não existe. Verifique o endereço.
404	InvalidTemplate.NotFound	The specified template does not exist.	O modelo especificado não existe.
404	InvalidReceiver.NotFound	The specified receiver does not exist.	Destinatário inexistente. Verifique se o destinatário está cadastrado.
400	InvalidSendMail.Spam	Sendmail rejected by spam filter.	Envio de e-mail negado. Verifique o status do usuário para identificar problemas como excesso de frequência ou cota insuficiente.
400	InvalidMailAddressSendType.Malformed	The specified mailAddress sendType is wrongly formed.	Tipo de envio inválido. Acesse o console para verificar o tipo e ajustar o valor conforme necessário.
400	InvalidMailAddressStatus.Malformed	The specified mailAddress status is wrongly formed.	Status inválido para o endereço do remetente. Verifique se o endereço está ativo ou congelado.
400	InvalidMailAddressDomain.Malformed	The specified mailAddress domain does not exist.	Formato inválido para o nome de domínio. Utilize apenas dígitos, letras, sublinhados (_), hifens (-) e pontos (.).
400	InvalidTemplateStatus.Malformed	The specified template status is wrongly formed.	Status inválido para o modelo. Confirme se o modelo foi aprovado.
400	InvalidReceiverStatus.Malformed	The specified receivers status is wrongly formed.	Status inválido para o destinatário. Acesse o console para confirmar se os destinatários foram carregados.
400	InvalidReplyAddressAlias.Malformed	The specified replyAddressAlias is wrongly formed.	Formato inválido para o alias do endereço de resposta. O limite máximo é de 15 caracteres.
400	InvalidReplyAddress.Malformed	The specified replyAddress is wrongly formed.	Formato inválido para o endereço de resposta. O endereço deve conter o símbolo de arroba (@). O nome de domínio aceita dígitos, letras, sublinhados (_), hifens (-) e pontos (.). O nome da conta também aceita dígitos, letras, sublinhados (_), hifens (-) e pontos (.).

Para obter uma lista completa de outros códigos de erro, acesse a Central de Erros.