Migrar SMS da Bird Connectivity Platform

Passe isso para o seu agente

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.

Mapeie a chamada de envio

• O array de destinatários se torna uma chamada por destinatário. Uma chamada da Connectivity Platform com 50 destinatários se torna 50 envios, ou um lote de mensagens independentes. O lote não é um fan-out de um único corpo: cada entrada carrega seu próprio destinatário, remetente e texto.
• datacoding não tem equivalente, e isso é intencional. Bird detecta a codificação a partir do corpo e reporta a contagem de segmentos na mensagem. Se você configurar datacoding: auto para manter as mensagens dentro de GSM-7, o comportamento mais próximo é options.smart_encoding, que aplica a tabela de substituição documentada de Bird. Não é um transliterador genérico; caracteres não suportados ainda podem exigir codificação Unicode.
• reference se divide em dois campos. Coloque um identificador interno em metadata, que é ecoado em cada evento de webhook, e use tags para os rótulos de baixa cardinalidade pelos quais você quer filtrar e segmentar analytics.
• Mensagens flash, payloads binários e concatenação UDH não são portados. Se você depende de mclass ou typeDetails hoje, levante isso com o suporte antes de planejar a virada, não depois.
• Também usa o Verify API da Connectivity Platform? A portabilidade é um trabalho separado com seu próprio guia: veja Migrar Verify de outro provedor.

Transfira os opt-outs

Traduza os relatórios de status

• Posts JSON assinados substituem callbacks GET de reportUrl. Os relatórios de status chegavam como requisições GET com o resultado na query string (status, statusReason, statusErrorCode, mccmnc, price[amount]). Bird POST um evento JSON para endpoints que seu espaço de trabalho registra, assinados conforme Standard Webhooks. O handler é uma reescrita, não uma troca de URL.
• A correlação não depende mais de reference. Um relatório de status só era útil se você tivesse definido uma referência; um evento Bird sempre carrega sms_id, ambos os números e seus metadata e tags ecoados.
• A semântica de retentativa é diferente. A Connectivity Platform retentava um relatório com falha até 10 vezes. As entregas de Bird são at-least-once e sem ordem, então desduplique pelo header webhook-id e ordene pelo timestamp do payload.
• Reconcilie custos pelo proprietário da mensagem e do billing. O relatório da Connectivity Platform trazia price[amount] e price[currency]. Leia o custo registrado da mensagem com GET /v1/sms/messages/{id} e reconcilie cobranças com o billing. A Stats API serve para métricas de entrega, não como um total de faturamento autoritativo.

Virada

Próximos passos

• Explore Bird SMS: fluxos de produto e caminhos de implementação
• Enviando SMS: o payload para o qual você está migrando, na íntegra
• Opt-outs e palavras-chave: o que Bird responde por você e como gerenciar supressões
• Eventos SMS: o vocabulário de eventos para o qual seu handler de status migra
• Webhooks & eventos: configuração de endpoint e verificação Standard Webhooks