Envia e-mails em lotes.
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
dm:BatchSendMail |
none |
*All Resource
|
Nenhuma | Nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| TemplateName |
string |
Não |
O nome de um modelo pré-criado e aprovado. |
test1 |
| AccountName |
string |
Sim |
O endereço do remetente configurado no console de gerenciamento. |
test@example.com |
| ReceiversName |
string |
Não |
O nome de uma lista de destinatários pré-criada que possui destinatários carregados. Nota: O número de destinatários na lista não deve exceder a cota diária restante. Caso contrário, o envio do e-mail falhará. Não exclua a lista de destinatários até pelo menos 10 minutos após o acionamento da tarefa. Caso contrário, o envio do e-mail poderá falhar. |
test2 |
| AddressType |
integer |
Sim |
Valores válidos:
|
1 |
| TagName |
string |
Não |
O nome da tag do e-mail. |
test3 |
| ReplyAddress |
string |
Não |
O endereço de resposta. |
test2***@example.net |
| ReplyAddressAlias |
string |
Não |
O alias do endereço de resposta. |
小红 |
| ClickTrace |
string |
Não |
Valores válidos:
|
0 |
| UnSubscribeLinkType |
string |
Não |
O tipo do link de cancelamento de inscrição gerado. Para obter mais informações, consulte Mecanismo de geração e filtragem de links de cancelamento de inscrição. Valores válidos:
O idioma de exibição é determinado automaticamente com base nas configurações do navegador do destinatário. |
default |
| UnSubscribeFilterLevel |
string |
Não |
O nível de filtragem. Para obter mais informações, consulte Mecanismo de geração e filtragem de links de cancelamento de inscrição. Valores válidos:
|
mailfrom_domain |
| Headers |
string |
Não |
As configurações de cabeçalho do e-mail. Os campos padrão e não padrão devem estar em conformidade com os requisitos de sintaxe para cabeçalhos definidos no padrão. Um máximo de 10 cabeçalhos pode ser transmitido através do campo headers ao enviar e-mails via API. Os cabeçalhos que excederem esse limite serão ignorados. O SMTP não possui essa limitação.
Message-ID, List-Unsubscribe, List-Unsubscribe-Post Os campos padrão substituem os valores originais no cabeçalho do e-mail.
Não diferenciam maiúsculas de minúsculas. a. Campos com o prefixo X-User- (não enviados para o EventBridge ou Message Service (MNS). Esta restrição se aplica apenas à API. O SMTP permite quaisquer campos personalizados.) b. Campos com o prefixo X-User-Notify- (enviados para o EventBridge e Message Service (MNS). Tanto a API quanto o SMTP são suportados.) Quando enviados para o EventBridge ou MNS, esses campos são incluídos no campo header. |
{
"Message-ID": " |
| IpPoolId |
string |
Não |
O ID do pool de endereços IP dedicados. Os usuários que adquiriram endereços IP dedicados podem usar este parâmetro para especificar o endereço IP de saída para esta tarefa de envio de e-mail. |
e4xxxxxe-4xx0-4xx3-8xxa-74cxxxxx1cef |
| DomainAuth |
boolean |
Não |
Especifica se a autenticação no nível do domínio deve ser ativada. Valores válidos:
Use este parâmetro apenas para autenticação no nível do domínio. Ignore-o para autenticação no nível do endereço do remetente.
Cenário de API Defina AccountName como o nome de domínio. O destinatário vê domain-auth-created-by-system@example.com como o remetente. Cenário de SMTP a. Chame a operação ModifyPWByDomain para definir a senha do domínio. b. Autentique-se com o nome de domínio e a senha configurada. Passe um endereço personalizado, como user@example.com, como o remetente real (mailfrom). O destinatário vê user@example.com como o remetente. |
true |
| TemplateContent |
object |
Não |
O conteúdo personalizado do e-mail. Você pode especificar o conteúdo diretamente sem criar um modelo antecipadamente. Especifique este parâmetro ou TemplateName. Se tanto TemplateContent quanto TemplateName forem especificados, TemplateName terá precedência. |
|
| Subject |
string |
Não |
O assunto do e-mail. |
黑色星期五,专属折扣来袭 |
| HtmlBody |
string |
Não |
O corpo HTML do e-mail. Nota: HtmlBody e TextBody são usados para diferentes tipos de conteúdo de e-mail. Você deve especificar um deles. O novo SDK usa Body para passagem de parâmetros com um limite de tamanho de aproximadamente 8 MB (Java 1.4.0 e posterior, Python3 1.4.0 e posterior, PHP 1.4.0 e posterior). |
全场九折,仅限今日 |
| TextBody |
string |
Não |
O corpo de texto simples do e-mail. Nota: HtmlBody e TextBody são usados para diferentes tipos de conteúdo de e-mail. Você deve especificar um deles. O novo SDK usa Body para passagem de parâmetros com um limite de tamanho de aproximadamente 8 MB (Java 1.4.0 e posterior, Python3 1.4.0 e posterior, PHP 1.4.0 e posterior). |
全场九折,仅限今日 |
| Alias |
string |
Não |
O nome de exibição do remetente. |
Jackie |
| Receivers |
array<object> |
Não |
A lista de destinatários. O número de destinatários não pode exceder 100. Especifique este parâmetro ou ReceiversName. Se tanto Receivers quanto ReceiversName forem especificados, ReceiversName terá precedência. Exemplo: [{"To":["Jackie@example.com"],"TemplateData":{"UserName":"Jackie"}},{"To":["Tom@example.com"],"TemplateData":{"UserName":"Tom"}}]. |
|
|
array<object> |
Não |
Os detalhes de um destinatário personalizado. |
||
| To |
array |
Não |
A lista de destinatários. Este parâmetro é do tipo array. |
|
|
string |
Não |
O endereço de e-mail. |
Jackie@example.com |
|
| TemplateData |
object |
Não |
Os parâmetros do modelo de e-mail. Este parâmetro é do tipo mapa JSON. |
|
|
string |
Não |
key-value 字符串 |
{"UserName": "Jackie"} |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| EnvId |
string |
O ID do evento. |
xxx |
| RequestId |
string |
O ID da solicitação. |
12D086F6-8F31-4658-84C1-006DED011A85 |
Exemplos
Resposta de sucesso
JSON formato
{
"EnvId": "xxx",
"RequestId": "12D086F6-8F31-4658-84C1-006DED011A85"
}
Códigos de erro
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.