Un negozio può notificare molti clienti dello stesso evento personalizzando ogni testo. Ogni destinatario ha comunque bisogno del permesso e di un percorso di consegna valido.
Cosa cambia quando invio a molti destinatari?
Coordini molti invii indipendenti invece di trattare una singola richiesta come l'intera campagna.
Ogni destinatario può avere una destinazione diversa, un requisito del mittente diverso o uno stato di consenso diverso. Una consegna riuscita a una persona non dice nulla del telefono di un'altra.
La personalizzazione cambia anche il testo effettivo. Un nome più lungo o un emoji possono modificare la codifica e il conteggio dei segmenti. Conta i corpi completati quando stimi il volume fatturabile.
Devo usare un broadcast o i batch API?
Usa un broadcast per coordinare una campagna attorno a un'audience, contenuti condivisi e una pianificazione di invio. Usa i batch per inviare messaggi indipendenti dalla tua applicazione.
Il workflow campagna SMS collega preparazione dell'audience, personalizzazione, revisione del lancio ed esiti per destinatario. L'endpoint batch offre un'operazione più ristretta: accettare richieste individuali insieme.
Un identificatore di batch non sostituisce la gestione della campagna, i record di consenso o una pianificazione.
Come accetta un batch Bird?
Invii da 1 a 100 messaggi indipendenti tramite POST /v1/sms/batches.
Inserisci ogni oggetto messaggio nell'array messages. Una campagna con 250 destinatari richiede almeno tre richieste, perché ogni batch contiene al massimo 100 elementi.
Bird valida ogni elemento prima di accodarne qualsiasi. Un messaggio non valido fa fallire l'intera richiesta con 422. Correggi l'elemento non valido prima di reinviare il batch.
In caso di successo, data contiene i messaggi accettati nell'ordine di invio. summary.accepted_count riporta il conteggio dei messaggi accettati. Il riferimento batch documenta quella risposta.
Mantieni ogni identificatore di messaggio restituito associato al suo destinatario. Gli eventi di consegna successivi appartengono a quei singoli messaggi, non a un esito di batch condiviso.
Un batch accettato significa che tutti hanno ricevuto il testo?
Una risposta 202 significa che Bird ha accettato i messaggi per l'elaborazione.
Addebito, invio al carrier e consegna avvengono dopo. Un messaggio accettato può fallire mentre altri raggiungono i destinatari. Aggiorna la campagna in base agli eventi di consegna di ogni messaggio.
Non reinviare un intero batch accettato perché un destinatario ha fallito. Indaga sull'errore di quel messaggio. Valuta se un tentativo separato è appropriato.
Come stimo il tempo di invio?
Stima ogni destinazione separatamente usando i limiti e la capacità che si applicano al suo percorso di invio.
Un limite di richieste API controlla la velocità con cui invii il lavoro. Il throughput di consegna controlla una fase successiva. Aumentare la concorrenza di invio non può rimuovere il limite di un carrier.
Controlla l'unità di misura prima di calcolare la capacità. Un limite basato sui segmenti conta un testo multipart più di una volta. Un limite basato sulle richieste conta invece la chiamata batch.
Bird assegna le richieste batch a sms_batch, separatamente dagli invii singoli sotto sms_send. La guida alla limitazione delle richieste spiega quelle policy di richieste. Il throughput SMS spiega la questione separata della consegna.
Cosa devo controllare prima di rilasciare la campagna?
Controlla consenso, idoneità del mittente e il messaggio completato per ogni destinatario.
Usa lo stato di opt-out più recente quando rilasci lavoro in coda. Una lista esportata in precedenza può includere qualcuno che nel frattempo ha revocato il permesso.
Controlla i requisiti del mittente della destinazione prima di inserire i suoi destinatari in un batch. Un elemento non valido può altrimenti far rifiutare un batch che contiene molti messaggi validi.
Inizia con un gruppo limitato. Esamina gli esiti restituiti prima di ampliare l'invio. Questo rende più facile individuare un mittente o un messaggio errato prima che raggiunga l'intera lista.
- Applica le regole della destinazione e il permesso di ogni destinatario.
- Valida i corpi completati.
- Conta i loro segmenti.
- Invia i batch entro i limiti di richieste.
- Monitora gli esiti di consegna per messaggio. Indaga ogni fallimento separatamente.
In breve
Ogni destinatario ha comunque un messaggio indipendente.
L'accettazione del batch non fa condividere a tutti i destinatari un unico esito di consegna.
Un batch Bird contiene al massimo 100 messaggi.
Usa i batch per invii API indipendenti. Un broadcast verso un'audience gestisce il workflow coordinato della campagna.
La validazione si applica all'intero batch.
Un singolo elemento non valido fa sì che Bird rifiuti la richiesta prima che qualsiasi elemento venga accodato.
Consenso e idoneità del mittente restano controlli individuali.
Ricontrolla i permessi e i requisiti di destinazione quando rilasci ogni parte di una campagna.