Migrasi SMS dari provider lain

1. Aktifkan negara tujuan Anda
2. Siapkan sender
3. Petakan send call ke POST /v1/sms/messages
4. Migrasikan daftar opt-out Anda
5. Alihkan laporan pengiriman ke webhook
6. Uji terhadap destinasi simulasi sebelum cutover

1. Aktifkan negara tujuan Anda

2. Siapkan sender

• Alphanumeric sender ID Anda buat sendiri di SMS > Senders. Jika negara tujuan mewajibkan sender ID didaftarkan, ajukan registrasi di sana dan tunggu persetujuan sebelum mengarahkan traffic ke sender tersebut.
• Traffic bisnis AS melalui local long code memerlukan 10DLC brand dan campaign yang sesuai, disiapkan di SMS > 10DLC, sementara nomor toll-free dan short code khusus memiliki program verifikasi atau aplikasi tersendiri. AS sama sekali tidak menerima alphanumeric sender ID, sehingga sender ID Eropa yang berfungsi di tempat lain tidak memiliki padanan di AS.
• Nomor diperoleh melalui alur kerja Numbers, dengan ketersediaan dan provisi terkelola bergantung pada tipe dan tujuan. Periksa SMS numbers untuk jalur yang tepat; menambahkan alphanumeric sender tidak memperoleh nomor.
• Mempertahankan nomor Anda saat ini bukan layanan mandiri: Bird tidak memiliki alur port-in yang dapat Anda jalankan dari dashboard. Jika pelanggan membalas ke nomor yang Anda miliki saat ini, ajukan port ke dukungan sebelum menjadwalkan tanggal cutover, dan rencanakan agar port dan perubahan kode menjadi dua kejadian terpisah.

3. Petakan send call

• Satu penerima per request. Bird tidak memiliki array penerima. Jika provider Anda saat ini menyebarkan satu panggilan ke banyak nomor, itu menjadi satu panggilan per penerima, atau satu batch pesan independen dalam satu request.
• category wajib pada free text, dan nilainya adalah transactional, marketing, authentication, atau service. Kebanyakan provider menyimpulkan tujuan dari campaign atau sender; di sini Anda mendeklarasikannya per pesan, dan jika negara tujuan mewajibkan sender didaftarkan, registrasi tersebut disetujui untuk kategori tertentu dan pengiriman di luar kategori itu ditolak dengan 422 SenderCategoryNotPermitted. Status active pada sender tidak dapat memberi tahu Anda hal ini sebelumnya, karena dilaporkan tanpa mengacu pada kategori mana pun; baca persyaratan per negara sebagai gantinya. Atur dengan benar saat portasi, bukan memilih satu nilai default untuk semua.
• Body dibatasi dalam segmen, dan Bird tidak memotong. Body yang lebih panjang ditolak dengan 422. Karakter non-GSM-7 mengurangi kapasitas segmen lebih dari setengahnya, jadi jika provider Anda saat ini secara diam-diam mentransliterasi tanda kutip lengkung dan tanda hubung, atur options.smart_encoding untuk mempertahankan jumlah segmen yang biasa Anda gunakan. Fitur ini nonaktif secara default karena mengubah body yang Anda susun.
• Gunakan tags untuk dimensi filter dan metadata untuk konteks. Tag adalah pasangan {name, value} yang dapat Anda filter dan gunakan untuk memotong analitik; metadata adalah JSON arbitrer yang Bird simpan, kembalikan pada pembacaan, dan kirimkan kembali di setiap event webhook. Field referensi klien tunggal di provider lama Anda biasanya dipetakan ke metadata.
• Penjadwalan pengiriman individual dan MMS outbound memerlukan rencana terpisah. scheduled_at, media_urls, validity_period, dan personalization per penerima adalah field yang dicadangkan, ditolak dengan 422 SMSUnsupportedFeature. Bagian integrasi tersebut tidak ikut berpindah: tahan pengiriman terjadwal di antrean Anda sendiri dan panggil endpoint kirim pada waktu pengajuan yang dimaksud. Untuk kampanye audiens, evaluasi Broadcasts secara terpisah; broadcast bukan sekadar penggantian nama field pada endpoint.
• Gunakan Idempotency-Key untuk percobaan ulang terbatas. Kirim kunci unik per pesan logis dan gunakan kembali untuk percobaan ulang request identik dalam jendela replay tiga jam. Replay mengurangi request duplikat tetapi bukan jaminan pengiriman tepat-satu-kali. Lihat Idempotency.

4. Migrasikan daftar opt-out Anda

while IFS=, read -r destination originator; do
  curl -s -X POST https://us1.platform.bird.com/v1/sms/suppressions \
    -H "Authorization: Bearer $BIRD_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{\"destination\": \"$destination\", \"originator\": \"$originator\"}"
done < opt-outs.csv

• Kedua sisi diperlukan untuk supresi khusus sender. Opt-out seluruh workspace termasuk dalam preference owner yang terpisah. Panggilan ini idempoten: 201 mencatat supresi baru, 200 mengembalikan supresi manual yang sudah ada, sehingga menjalankan ulang impor parsial aman dilakukan.
• Pasangan yang diimpor mendapat reason: manual, yang memblokir setiap kategori termasuk transaksional. Ini lebih ketat daripada supresi yang Bird catat sendiri dari kata kunci stop. Jika subscriber hanya opt-out dari marketing, pertimbangkan dengan sengaja apakah pasangan tersebut perlu diimpor.

5. Alihkan laporan pengiriman ke webhook

• Pengiriman ditandatangani sesuai Standard Webhooks, menggunakan header webhook-id, webhook-timestamp, dan webhook-signature dengan HMAC-SHA256 atas {id}.{timestamp}.{raw body}. Provider yang menandatangani dengan skema sendiri perlu verifikasinya diganti; caranya ada di Webhooks & events.
• Pengiriman bersifat at-least-once dan tidak berurutan. Deduplikasi berdasarkan webhook-id dan urutkan berdasarkan timestamp pada payload, bukan berdasarkan urutan kedatangan.

6. Uji terhadap destinasi simulasi

• Ini adalah nomor AS, jadi United States harus diaktifkan di Destinations, dan from harus berupa sender yang valid untuk AS. Alphanumeric sender ID ditolak di sana.
• Pengiriman simulasi dikenakan biaya sesuai tarif normal destinasi. Tidak ada yang sampai ke perangkat, tetapi tagihan wallet bersifat nyata, jadi sesuaikan ukuran smoke test Anda.
• Hasilnya ditentukan oleh destinasi saja. Tidak ada kredensial uji terpisah, dan tidak ada mode uji yang perlu dimatikan.

Migrasi dari provider tertentu

• Twilio: PascalCase form-encoded ke JSON, Messaging Services ke sender, StatusCallback ke webhook berlangganan
• Plivo: src dan dst ke from dan to, Powerpacks ke sender, pasangan DND ke supresi
• Telnyx: pengiriman yang paling mirip dengan Bird, messaging profiles dipecah menjadi sender dan subscription, opt-out seluruh profil ke pasangan
• Bandwidth: dua host menjadi satu, callback applicationId ke webhook workspace, dan daftar opt-out yang sudah dipegang aplikasi Anda sendiri
• Sinch: batch ke pengiriman tunggal, body ke text, keanggotaan grup dibangun ulang sebagai supresi
• Infobip: payload tiga level diratakan, base URL per akun ke host regional, Blocklist diperluas menjadi pasangan
• Bird Connectivity Platform: rest.messagebird.com API, originator dan recipients ke from dan to, callback GET reportUrl ke webhook bertanda tangan

Langkah selanjutnya

• Bandingkan provider SMS: evaluasi alur kerja produk dan pertimbangan migrasi
• Sending SMS: payload pengiriman lengkap, sender, segmen, dan model async 202
• Opt-outs and keywords: apa yang Bird jawab untuk Anda, dan cara mengelola supresi
• SMS events: kosakata event dan payload per event
• Webhooks & events: pengaturan endpoint, verifikasi tanda tangan, percobaan ulang, dan replay