SMS von der Bird Connectivity Platform migrieren

Übergeben Sie dies an Ihren Agent

Help me migrate my SMS integration from Bird Connectivity Platform to Bird.
1. Inspect this repository's sends, senders, callbacks, schedules, templates, opt-outs and tests. List the traffic and behavior that must survive the migration.
2. Read the Markdown guides at https://bird.com/docs/guides/sms/migrate/connectivity-platform.md and https://bird.com/docs/guides/sms/migrate.md. Use an existing authenticated Bird MCP or CLI connection. If neither is available, follow https://bird.com/docs/ai/set-up-your-agent.md. Discover the actual operations; do not invent commands or ask me to paste credentials into chat.
3. Prepare the code changes, sender/destination requirements, consent migration, webhook verification and rollout/rollback plan. Preserve the scope of each customer's preferences, including requests outside SMS replies. Separate API batches from audience broadcasts and preserve any behavior that has no direct endpoint equivalent.
4. Show me the exact affected resources, destinations, test volume and known costs before an action that sends messages, spends money, registers or changes a sender, or moves production traffic. Require explicit human authorization for each paid submission or production change. Name one-off 10DLC registration and resubmission fees before requesting approval. An existing explicit approval for that exact action is sufficient; broad migration approval is not. Simulated SMS destinations are billable and still require authorization.
5. If I am keeping Connectivity Platform numbers, prepare the human support port request and obtain authorization to send it. Read bird support-tickets create --help, then use the available CLI or MCP support operation with the reviewed number list and requirements. Return the ticket ID and follow the reply; support arranges the port on its own schedule, separately from the code cutover.
6. Run local and intercepted tests first. When authorized, perform the agreed bounded integration tests, inspect accepted and final outcomes separately, and report failures or uncertainty. Do not claim a delivery receipt proves reading or that request idempotency guarantees exactly-once delivery.
7. Keep production cutover and retiring the old provider as explicit steps in the approved rollout. Finish with the diff, evidence, unresolved requirements and the next action.

Den Sendeaufruf abbilden

• Das Empfänger-Array wird zu einem Aufruf pro Empfänger. Ein Connectivity-Platform-Aufruf mit 50 Empfängern wird zu 50 Sendevorgängen oder einem Batch unabhängiger Nachrichten. Der Batch ist kein Fan-out eines einzelnen Inhalts: Jeder Eintrag enthält seinen eigenen Empfänger, Absender und Text.
• datacoding hat kein Äquivalent, und das ist beabsichtigt. Bird erkennt die Kodierung anhand des Inhalts und gibt die Segmentanzahl zur Nachricht zurück. Wenn Sie datacoding: auto setzen, um Nachrichten innerhalb von GSM-7 zu halten, ist das nächstliegende Verhalten options.smart_encoding, das die dokumentierte Ersetzungstabelle von Bird anwendet. Es handelt sich nicht um einen allgemeinen Transliterator; nicht unterstützte Zeichen können weiterhin Unicode-Kodierung erfordern.
• reference wird in zwei Felder aufgeteilt. Geben Sie einen internen Bezeichner in metadata an, der bei jedem Webhook-Ereignis zurückgegeben wird, und verwenden Sie tags für die Labels mit niedriger Kardinalität, nach denen Sie filtern und Analysen aufschlüsseln möchten.
• Flash-Nachrichten, binäre Payloads und UDH-Verkettung lassen sich nicht portieren. Wenn Sie auf mclass oder typeDetails angewiesen sind, klären Sie das mit dem Support, bevor Sie die Umstellung planen, nicht danach.
• Nutzen Sie auch die Connectivity Platform Verify API? Die Portierung ist ein separates Vorhaben mit eigener Anleitung: siehe Verify von einem anderen Anbieter migrieren.

Opt-outs übernehmen

Statusberichte übersetzen

• Signierte JSON-Posts ersetzen reportUrl-GET-Callbacks. Statusberichte kamen als GET-Anfragen mit dem Ergebnis im Query-String (status, statusReason, statusErrorCode, mccmnc, price[amount]). Bird POSTt ein JSON-Ereignis an Endpunkte, die Ihr Workspace registriert, signiert gemäß Standard Webhooks. Der Handler muss neu geschrieben werden, nicht nur die URL geändert.
• Korrelation hängt nicht mehr von reference ab. Ein Statusbericht war nur nützlich, wenn Sie eine Referenz gesetzt hatten; ein Bird-Ereignis enthält immer sms_id, beide Nummern sowie Ihr zurückgegebenes metadata und tags.
• Die Wiederholungssemantik unterscheidet sich. Die Connectivity Platform hat einen fehlgeschlagenen Bericht bis zu 10-mal erneut versucht. Die Zustellungen von Bird erfolgen mindestens einmal und ohne feste Reihenfolge. Deduplizieren Sie daher anhand des webhook-id-Headers und sortieren Sie nach dem timestamp im Payload.
• Kosten über die Nachricht und den Billing-Owner abgleichen. Der Connectivity-Platform-Bericht enthielt price[amount] und price[currency]. Lesen Sie die erfassten Kosten der Nachricht mit GET /v1/sms/messages/{id} aus und gleichen Sie die Gebühren mit dem Billing ab. Die Stats API dient Zustellmetriken, nicht als verbindliche Abrechnungssumme.

Umstellung durchführen

Nächste Schritte

• Bird SMS entdecken: Produkt-Workflows und Implementierungspfade
• SMS senden: das Payload, auf das Sie portieren, vollständig
• Opt-outs und Schlüsselwörter: was Bird für Sie übernimmt und wie Sie Unterdrückungen verwalten
• SMS-Ereignisse: das Ereignisvokabular, auf das Ihr Status-Handler wechselt
• Webhooks & Events: Endpunkt-Einrichtung und Standard-Webhooks-Verifizierung