Skip to main content
/secure/sendbatch encola muchos mensajes en una sola llamada.
Cada elemento toma los mismos campos que un envío único. El to de un mensaje puede ser a su vez un array, que se multiplica.

La respuesta confirma solo la aceptación

No hay ids por mensaje en esta respuesta, ni resultados por mensaje. messageCount es a cuántos se expandió el lote, no cuántos tuvieron éxito.Los resultados por mensaje llegan a su URL de errback como callbacks separados. Un cliente que trate un 200 aquí como “los tres enviados” se equivoca exactamente en los casos que interesa conocer.

Valores por defecto y configuración

globals se fusiona bajo cada mensaje, así que un campo fijado en un mensaje individual gana.
Las claves desconocidas en batch_config se ignoran, no se rechazan. Un tecleo erróneo en errback_url le cuesta cada resultado por mensaje, silenciosamente. El lote se acepta y los callbacks simplemente no llegan.Este es el único lugar de la API donde un campo mal escrito no produce un 400, así que compruébelo enviando un mensaje que fallará deliberadamente y confirmando que el callback llega.

Programación

schedule_at toma exactamente dos formas: Cualquier otra cosa es 412 Got unknown format. Una fecha en el pasado también se rechaza, en lugar de enviarse inmediatamente.
Los lotes programados sobreviven a un reinicio solo cuando la pasarela se ejecuta con un broker RabbitMQ. Y ni siquiera entonces cuando la conexión con el broker está degradada. Si la programación durable le importa, pregunte a su proveedor qué proveedor de colas ejecuta y si alerta ante amqp.bridge.degraded.

Límites

Los destinos con valor de array multiplican: 100 mensajes con 200 destinatarios cada uno son 20 000, y se rechazan.

Ritmo

Los lotes se ritman contra la profundidad de la cola del router, pausándose por encima de una marca alta. No necesita ritmar usted mismo el envío de un lote. Pero sí necesita seguir respetando el límite de mensajes por segundo de su cuenta en los envíos ordinarios, que es un techo aparte y devuelve 429.

Relacionado

Enviar un lote

Todos los campos, con los rechazos.

Callbacks de lote

Qué llega a callback_url y errback_url.