«Stop-list» (або список виключень) містить отримувачів, яким не слід надсилати повідомлення. У каналі WhatsApp від BSG існують два окремі stop-list, і вони працюють по-різному — одним керуєте ви, іншим керує Meta. У цьому посібнику пояснено обидва списки: як кожен із них впливає на надсилання, а також наведено важливе застереження щодо резервного каналу SMS.
Два stop-list коротко
| Платформний stop-list BSG | Stop-list WhatsApp від Meta | |
|---|---|---|
| Хто ним керує | Ви — додаєте та видаляєте номери | Meta — наповнюється на основі відмов користувачів |
| Область дії | Крос-канальний; whatsapp — один із кількох types |
Лише WhatsApp, для кожного WABA |
| Коли застосовується | Під час надсилання кампанії з увімкненою перевіркою stop-list (за замовчуванням) | Meta — під час доставки |
| Ваш доступ | Читання та запис | Лише читання |
1. Платформний stop-list BSG (ви ним керуєте)
Це власний список виключень BSG, спільний для всіх каналів. Кожен запис — це номер телефону, позначений для одного або кількох types: sms, viber, rcs, whatsapp, telegram, voice. Номер може бути виключений для одних каналів і не виключений для інших — додайте whatsapp до types, щоб виключити його для WhatsApp.
Ви керуєте ним через методи stop-list OneAPI — кожна сторінка містить повний формат запиту, параметри та приклади:
-
Додати номери — Add Contacts to Stop List. Передайте номери телефонів та channel types (додайте
whatsapp). - Видалити номери — Remove Contacts from Stop List. Відкріпіть контакт від одного або кількох types.
- Переглянути список — Get Blacklisted Contacts. Фільтруйте за type, щоб побачити свої записи WhatsApp.
- Знайти номер — Search Contacts in Stop Lists. Результат показує позначку для кожного каналу, тож ви можете побачити, чи виключений номер саме для WhatsApp.
Ви також можете спробувати будь-який із цих викликів у Swagger explorer.
Як це впливає на надсилання: надсилання кампанії (Send WhatsApp campaign) має перевірку stop-list, яка увімкнена за замовчуванням — BSG пропускає будь-якого отримувача, знайденого у вашому платформному stop-list. Вимикайте її лише тоді, коли ви навмисно хочете проігнорувати список.
Одиночні надсилання не перевіряють його. Метод Send Single WhatsApp Message не має перевірки stop-list, тож одиночні надсилання не фільтруються за платформним stop-list — забезпечуйте виключення самостійно, якщо надсилаєте таким чином.
2. Stop-list WhatsApp від Meta (лише читання)
Цей список відображає відмови, зафіксовані на боці Meta — наприклад, коли отримувач натискає «Stop promotions» / кнопку відмови в маркетинговому повідомленні. Ви можете переглядати його, але не редагувати, через List of WhatsApp stop list contacts.
Кожен запис ідентифікує отримувача, WABA та час, коли було додано відмову. Meta застосовує цей список під час доставки — надсилання користувачеві, який відмовився від розсилок, просто не доставляється й відображається як помилка через маркетингову відмову 131050. Оскільки списком керує Meta, немає методу додавання/видалення; BSG надає вам доступ лише для читання.
⚠️ Важливо: резервний канал SMS може обійти відмову або блокування WhatsApp
Якщо ви додаєте до надсилання резервний канал SMS (опція alternative-channel), він спрацьовує щоразу, коли повідомлення WhatsApp повертається як undeliverable. Блокування вашого відправника у WhatsApp — або відмова від розсилок у WhatsApp — це одна з причин, чому повідомлення стає undeliverable. Тому:
Контакт, який заблокував вас у WhatsApp (або відмовився там від розсилок), все одно може отримати ваш резервний SMS, оскільки stop-list чи відмова у WhatsApp не виключає SMS.
Окремого stop-list для SMS немає — SMS керується тим самим глобальним платформним stop-list BSG, але резервний канал перевіряється лише за його type sms. Тож номер, позначений лише для whatsapp, не виключається для SMS.
Щоб врахувати відмови на всіх каналах, додайте номер до платформного stop-list для всіх відповідних types (whatsapp, sms та будь-який інший резервний канал) одним викликом Add Contacts to Stop List. Таким чином надсилання WhatsApp буде пропущено та, якщо воно колись дійде до резервного каналу, SMS теж буде пропущено.
Найкращі практики
- Тримайте перевірку stop-list кампанії увімкненою (за замовчуванням), щоб ваш платформний список завжди враховувався.
-
Коли контакт відмовляється від розсилок, виключіть його на всіх каналах, якими ви можете з ним зв'язатися — додайте як
whatsapp, так іsms(та будь-які інші резервні types) одним викликом. Не покладайтеся лише на відмову у WhatsApp, якщо використовуєте резервний канал SMS. - Розглядайте stop-list WhatsApp від Meta як джерело істини щодо відмов у WhatsApp — узгоджуйте його зі своєю власною логікою виключень (та зі своїм платформним stop-list), щоб не намагатися повторно зв'язатися з користувачами, які відмовилися від розсилок.
- Для одиночних надсилань застосовуйте власну перевірку stop-list перед викликом API, оскільки метод не робить цього за вас.
Пов'язані посібники
- Огляд BSG WhatsApp API — надсилання, резервний канал SMS та статуси доставки.
-
Поширені помилки WhatsApp API (надсилання) — зокрема помилка відмови
131050. - Початок роботи з 1-way WhatsApp на BSG — підключення облікового запису та налаштування надсилань.
Документація Meta
- Per-user marketing limits — маркетингові відмови та ліміти на одного користувача: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits/
- WhatsApp Cloud API error codes — зокрема помилка відмови
131050: https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes
Коментарі
0 коментарів
Стаття закрита для коментарів.