Uma loja pode notificar muitos clientes sobre o mesmo evento e ainda personalizar cada texto. Todo destinatário ainda precisa de permissão e de um caminho de entrega válido.
O que muda quando envio para muitos destinatários?
Você coordena muitos envios independentes em vez de tratar uma única requisição como a campanha completa.
Cada destinatário pode ter um destino, requisito de remetente ou estado de consentimento diferente. Uma entrega bem-sucedida para uma pessoa não diz nada sobre o telefone de outra.
A personalização também altera o texto real. Um nome mais longo ou um emoji pode mudar a codificação e a contagem de segmentos. Conte os corpos finalizados ao estimar o volume faturável.
Devo usar um broadcast ou lotes API?
Use um broadcast para coordenar uma campanha em torno de uma audiência, conteúdo compartilhado e um cronograma de envio. Use lotes para enviar mensagens independentes a partir da sua aplicação.
O fluxo de campanha SMS conecta preparação de audiência, personalização, revisão de lançamento e resultados por destinatário. O endpoint de lote oferece uma operação mais restrita: aceitar solicitações individuais em conjunto.
Um identificador de lote não substitui a propriedade da campanha, os registros de consentimento nem um cronograma.
Como Bird aceita um lote?
Você envia entre 1 e 100 mensagens independentes por meio de POST /v1/sms/batches.
Coloque cada objeto de mensagem no array messages. Uma campanha com 250 destinatários precisa de pelo menos três solicitações, porque cada lote comporta no máximo 100 itens.
Bird valida todos os itens antes de enfileirar qualquer um. Uma mensagem inválida faz a solicitação inteira falhar com 422. Corrija o item inválido antes de reenviar o lote.
Em caso de sucesso, data contém as mensagens aceitas na ordem de envio. summary.accepted_count informa a quantidade aceita. A referência de lote documenta essa resposta.
Mantenha cada identificador de mensagem retornado associado ao seu destinatário. Os eventos de entrega posteriores pertencem a essas mensagens individuais, não a um resultado compartilhado do lote.
Um lote bem-sucedido significa que todos receberam a mensagem?
Uma resposta 202 significa que Bird aceitou as mensagens para processamento.
Cobrança, envio à operadora e entrega acontecem depois. Uma mensagem aceita pode falhar enquanto outras chegam aos seus destinatários. Atualize a campanha a partir dos eventos de entrega de cada mensagem.
Não reenvie um lote aceito inteiro porque um destinatário falhou. Investigue o erro dessa mensagem. Decida se uma tentativa separada é apropriada.
Como devo estimar o tempo de envio?
Estime cada destino separadamente usando os limites e a capacidade que se aplicam ao seu caminho de envio.
Um limite de solicitações API controla a velocidade com que você envia trabalho. A taxa de entrega controla uma etapa posterior. Aumentar a concorrência de envio não pode remover o limite de uma operadora.
Verifique a unidade antes de calcular a capacidade. Um limite baseado em segmentos conta uma mensagem multipart mais de uma vez. Um limite baseado em solicitações conta a chamada de lote.
Bird atribui solicitações de lote a sms_batch, separadamente dos envios individuais em sms_send. O guia de limitação de requisições explica essas políticas de solicitação. Taxa de entrega SMS explica a questão separada de entrega.
O que devo verificar antes de lançar a campanha?
Verifique o consentimento, a elegibilidade do remetente e a mensagem completa para cada destinatário.
Use o estado de opt-out recente ao liberar trabalho enfileirado. Uma lista exportada anteriormente pode incluir alguém que já retirou a permissão.
Verifique os requisitos de remetente do destino antes de agrupar seus destinatários em lote. Um item inválido pode rejeitar um lote que contém muitas mensagens válidas.
Comece com um grupo limitado. Inspecione os resultados retornados antes de expandir o envio. Isso facilita identificar um remetente ou mensagem incorretos antes de alcançar a lista inteira.
- Aplique as regras do destino e a permissão de cada destinatário.
- Valide os corpos de mensagem completos.
- Conte os segmentos.
- Envie lotes dentro dos limites de solicitação.
- Acompanhe os resultados de entrega por mensagem. Investigue cada falha separadamente.
Em resumo
Cada destinatário ainda tem uma mensagem independente.
A aceitação do lote não faz com que todos os destinatários compartilhem um único resultado de entrega.
Um lote Bird contém no máximo 100 mensagens.
Use lotes para envios API independentes. Um broadcast de audiência gerencia o fluxo coordenado de campanha.
A validação se aplica ao lote inteiro.
Um item inválido faz Bird rejeitar a requisição antes que qualquer item seja enfileirado.
Consentimento e elegibilidade do remetente continuam sendo verificações individuais.
Verifique novamente a permissão e os requisitos de destino ao liberar cada parte de uma campanha.