Migrar SMS da Infobip

Passe isso para o seu agente

Help me migrate my SMS integration from Infobip 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/infobip.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 Infobip 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.

Mapear a chamada de envio

• Três níveis viram nenhum. O aninhamento existe para transportar muitas mensagens e muitos destinos em uma requisição. Ao enviar uma mensagem para uma pessoa, o Bird recebe os três campos no nível raiz, então o builder que monta os arrays é excluído em vez de traduzido.
• callbackData é maior que metadata. A Infobip aceita até 4.000 caracteres e os retorna no relatório de entrega. O metadata do Bird tem limite de 2 KB serializado e é ecoado em cada evento da mensagem, não apenas no terminal. O eco é a melhor parte; o limite não é, então qualquer coisa perto do limite precisa ser reduzida a uma chave que você possa consultar em vez de carregada inteira.
• campaignReferenceId é contexto de relatório, não uma migração de campanha. Os tags do Bird são pares {name, value} que se tornam dimensões de consulta, para que você possa fatiar analytics por campanha como fazia. O que não vem com eles é um objeto de campanha: uma tag não cria nem configura um broadcast. Avalie o fluxo de campanha separadamente ao migrar campanhas de audiência.
• campaignReferenceId não é uma chave de idempotência. A Infobip o define como um ID para rastrear o desempenho de uma campanha, então ele agrupa mas não deduplica. Se você dependia dele para tornar uma retentativa segura, não estava coberto; o header Idempotency-Key é o que faz isso aqui.
• Nada corresponde a category. As opções de mensagem da Infobip cobrem validade, janela de entrega, flash e configurações regionais, e nenhuma delas declara por que a mensagem está sendo enviada. Decida por tipo de mensagem se é transactional, marketing, authentication ou service.
• Dois campos de opção não têm destino. validityPeriod é reservado e responde a 422 SMSUnsupportedFeature; deliveryTimeWindow não tem equivalente, então janelas de agendamento passam para o seu próprio dispatcher.

Transportar opt-outs

Traduzir status de entrega

• Assinaturas substituem webhooks por mensagem. A Infobip nomeia um webhook em cada mensagem, então o destino é escolhido por quem escreve a chamada, e o tipo de conteúdo é escolhido junto. O Bird entrega JSON a endpoints que seu espaço de trabalho registra, cada um inscrito nos tipos de evento que deseja, então um segundo consumidor é uma segunda assinatura em vez de uma alteração em cada ponto de chamada.
• Você perde a escolha por mensagem, incluindo XML. A Infobip permite que uma mensagem escolha JSON ou XML e anexe até 4.000 caracteres de dados de callback. O Bird envia apenas JSON, e callbackData se torna metadata, que é ecoado em cada evento daquela mensagem em vez de apenas no relatório.
• Pull vira push. A Infobip permite que você busque relatórios em um endpoint de reports e também os receba. O Bird não tem polling equivalente para eventos; inscreva-se, e leia o estado da mensagem pelo API quando precisar sob demanda.

Virada

Próximos passos

• Comparar Bird e Infobip para SMS: avaliação de produto e considerações de migração
• Enviando SMS: o payload para o qual você está migrando, na íntegra
• Opt-outs e palavras-chave: cobertura de palavras-chave por país e gerenciamento de supressão
• Eventos de SMS: o vocabulário de eventos para o qual seu handler de relatórios migra
• Webhooks & eventos: configuração de endpoints e verificação de Standard Webhooks