Opt-out dan keyword

Ketika seseorang mengirim pesan ke salah satu nomor Anda, Bird mencocokkan pesan tersebut dengan katalog keyword sebelum Anda menerimanya. Keyword stop yang dikenali menekan pesan selanjutnya dari pengirim tersebut ke pelanggan, keyword start mengakhiri penekanan, dan help membalas dengan informasi dukungan. Negara yang didukung tidak memerlukan pengaturan untuk perilaku ini.

Panduan ini mencakup apa yang Bird lakukan secara default, cara melihatnya, dan cara mengubahnya.

Apa yang terjadi secara default

Seorang pelanggan mengirim STOP ke salah satu nomor Anda. Bird:

Mengenalinya berdasarkan katalog keyword untuk negara nomor tersebut.
Mencatat penekanan pada pasangan pengirim-dan-pelanggan yang tepat.
Mengonfirmasinya dengan membalas menggunakan pesan opt-out untuk negara tersebut.

Sejak saat itu, pengiriman dari pengirim tersebut ke pelanggan tersebut ditolak dengan E12077 SMSRecipientSuppressed alih-alih dikirim. START mengakhiri penekanan dan mengonfirmasinya juga, dan HELP membalas tanpa mengubah apa pun.

Penekanan mencakup satu pengirim dan satu pelanggan. Penekanan tidak mencakup seluruh workspace Anda. Cakupan teknis pemblokiran tersebut tidak memberikan izin untuk menggunakan pengirim lain. Terapkan preferensi yang dinyatakan pelanggan pada pesan dan program yang mereka minta untuk dihentikan. Untuk menghentikan semua pengirim di workspace sekaligus, lihat Opt-out dari semua pengirim di bawah.

Konfirmasi dikecualikan dari penekanan yang dicatatnya. Bird dapat membalas pesan masuk meskipun penekanan baru memblokir pengiriman keluar selanjutnya.

Cakupan berdasarkan negara

Katalog Bird mencakup sebagian negara. Jika suatu negara tercakup, Bird menangani keyword opt-out, opt-in, dan help secara default. Jika tidak tercakup, Bird tidak mengenali keyword apa pun, tidak mengirim balasan, dan tidak mencatat opt-out. Jika Anda mengirim ke negara yang tidak tercakup, Anda harus menangani opt-out sendiri.

Periksa apa yang dimiliki suatu negara sebelum Anda mengandalkannya:

Contoh kode

bird sms keyword-rules list --country NL

Hasil kosong berarti negara tersebut tidak memiliki cakupan. Anda dapat menambahkan keyword custom sendiri di sana, tetapi setiap operasi lain menggantikan sesuatu yang disediakan Bird, jadi Anda hanya dapat membuatnya untuk negara dalam katalog Bird.

Melihat apa yang berlaku

GET /v1/sms/keyword-rules menjelaskan bagaimana balasan ke nomor Anda ditangani. Tanpa filter, hasilnya mengembalikan seluruh katalog Bird beserta aturan yang telah Anda buat; persempit dengan country, number, operation, atau scope:

scope=system mengembalikan hanya katalog Bird, termasuk default yang digantikan oleh aturan workspace.
scope=workspace mengembalikan hanya aturan Anda sendiri.
number=+18005551234 mengembalikan aturan yang berlaku untuk salah satu nomor Anda, dalam urutan penerapannya pada pesan masuk; tambahkan from_country untuk melihat apa yang didapat pengirim dari tempat lain, yang bisa berbeda.

Aturan dikembalikan dari yang paling spesifik terlebih dahulu, dan masing-masing membawa effective_keywords: kumpulan Bird untuk operasi dan negara tersebut ditambah apa pun yang Anda tambahkan.

Daftar mengembalikan dua operasi selain stop, start, dan help:

info membalas dengan informasi program Anda dan berperilaku persis seperti help. Operasi ini terpisah agar negara yang jawaban INFO-nya harus berbeda dari jawaban HELP-nya dapat memiliki keduanya; jika Bird tidak menyediakan aturan info untuk suatu negara, INFO adalah salah satu keyword help negara tersebut dan membalas dengan balasan help.
confirm menandai balasan double opt-in, seperti JOIN atau YES. Operasi ini tidak mengirim apa pun saat ini, jadi tangani dari handler Anda sendiri. Bird menyimpan keyword tersebut agar aturan custom tidak dapat mengklaimnya.

Mengubah balasan

Balasan default Bird benar tetapi generik. Untuk membalas atas nama Anda sendiri, buat aturan untuk negara dan operasi tersebut:

Contoh kode

bird sms keyword-rules create \
  --operation stop \
  --country NL \
  --reply "You are unsubscribed from MyBrand. Reply START to resume."

Aturan Anda menggantikan balasan default Bird untuk negara tersebut dan mempertahankan keyword Bird kecuali Anda menambahkan lebih banyak. Aturan ini juga mewarisi keyword yang ditambahkan Bird di kemudian hari. Anda tidak dapat mengubah operasi yang ditetapkan pada keyword opt-out atau opt-in; Bird menolak aturan yang mencoba mengikat STOP ke operasi lain.

Jika Bird menyediakan keyword suatu negara dalam lebih dari satu bahasa, setiap bahasa memiliki aturannya sendiri, sehingga pembuatan harus menyebutkan bahasa yang digantikannya. Kanada adalah negara tersebut saat ini: aturan stop, start, dan help-nya tersedia dalam en dan fr. language wajib di sana dan ditolak untuk negara yang Bird sediakan dalam satu bahasa saja.

Contoh kode

bird sms keyword-rules create \
  --operation stop \
  --country CA \
  --language fr \
  --reply "Vous etes desabonne de MyBrand. Repondez DEBUT pour reprendre."

Menampilkan daftar aturan suatu negara memperlihatkan apakah pemisahan berlaku dan bahasa mana saja yang tersedia.

Untuk membatasi aturan pada satu nomor alih-alih setiap nomor yang Anda miliki di negara tersebut, atur number alih-alih mengandalkan negara saja.

Jika Anda membalas pesan-pesan ini dari sistem Anda sendiri alih-alih melalui Bird, atur reply ke null bersama dengan confirmed_self_managed. Ini menonaktifkan balasan otomatis Bird untuk aturan tersebut sementara penekanan itu sendiri tetap berjalan.

Keyword kampanye

Aturan custom tidak memiliki perilaku bawaan. Aturan ini mencocokkan keyword yang Anda pilih dan mengirim balasan yang Anda tulis, yang mendukung keyword kampanye seperti PIZZA. Aturan custom tidak mewarisi keyword, jadi memerlukan setidaknya satu keyword sendiri, dan boleh menghilangkan country agar berlaku di mana pun Anda mengirim.

Keyword yang telah diikat Bird ke operasi kepatuhan tidak dapat digunakan kembali sebagai keyword kustom.

Membaca dan mengelola penekanan

GET /v1/sms/suppressions mencantumkan pasangan yang pengirimannya saat ini dihentikan, yang terbaru lebih dulu. Filter berdasarkan destination untuk memeriksa satu pelanggan sebelum mengirim kepada mereka, berdasarkan originator untuk salah satu pengirim Anda, atau berdasarkan reason:

keyword_stop: pelanggan mengirim keyword stop.
carrier_opted_out: operator mereka melaporkan opt-out.
manual: ditambahkan melalui API atau dashboard.

Penekanan yang telah berakhir tidak ditampilkan, sehingga respons mengidentifikasi penerima yang tidak dapat Anda kirimi pesan saat ini.

Anda dapat menambahkan satu sendiri untuk menghormati opt-out yang pelanggan sampaikan melalui telepon:

Contoh kode

bird sms suppressions add --destination +15550001234 --originator +15557654321

Penekanan manual memblokir setiap kategori, termasuk transaksional, dan penambahan bersifat idempoten. Penghapusan sengaja dibatasi: hanya penekanan manual yang dapat diakhiri dengan cara ini. Keyword stop dari pelanggan sendiri dan opt-out dari operator ditolak, karena itu bukan hak Anda untuk membatalkannya.

Opt-out dari semua pengirim

Keyword stop dan penekanan manual di atas keduanya menghentikan satu pengirim. Sebagian pelanggan ingin keluar dari semua pengirim di workspace sekaligus, misalnya seseorang yang meminta tim dukungan Anda untuk menghentikan semua pesan alih-alih membalas ke setiap nomor satu per satu.

Itu adalah preferensi yang dinyatakan, bukan penekanan, sehingga berada di tab Preferences pada SMS > Suppressions, bukan di daftar di atas. Buka tab tersebut dan catat opt-out dengan Every sender in the workspace: nomor tersebut berhenti menerima SMS dari setiap pengirim di workspace, termasuk pengirim yang Anda tambahkan nanti. Opt-out yang dicatat di tab ini mencakup semua pesan, termasuk teks autentikasi; untuk mencatat yang hanya menghentikan marketing, gunakan halaman Contacts > Preferences di level workspace, yang dialognya menawarkan pilihan cakupan.

Bird memeriksa penekanan dalam panduan ini terlebih dahulu, sehingga keyword stop biasa tetap ditolak dengan E12077 seperti sebelumnya. Pengiriman ke nomor dengan opt-out level workspace yang tercatat ditolak dengan E25000 PreferenceRevoked. Untuk melanjutkan pengiriman setelah pelanggan meminta Anda, hapus entri dari tab Preferences (Anda yang mencatatnya, jadi Anda dapat menghapusnya), atau catat opt-in di halaman Contacts > Preferences level workspace.

Langkah selanjutnya

Tinjau persetujuan kampanye dan kontrol pengiriman sebelum mengirim ke audiens, atau jelajahi penanganan opt-out SMS untuk integrasi Anda.

Mengirim SMS: tinjau kategori, pengirim, dan kondisi penolakan.
Events: tangani event sms.* untuk pengiriman dan balasan.
Log SMS: periksa pesan, termasuk pengiriman yang ditolak.

Sumber daya terkait

Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.

Pahami konsepnyaHow do I collect SMS opt-ins?Gunakan alatnyaPreview message segments Jelajahi kemampuannyaSMS compliance Ikuti jalur pembelajaranOperate messaging reliably

Dapatkan ringkasan implementasi