Todos los productos
Search
Centro de documentos

:BatchSendMail

Última actualización: Sep 03, 2026

Llame a la operación BatchSendMail para enviar correos electrónicos por lotes.

Prueba

Ejecute esta operación directamente en OpenAPI Explorer. Esto elimina la necesidad de calcular firmas. Después de una llamada exitosa, OpenAPI Explorer genera automáticamente ejemplos de código SDK.

Parámetros de solicitud

Nombre

Tipo

Obligatorio

Ejemplo

Descripción

AccountName

String

Sí

test@example.com

La dirección del remitente configurada en la consola.

AddressType

Integer

Sí

1

  • 0: Cuenta aleatoria

  • 1: Dirección del remitente

ReceiversName

String

Sí

test2

El nombre de una lista de destinatarios creada previamente con destinatarios cargados. Nota: Para evitar fallos en el envío, espere como mínimo 10 minutos después de que se active la tarea antes de eliminar la lista de destinatarios.

TemplateName

String

Sí

test1

El nombre de una plantilla creada y aprobada previamente.

Action

String

No

BatchSendMail

Un parámetro obligatorio. Establezca el valor en BatchSendMail.

ClickTrace

String

No

0

  • 1: Habilita el seguimiento de datos.

  • 0 (predeterminado): Deshabilita el seguimiento de datos.

TagName

String

No

test3

El nombre de la etiqueta del correo electrónico.

ReplyAddress

String

No

test2***@example.net

La dirección de respuesta.

ReplyAddressAlias

String

No

Alice

El alias para la dirección de respuesta.

UnSubscribeLinkType

String

No

default

Especifica el tipo de enlace de cancelación de suscripción que se generará. Para obtener más información, consulte el documento Unsubscribe feature instructions.

  • Disabled: La generación está deshabilitada.

  • default: Utiliza la política predeterminada. Se genera un enlace de cancelación de suscripción cuando envía correos electrónicos desde una dirección de remitente por lotes a dominios específicos, como dominios que contienen palabras clave como "gmail", "yahoo",

"google", "aol.com", "hotmail",

"outlook" o "ymail.com".

  • Generado para instrumentación futura.

  • en-us: Genera un enlace. Esto está reservado para la instrumentación de contenido futuro.

UnSubscribeFilterLevel

String

No

mailfrom_domain

Nivel de filtro. Para obtener más información, consulte Unsubscribe Feature Help.

  • disabled: Sin filtrado.

  • default: Utiliza la política predeterminada. Las direcciones de remitente por lotes se filtran por dirección de remitente.

  • mailfrom: Filtra por dirección de remitente.

  • mailfrom_domain: Filtra por dominio de correo electrónico.

  • edm_id: Filtra por cuenta.

Parámetros de respuesta

Nombre

Tipo

Ejemplo

Descripción

EnvId

String

xxx

El ID del evento.

RequestId

String

12D086F6-8F31-4658-84C1-006DED011A85

El ID de la solicitud.

Ejemplos

Ejemplo de solicitud

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

Ejemplos de respuesta exitosa

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 error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

400

InvalidMailAddressName.Malformed

The specified MailAddress name is wrongly formed.

La dirección del remitente tiene un formato no válido. La dirección debe contener un signo de arroba (@). El nombre de dominio puede contener dígitos, letras, guiones bajos (_), guiones (-) y puntos (.). El nombre de la cuenta puede contener dígitos, letras, guiones bajos (_), guiones (-) y puntos (.).

400

InvalidReceiverName.Malformed

The specified receiver name is wrongly formed.

La dirección del destinatario tiene un formato no válido. La dirección debe contener un signo de arroba (@). El nombre de dominio puede contener dígitos, letras, guiones bajos (_), guiones (-) y puntos (.). El nombre de la cuenta puede contener dígitos, letras, guiones bajos (_), guiones (-) y puntos (.).

400

InvalidTemplateName.Malformed

The specified template name is wrongly formed.

El nombre de la plantilla tiene un formato no válido. El nombre de la plantilla no puede exceder los 30 caracteres de longitud.

404

InvalidMailAddress.NotFound

The specified mailAddress does not exist.

La dirección de remitente especificada no existe. Compruebe la dirección del remitente.

404

InvalidTemplate.NotFound

The specified template does not exist.

La plantilla especificada no existe.

404

InvalidReceiver.NotFound

The specified receiver does not exist.

El destinatario no existe. Compruebe si el destinatario existe.

400

InvalidSendMail.Spam

Sendmail rejected by spam filter.

Se denegó el envío del correo electrónico. Compruebe el estado del usuario para detectar problemas como límite de frecuencia excedido o cuota insuficiente.

400

InvalidMailAddressSendType.Malformed

The specified mailAddress sendType is wrongly formed.

El tipo de envío no es válido. Vaya a la consola para comprobar el tipo y establezca el valor correspondiente.

400

InvalidMailAddressStatus.Malformed

The specified mailAddress status is wrongly formed.

La dirección del remitente tiene un estado no válido. Compruebe si la dirección está activa o congelada.

400

InvalidMailAddressDomain.Malformed

The specified mailAddress domain does not exist.

El nombre de dominio tiene un formato no válido. Utilice dígitos, letras, guiones bajos (_), guiones (-) y puntos (.).

400

InvalidTemplateStatus.Malformed

The specified template status is wrongly formed.

La plantilla tiene un estado no válido. Compruebe si la plantilla está aprobada.

400

InvalidReceiverStatus.Malformed

The specified receivers status is wrongly formed.

El estado del destinatario no es válido. Vaya a la consola para comprobar si se cargaron los destinatarios.

400

InvalidReplyAddressAlias.Malformed

The specified replyAddressAlias is wrongly formed.

El alias de la dirección de respuesta tiene un formato no válido. El alias no puede exceder los 15 caracteres de longitud.

400

InvalidReplyAddress.Malformed

The specified replyAddress is wrongly formed.

La dirección de respuesta tiene un formato no válido. La dirección debe contener un signo de arroba (@). El nombre de dominio puede contener dígitos, letras, guiones bajos (_), guiones (-) y puntos (.). El nombre de la cuenta puede contener dígitos, letras, guiones bajos (_), guiones (-) y puntos (.).

Para consultar una lista de otros códigos de error, visite el Centro de errores.