Ein Shop kann viele Kunden über dasselbe Ereignis benachrichtigen und dabei jeden Text personalisieren. Jeder Empfänger braucht weiterhin eine Berechtigung und einen gültigen Zustellweg.
Was ändert sich, wenn ich an viele Empfänger sende?
Sie koordinieren viele unabhängige Sendungen, statt einen einzelnen Request als die gesamte Kampagne zu behandeln.
Jeder Empfänger kann ein anderes Ziel, andere Absenderanforderungen oder einen anderen Einwilligungsstatus haben. Eine erfolgreiche Zustellung an eine Person sagt nichts über das Telefon einer anderen Person aus.
Personalisierung verändert auch den eigentlichen Text. Ein längerer Name oder ein Emoji kann die Kodierung und die Segmentanzahl ändern. Zählen Sie die fertigen Nachrichtentexte, wenn Sie das abrechenbare Volumen schätzen.
Sollte ich einen Broadcast oder API-Batches verwenden?
Verwenden Sie einen Broadcast, um eine Kampagne rund um eine Audience, gemeinsame Inhalte und einen Sendezeitplan zu koordinieren. Verwenden Sie Batches, um unabhängige Nachrichten aus Ihrer Anwendung einzureichen.
Der SMS-Kampagnen-Workflow verbindet Audience-Vorbereitung, Personalisierung, Freigabeprüfung und Empfängerergebnisse. Der Batch-Endpoint bietet eine engere Operation: einzelne Requests gemeinsam annehmen.
Eine Batch-ID ersetzt weder Kampagnen-Ownership noch Einwilligungsdaten oder einen Zeitplan.
Wie nimmt Bird einen Batch an?
Sie übermitteln zwischen 1 und 100 unabhängige Nachrichten über POST /v1/sms/batches.
Legen Sie jedes Nachrichtenobjekt in das messages-Array. Eine Kampagne mit 250 Empfängern benötigt mindestens drei Requests, da jeder Batch höchstens 100 Einträge enthält.
Bird validiert jeden Eintrag, bevor einer in die Warteschlange gestellt wird. Eine ungültige Nachricht lässt den gesamten Request mit 422 fehlschlagen. Korrigieren Sie den ungültigen Eintrag, bevor Sie den Batch erneut absenden.
Bei Erfolg enthält data die angenommenen Nachrichten in Einreichungsreihenfolge. summary.accepted_count gibt die Anzahl der angenommenen Nachrichten an. Die Batch-Referenz dokumentiert diese Antwort.
Verknüpfen Sie jede zurückgegebene Nachrichten-ID mit ihrem Empfänger. Spätere Zustell-Events gehören zu diesen einzelnen Nachrichten, nicht zu einem gemeinsamen Batch-Ergebnis.
Bedeutet ein erfolgreicher Batch, dass alle den Text erhalten haben?
Eine 202-Antwort bedeutet, dass Bird die Nachrichten zur Verarbeitung angenommen hat.
Abrechnung, Carrier-Übermittlung und Zustellung erfolgen danach. Eine angenommene Nachricht kann fehlschlagen, während andere ihre Empfänger erreichen. Aktualisieren Sie die Kampagne anhand der Zustell-Events jeder Nachricht.
Senden Sie nicht einen gesamten angenommenen Batch erneut, weil ein Empfänger fehlgeschlagen ist. Untersuchen Sie den Fehler dieser Nachricht. Entscheiden Sie, ob ein separater Versuch angemessen ist.
Wie sollte ich die Sendezeit schätzen?
Schätzen Sie jedes Ziel separat anhand der Limits und der Kapazität, die für seinen Sendeweg gelten.
Ein API-Request-Limit steuert, wie schnell Sie Arbeit einreichen. Der Zustelldurchsatz steuert eine spätere Stufe. Höhere Einreichungsparallelität kann ein Carrier-Limit nicht aufheben.
Prüfen Sie die Einheit, bevor Sie die Kapazität berechnen. Ein segmentbasiertes Limit zählt einen mehrteiligen Text mehrfach. Ein requestbasiertes Limit zählt stattdessen den Batch-Aufruf.
Bird ordnet Batch-Requests sms_batch zu, getrennt von Einzelsendungen unter sms_send. Der Leitfaden zur Begrenzung der Anfragerate erklärt diese Request-Richtlinien. SMS-Durchsatz erklärt die separate Zustellfrage.
Was sollte ich vor der Freigabe der Kampagne prüfen?
Prüfen Sie Einwilligung, Absenderberechtigung und die fertige Nachricht für jeden Empfänger.
Verwenden Sie den aktuellen Opt-out-Status, wenn Sie wartende Arbeit freigeben. Eine früher exportierte Liste kann jemanden enthalten, der inzwischen seine Berechtigung widerrufen hat.
Prüfen Sie die Absenderanforderungen des Ziels, bevor Sie dessen Empfänger in einen Batch aufnehmen. Ein ungültiger Eintrag kann sonst einen Batch mit vielen gültigen Nachrichten ablehnen.
Beginnen Sie mit einer begrenzten Gruppe. Prüfen Sie die zurückgegebenen Ergebnisse, bevor Sie den Versand ausweiten. So lassen sich ein fehlerhafter Absender oder eine fehlerhafte Nachricht leichter erkennen, bevor sie die gesamte Liste erreichen.
- Wenden Sie die Regeln des Ziels und die Berechtigung jedes Empfängers an.
- Validieren Sie die fertigen Nachrichtentexte.
- Zählen Sie deren Segmente.
- Reichen Sie Batches innerhalb der Request-Limits ein.
- Verfolgen Sie Zustellergebnisse pro Nachricht. Untersuchen Sie jeden Fehler separat.
Kurz gesagt
Jeder Empfänger hat weiterhin eine unabhängige Nachricht.
Die Annahme eines Batches bedeutet nicht, dass alle Empfänger ein gemeinsames Zustellergebnis teilen.
Ein Bird-Batch enthält höchstens 100 Nachrichten.
Verwenden Sie Batches für unabhängige API-Sendungen. Ein Audience-Broadcast steuert den koordinierten Kampagnen-Workflow.
Die Validierung gilt für den gesamten Batch.
Ein ungültiger Eintrag führt dazu, dass Bird den Request ablehnt, bevor ein Eintrag in die Warteschlange gestellt wird.
Einwilligung und Absenderberechtigung bleiben individuelle Prüfungen.
Prüfen Sie Berechtigung und Zielanforderungen erneut, wenn Sie jeden Teil einer Kampagne freigeben.