Een winkel kan veel klanten informeren over dezelfde gebeurtenis en tegelijkertijd elke tekst personaliseren. Elke ontvanger heeft nog steeds toestemming en een geldig afleverpad nodig.
Wat verandert er als ik naar veel ontvangers verstuur?
Je coördineert veel onafhankelijke verzendingen in plaats van één request als de volledige campagne te behandelen.
Elke ontvanger kan een andere bestemming, afzendervereiste of toestemmingsstatus hebben. Een geslaagde aflevering aan één persoon zegt niets over de telefoon van een andere persoon.
Personalisatie verandert ook de daadwerkelijke tekst. Een langere naam of een emoji kan de codering en het aantal segmenten veranderen. Tel de voltooide berichten bij het inschatten van het factureerbare volume.
Moet ik een broadcast of API-batches gebruiken?
Gebruik een broadcast om een campagne te coördineren rond een doelgroep, gedeelde content en een verzendschema. Gebruik batches om onafhankelijke berichten vanuit je applicatie te versturen.
De SMS-campagneworkflow verbindt doelgroepvoorbereiding, personalisatie, lanceringsbeoordeling en ontvangerresultaten. Het batch-endpoint biedt een beperktere operatie: individuele requests samen accepteren.
Een batch-identifier vervangt geen campagne-eigenaarschap, toestemmingsregistraties of een schema.
Hoe accepteert Bird een batch?
Je verstuurt tussen de 1 en 100 onafhankelijke berichten via POST /v1/sms/batches.
Plaats elk berichtobject in de messages-array. Een campagne met 250 ontvangers vereist minstens drie requests, omdat elke batch maximaal 100 items bevat.
Bird valideert elk item voordat er iets in de wachtrij wordt geplaatst. Eén ongeldig bericht laat het hele request falen met 422. Herstel het ongeldige item voordat je de batch opnieuw verstuurt.
Bij succes bevat data de geaccepteerde berichten in verzendvolgorde. summary.accepted_count rapporteert het geaccepteerde aantal. De batchreferentie documenteert dat antwoord.
Koppel elke geretourneerde berichtidentifier aan de bijbehorende ontvanger. Latere aflevergebeurtenissen horen bij die individuele berichten, niet bij één gedeeld batchresultaat.
Betekent een geslaagde batch dat iedereen de tekst heeft ontvangen?
Een 202-antwoord betekent dat Bird de berichten heeft geaccepteerd voor verwerking.
Facturering, aanbieding bij de carrier en aflevering vinden daarna plaats. Eén geaccepteerd bericht kan falen terwijl andere hun ontvangers bereiken. Werk de campagne bij op basis van de aflevergebeurtenissen van elk bericht.
Verstuur niet een hele geaccepteerde batch opnieuw omdat één ontvanger is mislukt. Onderzoek de fout van dat bericht. Bepaal of een aparte poging gepast is.
Hoe schat ik de verzendtijd in?
Schat elke bestemming afzonderlijk in op basis van de limieten en capaciteit die gelden voor het verzendpad.
Een API-requestlimiet bepaalt hoe snel je werk kunt indienen. Afleverdoorvoer bepaalt een latere fase. Het verhogen van de indieningsconcurrency kan een carrierlimiet niet wegnemen.
Controleer de eenheid voordat je capaciteit berekent. Een segmentgebaseerde limiet telt een meerdelig bericht meer dan één keer. Een requestgebaseerde limiet telt in plaats daarvan de batchaanroep.
Bird wijst batchrequests toe aan sms_batch, apart van enkelvoudige verzendingen onder sms_send. De handleiding voor beperking van het aantal verzoeken legt die requestregels uit. SMS-doorvoer behandelt de afzonderlijke afleverkwestie.
Wat moet ik controleren voordat ik de campagne vrijgeef?
Controleer toestemming, afzendergeschiktheid en het voltooide bericht voor elke ontvanger.
Gebruik recente opt-outstatus bij het vrijgeven van werk in de wachtrij. Een eerder geëxporteerde lijst kan iemand bevatten die inmiddels toestemming heeft ingetrokken.
Controleer de afzendervereisten van de bestemming voordat je de ontvangers in een batch plaatst. Eén ongeldig item kan anders een batch met veel geldige berichten laten afwijzen.
Begin met een beperkte groep. Bekijk de geretourneerde resultaten voordat je de verzending uitbreidt. Zo is een verkeerde afzender of een fout bericht makkelijker te ontdekken voordat het de hele lijst bereikt.
- Pas de regels van de bestemming en de toestemming van elke ontvanger toe.
- Valideer voltooide berichten.
- Tel hun segmenten.
- Verstuur batches binnen de requestlimieten.
- Volg afleverresultaten per bericht. Onderzoek elke fout afzonderlijk.
Kort gezegd
Elke ontvanger heeft nog steeds een onafhankelijk bericht.
Acceptatie van een batch betekent niet dat alle ontvangers één afleverresultaat delen.
Een Bird-batch bevat maximaal 100 berichten.
Gebruik batches voor onafhankelijke API-verzendingen. Een doelgroepbroadcast beheert de gecoördineerde campagneworkflow.
Validatie geldt voor de hele batch.
Eén ongeldig item zorgt ervoor dat Bird het request afwijst voordat enig item in de wachtrij wordt geplaatst.
Toestemming en afzendergeschiktheid blijven individuele controles.
Controleer toestemming en bestemmingsvereisten opnieuw bij het vrijgeven van elk deel van een campagne.