Migracja SMS z Bird Connectivity Platform

Przekaż to swojemu agentowi

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.

Zmapuj wywołanie wysyłki

• Tablica odbiorców zamienia się w jedno wywołanie na odbiorcę. Wywołanie Connectivity Platform z 50 odbiorcami staje się 50 wysyłkami lub jedną partią niezależnych wiadomości. Partia nie jest rozgałęzieniem jednej treści: każdy wpis zawiera własnego odbiorcę, nadawcę i tekst.
• datacoding nie ma odpowiednika i jest to celowe. Bird wykrywa kodowanie na podstawie treści i raportuje liczbę segmentów w wiadomości. Jeśli ustawisz datacoding: auto, aby wiadomości mieściły się w GSM-7, najbliższym odpowiednikiem jest options.smart_encoding, który stosuje udokumentowaną tabelę zamienników Bird. Nie jest to transliterator ogólnego przeznaczenia; nieobsługiwane znaki nadal mogą wymagać kodowania Unicode.
• reference dzieli się na dwa pola. Umieść wewnętrzny identyfikator w metadata, który jest zwracany w każdym zdarzeniu webhooka, a tags używaj do etykiet o niskiej kardynalności, po których chcesz filtrować i segmentować analitykę.
• Wiadomości flash, dane binarne i konkatenacja UDH nie podlegają migracji. Jeśli korzystasz z mclass lub typeDetails, zgłoś to do wsparcia przed planowaniem przełączenia, a nie po.
• Korzystasz też z Connectivity Platform Verify API? Przeniesienie to osobne zadanie z własnym przewodnikiem: zobacz Migracja Verify od innego dostawcy.

Przenieś rezygnacje z subskrypcji

Przetłumacz raporty statusu

• Podpisane posty JSON zastępują callbacki GET reportUrl. Raporty statusu docierały jako żądania GET z wynikiem w query stringu (status, statusReason, statusErrorCode, mccmnc, price[amount]). Bird wysyła (POST) zdarzenie JSON do endpointów zarejestrowanych w Twoim obszarze roboczym, podpisane zgodnie ze Standard Webhooks. Handler wymaga przepisania, a nie tylko zmiany URL-a.
• Korelacja nie zależy już od reference. Raport statusu był użyteczny tylko wtedy, gdy ustawiłeś referencję; zdarzenie Bird zawsze zawiera sms_id, oba numery oraz Twoje zwrócone metadata i tags.
• Semantyka ponawiania jest inna. Connectivity Platform ponawiał nieudany raport do 10 razy. Dostarczenia Bird działają w trybie at-least-once i bez gwarancji kolejności, więc deduplikuj po nagłówku webhook-id i sortuj po timestamp z payloadu.
• Uzgadniaj koszty przez wiadomość i właścicieli rozliczeń. Raport Connectivity Platform zawierał price[amount] i price[currency]. Odczytaj zarejestrowany koszt wiadomości za pomocą GET /v1/sms/messages/{id} i uzgodnij opłaty z rozliczeniami. Stats API służy do metryk dostarczenia, a nie jako autorytatywne podsumowanie rozliczeń.

Przełączenie

Następne kroki

• Poznaj Bird SMS: przepływy produktowe i ścieżki implementacji
• Wysyłanie SMS: pełny payload, na który migrujesz
• Rezygnacje i słowa kluczowe: co Bird obsługuje za Ciebie i jak zarządzać blokadami
• Zdarzenia SMS: słownictwo zdarzeń, na które przenosi się Twój handler statusów
• Webhooki i zdarzenia: konfiguracja endpointów i weryfikacja Standard Webhooks