Skip to main content
/secure/sendbatch enfileira muitas mensagens em uma chamada.
Cada elemento aceita os mesmos campos que um envio único. O to de uma mensagem pode ser um array, o que multiplica.

A resposta confirma apenas aceitação

Não há ids por mensagem nesta resposta, nem resultados por mensagem. messageCount é para quantas o batch se expandiu, não quantas tiveram sucesso.Desfechos por mensagem chegam na sua errback URL como callbacks separados. Um cliente que trate um 200 aqui como “todas as três enviadas” está errado exatamente nos casos que valem conhecer.

Padrões e configuração

globals é mesclado por baixo de cada mensagem, então um campo definido em uma mensagem individual vence.
Chaves desconhecidas em batch_config são ignoradas, não recusadas. Um erro de digitação em errback_url custa a você cada resultado por mensagem, silenciosamente. O batch é aceito e os callbacks simplesmente não chegam.Este é o único lugar da API onde um campo mal escrito não produz um 400, então confira enviando uma mensagem deliberadamente fadada a falhar e conferindo que o callback chega.

Agendamento

schedule_at aceita exatamente duas formas: Qualquer outra coisa é 412 Got unknown format. Uma data no passado também é recusada, em vez de enviada imediatamente.
Batches agendados sobrevivem a um restart apenas quando o gateway roda com um broker RabbitMQ. E nem mesmo aí enquanto a conexão com o broker está degradada. Se agendamento durável importa para você, pergunte ao seu provedor qual provedor de fila ele roda e se ele alerta em amqp.bridge.degraded.

Limites

Destinos como array multiplicam: 100 mensagens, cada uma com 200 destinatários, dá 20 000, e é recusado.

Pacing

Os batches se ajustam sozinhos ao volume da fila do roteador, pausando acima de uma marca d’água. Você não precisa limitar sua própria submissão do batch. Mas ainda precisa respeitar o limite de mensagens por segundo da sua conta em envios comuns, que é um teto separado e retorna 429.

Relacionados

Enviar um batch

Cada campo, com as recusas.

Callbacks de batch

O que chega em callback_url e errback_url.