Hentikan penggunaan merek perpesanan

Pilih alur penghentian penggunaan

Hentikan penggunaan merek perpesanan saat bisnis tidak lagi memerlukan pendaftaran tersebut. Tindakan ini menghentikan penggunaan pendaftaran yang ada; tindakan ini tidak mendaftarkan pengganti, melepaskan nomor telepon sewaan, atau memperbaiki detail identitas bisnis. Untuk melakukan perbaikan, gunakan Perbarui merek perpesanan.

Panggilan DELETE merek publik dan tindakan Hapus merek di portal memiliki cakupan berbeda. Panggilan publik menghapus satu merek di registri. Portal mengoordinasikan pelepasan penetapan nomor dan penonaktifan kampanye sebelum mencoba menghapus merek.

Tinjau dampaknya di portal

Buka halaman pendaftaran perpesanan, temukan merek yang benar, lalu pilih Hapus merek. Tinjau jumlah kampanye terkait dan nomor yang ditetapkan. Ketik ID merek secara persis untuk mengaktifkan tindakan akhir. Formulir pelanggan hanya tersedia jika akun memiliki izin pengelolaan pendaftaran.

Portal memproses kampanye aktif secara berurutan: mencoba melepaskan setiap nomor yang saat ini ditetapkan, menonaktifkan kampanye, lalu menghapus merek. Portal melewati penghapusan jarak jauh berikutnya untuk kampanye yang sudah ditandai kedaluwarsa atau dihapus. Setelah langkah eksternal tersebut berhasil, portal memperbarui catatan kampanye dan nomor lokal dalam sebuah transaksi basis data.

Rangkaian ini bukan satu transaksi atomik yang mencakup registri, operator, dan catatan lokal. Kegagalan pada langkah berikutnya tidak dapat memulihkan nomor atau kampanye yang sudah diubah secara eksternal. Simpan detail nomor yang dilepaskan dan kampanye yang dinonaktifkan dari hasil yang dikembalikan, jika tersedia; cocokkan dan selaraskan status berdasarkan pengenal tersebut alih-alih membuat merek lain.

Siapkan penghapusan langsung melalui API

Gunakan akun API yang telah diaktifkan melalui HTTPS dari alamat IP sumber yang diizinkan. Merek harus dimiliki oleh akun tersebut. Baca dan simpan ID serta status terkininya, lalu periksa kampanye dan penetapan nomornya. Lepaskan penetapan nomor yang terdampak dan nonaktifkan kampanye sebelum menghapus merek. Jangan menganggap DELETE ini sebagai operasi penghapusan berantai.

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

Hapus merek yang telah ditinjau

Jalankan perintah berikut hanya untuk penghentian penggunaan yang dimaksud, setelah memeriksa ID merek dan menyelesaikan pembersihan sebelumnya. Tidak ada isi permintaan JSON.

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request DELETE \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

Hasil sukses yang didokumentasikan adalah HTTP 204 tanpa isi respons. Jangan mensyaratkan objek sukses JSON atau pembungkus status/response lama dari v3. Hasil non-2xx yang ditolak tidak menandai merek sebagai dihapus melalui jalur sinkronisasi API saat ini.

Gunakan satu kunci idempotensi untuk permintaan yang dimaksud. Saat mengulang permintaan, pertahankan metode, jalur, kueri, dan byte isi tanpa perubahan. Kunci tersebut tidak menjadikan pembersihan portal yang lebih luas bersifat atomik dan tidak membuktikan bahwa penetapan nomor di operator telah dilepaskan. Duplikat permintaan yang masih diproses dapat mengembalikan 409 dengan Retry-After; permintaan yang telah selesai dapat mengembalikan kembali respons tersimpannya, termasuk respons kesalahan.

Verifikasi penghentian penggunaan dan selaraskan hasil parsial

Periksa daftar merek dan kampanye di portal serta nomor yang terdampak setelah operasi selesai. Sinkronisasi keberhasilan API publik menandai merek individual tersebut sebagai dihapus secara lokal; sinkronisasi ini tidak menghapus sumber daya kampanye lainnya atau mengosongkan penetapan nomor yang dibeli. Status registri, penetapan di operator, dan tampilan lokal harus diperiksa secara terpisah.

Adaptor operator portal saat ini menerima respons sukses HTTP tanpa memvalidasi secara terpisah setiap nilai status bisnis dalam isi responsnya. Karena itu, verifikasi penetapan kampanye yang sebenarnya untuk nomor terdampak setelah pembersihan melalui portal, meskipun portal melaporkan keberhasilan. Jika ada penetapan atau status yang tidak konsisten, simpan ID yang terdampak dan hubungi dukungan sebelum mengirim pesan melalui konfigurasi yang telah dihentikan atau membuat ulang konfigurasi tersebut.

Untuk HTTP 400, baca detail kesalahan registri, terutama pembatasan terkait kampanye aktif. Untuk 401, 403 atau 404, periksa kredensial, IP sumber yang diizinkan, dan kepemilikan akun. Untuk 429, patuhi Retry-After. Batas waktu yang terlampaui, 500 atau 502 dapat terjadi setelah perubahan eksternal selesai; periksa pendaftaran yang ada sebelum mengulangi permintaan.

Periksa biaya akun yang masih berlaku

Layanan DELETE saat ini tidak mengirimkan instruksi pendebitan langsung untuk pendaftaran merek. Menghapus merek tidak melepaskan nomor telepon sewaan, memberikan pengembalian dana, atau menentukan saldo akhir akun. Tinjau komitmen kampanye yang masih berlaku, sewa nomor, dan biaya penggunaan di portal. Operasi ini bukan penawaran harga untuk layanan terpisah tersebut.