Уже надсилаєте повідомлення WhatsApp через іншого провайдера? Вам не обов'язково перемикати все одразу. WhatsApp дозволяє запускати BSG паралельно з вашим поточним провайдером, тож ви можете протестувати BSG на реальних повідомленнях і перевести основний трафік лише тоді, коли будете впевнені. Ця стаття проведе вас через увесь процес.
Що ви робитимете (стисло)
- Оберіть спосіб підключення — або надайте BSG доступ до наявного WhatsApp Business Account (WABA), або додайте новий WABA в межах того самого Meta Business Portfolio.
- Підключіть BSG через Embedded Signup або надавши доступ до свого WABA в Meta Business Suite.
- Додайте платіжний метод до свого облікового запису Meta (з BSG ви платите безпосередньо Meta).
- Переконайтеся, що BSG має ваші шаблони, рівень лімітів повідомлень та рейтинг якості (синхронізуються автоматично або дублюються, якщо ви використовуєте новий WABA).
- Протестуйте живе надсилання через BSG на окремому номері телефону — ваш основний номер продовжує працювати через поточного провайдера.
- Переведіть основний номер на BSG, коли будете готові.
Навіщо підключатися паралельно
- Жодного різкого перемикання. Ваш поточний провайдер продовжує доставку, поки ви оцінюєте BSG.
- Тестуйте, перш ніж остаточно переходити. Перевірте BSG від початку до кінця на реальних відправленнях і квитанціях про доставку.
- Збережіть здобуте. Ваш рівень лімітів повідомлень і (коли ви надаєте доступ до наявного WABA) ваші схвалені шаблони та рейтинг якості переносяться.
- Прозоре ціноутворення. BSG є Meta Tech Provider: ви платите безпосередньо Meta за трафік за тарифами Meta, а BSG стягує лише фіксовану підписку на платформу — без націнки на трафік.
Корисно знати: WABA можна надати в спільний доступ двом партнерам одночасно — цього достатньо, щоб запустити BSG паралельно з вашим поточним провайдером. Якщо обидва слоти партнерів уже зайняті, просто звільніть один перед додаванням BSG.
Два правила, що визначають цей процес
- Один WABA, до двох партнерів. WhatsApp дозволяє надати спільний доступ до одного WABA щонайбільше двом провайдерам одночасно — саме це дає змогу BSG працювати поруч із вашим поточним провайдером.
- Один номер телефону, один провайдер одночасно. Номер телефону може бути підключений до налаштувань лише одного провайдера в будь-який момент. Підключення основного номера до BSG переприв'язує його — тож той самий номер не може надсилати одночасно через старого провайдера та BSG. Саме тому ви спершу тестуєте BSG на окремому номері й переводите основний номер лише під час перемикання.
Через ці правила ви підключаєтеся у два етапи: перевіряєте BSG паралельно на окремому номері, а потім перемикаєте основний номер, коли будете готові.
Два способи підключити BSG
BSG підтримує обидва варіанти — оберіть той, що відповідає вашій ситуації:
| Варіант A — Надати доступ до наявного WABA | Варіант B — Новий WABA, той самий Business Portfolio | |
|---|---|---|
| Як це працює | BSG додається як другий партнер до WABA, який ви вже використовуєте | BSG підключає абсолютно новий WABA в межах вашого наявного Meta Business Portfolio |
| Ваші шаблони | Синхронізуються автоматично з вашого WABA — вам не потрібно нічого відтворювати | Ви дублюєте їх самостійно (у WhatsApp Business Portfolio або через API Meta); BSG потім синхронізує їх після схвалення |
| Рівень лімітів повідомлень | Спільний (ліміти встановлюються на рівні Business Portfolio) | Спільний на рівні Business Portfolio; новий номер напрацьовує власний рейтинг якості |
| Коли краще | Ви хочете один обліковий запис і найплавніше подальше перемикання | Ви віддаєте перевагу повній ізоляції двох провайдерів |
Не впевнені, що дозволяє ваш поточний WABA? Дивіться FAQ про підключення наявного облікового запису — те, як спочатку було створено ваш WABA, впливає на спосіб його підключення.
Перш ніж почати
Переконайтеся, що ви маєте:
- Адміністративний доступ до Meta Business Portfolio, якому належить ваш WABA.
- WABA у статусі approved і verified Meta Business.
- Номер телефону, чиє відображуване ім'я (display name) схвалено (без незавершеного запиту на зміну імені).
- Можливість додати платіжний метод до вашого облікового запису Meta — необхідно для того, щоб BSG міг надсилати (модель Tech Provider).
- Запасний або тестовий номер телефону для перевірки BSG у роботі (він знадобиться незалежно від Варіанта A чи B).
- Обліковий запис BSG з API key (з Integrations & API → SMPP/API Password у кабінеті BSG).
- Вільний слот партнера на вашому WABA, якщо ви надаєте до нього доступ (пам'ятайте про максимум у два партнери).
Вам не потрібно наразі вимикати two-step verification — це знадобиться лише тоді, коли ви переводитимете основний номер під час перемикання, а її увімкнений стан захищає ваш робочий номер, поки ви тестуєте.
Етап 1: Підключіть BSG паралельно з вашим поточним провайдером
Крок 1 — Увійдіть до BSG API
Обміняйте свій Live API key на bearer token (JWT), а потім надсилайте його з кожним наступним запитом. Дивіться Receive JWT token для точного формату запиту та відповіді.
Крок 2 — Підключіть BSG до свого облікового запису WhatsApp
Якщо ви надаєте доступ до наявного WABA (Варіант A):
Спосіб підключення залежить від того, як було створено ваш WABA:
-
Якщо ваш WABA можна вибрати в Embedded Signup, відкрийте потік Embedded Signup зі своєї панелі BSG. Вас попросять:
- Увійти за допомогою облікового запису Facebook/Meta, який керує вашим бізнесом.
- Переглянути та прийняти умови WhatsApp Business і Meta.
- Обрати свій Business Portfolio.
- Вибрати наявний WhatsApp Business Account — оберіть той, який ви вже використовуєте.
- Підтвердити номер(и) телефону, до яких BSG повинен мати доступ.
- Надати запитувані дозволи.
Якщо ваш WABA було створено через інший застосунок або провайдера, WhatsApp не дасть вибрати його у вікні реєстрації. Замість цього надайте до нього доступ із Meta Business Suite: перейдіть до Business Settings → Accounts → WhatsApp Accounts, виберіть свій WABA, оберіть Add partner / Share, введіть ID Business Portfolio BSG і надайте дозволи на обмін повідомленнями та керування.
У будь-якому разі це лише додає доступ для BSG — не видаляючи й не перериваючи роботу вашого поточного провайдера.
Якщо ви додаєте новий WABA (Варіант B):
Відкрийте потік Embedded Signup зі своєї панелі BSG й виконайте наведені вище кроки, але оберіть Create a new WhatsApp Business Account і додайте новий номер телефону, коли з'явиться відповідний запит. Ваша верифікація бізнесу та профіль спільні для всього Business Portfolio, тож повторно верифікацію проходити не потрібно.
Крок 3 — BSG завершує налаштування автоматично
Коли підключення завершиться, BSG виконає технічні кроки за вас: він безпечно обміняє вашу авторизацію на access token і підпишеться на сповіщення вашого WABA (webhooks). Потім BSG синхронізує ваші шаблони — їхній список, статус і якість — з вашого WhatsApp Business Portfolio.
- Варіант A (спільний WABA): ваші наявні схвалені шаблони синхронізуються автоматично — нічого відтворювати не потрібно.
- Варіант B (новий WABA): новий WABA починається порожнім, тож ви дублюєте свої шаблони самостійно — відтворіть їх у WhatsApp Business Portfolio або через API Meta — а BSG синхронізує їх, щойно Meta їх схвалить.
Шаблони керуються на боці Meta. BSG підтримує синхронізацію списку, статусу та якості ваших шаблонів, але не створює й не редагує шаблони. Ви керуєте шаблонами — створюєте, редагуєте та дублюєте їх — у кабінеті WhatsApp Business Portfolio або програмно через API Meta.
Крок 4 — Додайте платіжний метод Meta
У WhatsApp Manager → Account tools → Payment settings прикріпіть дійсний платіжний метод, щоб ваші повідомлення були готові до надсилання. З BSG рахунок за трафік повідомлень вам виставляє Meta безпосередньо — за опублікованими тарифами Meta, без націнки — тоді як BSG стягує лише фіксовану підписку на платформу. Це окремо від виставлення рахунків вашим поточним провайдером, яке залишається як є.
Крок 5 — Переконайтеся, що все синхронізувалося
Перевірте, що BSG підхопив ваш обліковий запис — у кабінеті BSG або через API:
-
Ваш WhatsApp Business Account — List of WhatsApp Business Accounts показує ваші підключені WABA зі статусом верифікації та лімітом повідомлень вашого Business Portfolio. Ліміти повідомлень діють на рівні всього Business Portfolio:
250 → 2,000 → 10,000 → 100,000 → Unlimited. - Ваші відправники — List of WhatsApp Senders показує кожен підключений номер із його відображуваним іменем, статусом верифікації та рейтингом якості.
- Ваші шаблони — Search WhatsApp templates перелічує схвалені шаблони, які синхронізував BSG (автоматично для Варіанта A; ваші схвалені копії для Варіанта B).
- Ваш callback URL встановлено, тож BSG може пересилати статуси доставки та вхідні події до вашої системи.
Крок 6 — Протестуйте живе надсилання (не торкаючись продакшену)
Надішліть реальне повідомлення через BSG, використовуючи свій окремий тестовий номер, поки основний номер продовжує працювати через поточного провайдера. Використовуйте Send Single WhatsApp Message зі схваленим шаблоном (на сторінці методу є повний формат запиту та параметри).
Переконайтеся, що ви отримуєте оновлення sent → delivered → read на своєму callback URL. Коли це працює, BSG повністю підключено та перевірено — а весь ваш продакшн-трафік і далі йде через вашого поточного провайдера.
Етап 2: Переведіть основний номер на BSG
Робіть це лише тоді, коли ви задоволені результатами тестування. Саме на цьому етапі перемикається ваш основний номер.
Крок 1 — Вимкніть two-step verification
Вимкніть two-step verification на своєму основному номері в WhatsApp Manager (або попросіть вашого поточного провайдера зробити це). Щойно її буде вимкнено, номер готовий до підключення до BSG.
Крок 2 — Перевірте, чи не залишилося кредитної лінії
Якщо ваш поточний провайдер є Solution Partner, який виставляв вам рахунки через свою кредитну лінію, залишкова кредитна лінія може іноді спричинити помилку під час перемикання. Якщо це станеться, попросіть вашого попереднього провайдера відкликати її або видаліть її в Meta Business Settings. (У більшості випадків це не є перешкодою — звичайні причини — це two-step verification та незавершене налаштування.)
Крок 3 — Підключіть основний номер до BSG
BSG реєструє ваш основний номер для надсилання. З цього моменту номер надсилає й отримує через BSG замість вашого старого провайдера.
- Варіант A (спільний WABA): номер залишається в тому самому WABA, і ваші шаблони вже синхронізовано — нічого відбудовувати не потрібно.
- Варіант B (новий WABA): номер мігрується до WABA BSG, де ваші дубльовані шаблони вже схвалені й готові.
Крок 4 — Перевірте та завершіть
- Надішліть робочий шаблон через BSG і підтвердіть доставку.
- Спрямуйте запити на надсилання вашого застосунку на BSG API.
- Щойно все стабілізується, ви можете прибрати доступ вашого старого провайдера, якщо другий слот партнера вам більше не потрібен.
FAQ
1. Чи BSG надасть спільний доступ до мого наявного облікового запису WhatsApp, чи створить новий?
Підтримуються обидва варіанти. Надання доступу до наявного WABA тримає все в одному обліковому записі та синхронізує ваші шаблони автоматично. Новий WABA (у межах того самого Business Portfolio) тримає двох провайдерів повністю окремо, але ваші шаблони потрібно продублювати та повторно схвалити. Дивіться «Два способи підключити BSG» вище.
2. Чому я не бачу свій наявний обліковий запис WhatsApp у вікні реєстрації?
WhatsApp не дає вибрати WABA в Embedded Signup, якщо його спочатку було створено через інший застосунок або провайдера. У такому разі надайте до нього доступ через Meta Business Suite → Business Settings → WhatsApp Accounts → Share with a partner, використовуючи ID Business Portfolio BSG.
3. Як мені запустити BSG і мого поточного провайдера паралельно?
WhatsApp підключає кожен номер телефону до одного провайдера одночасно, тож ви тестуєте BSG на окремому номері, поки ваш поточний провайдер продовжує обслуговувати основний номер. Коли ви впевнені, ви переводите основний номер на BSG — перевіряючи все від початку до кінця без перерв у живому трафіку.
4. Чи перенесуться мої шаблони?
Якщо ви надаєте доступ до наявного WABA, BSG автоматично синхронізує ваші схвалені шаблони — відтворювати нічого не потрібно. Якщо ви використовуєте новий WABA, ви дублюєте свої шаблони до нього самостійно (у WhatsApp Business Portfolio або через API Meta), і Meta повторно їх схвалює; BSG потім синхронізує їх. (Meta лише «дублює» шаблони, коли вони переміщуються між WABA — надання спільного доступу до одного WABA ніколи нічого не дублює.)
5. Чи можу я створювати або редагувати шаблони в BSG?
Ні. BSG синхронізує список, статус і якість ваших шаблонів з вашого WhatsApp Business Portfolio, щоб ви могли їх надсилати, але не створює й не редагує їх. Ви керуєте шаблонами в кабінеті WhatsApp Business Portfolio або через API Meta.
6. Чи збережуться мій рівень лімітів повідомлень та рейтинг якості?
Так. Ліміти повідомлень встановлюються на рівні Business Portfolio, тож вони переносяться в обох випадках. Якщо ви надаєте доступ до наявного WABA, ваш номер зберігає й свій рейтинг якості. (Абсолютно новий номер у новому WABA починає напрацьовувати власний рейтинг якості, як і будь-який новий номер.)
7. Хто виставляє мені рахунки?
Meta виставляє рахунки безпосередньо вам за трафік повідомлень за опублікованими тарифами Meta. BSG стягує лише фіксовану підписку на платформу — націнки на трафік немає. Просто переконайтеся, що платіжний метод Meta є у вашому обліковому записі.
8. Чи потрібно мені вимикати two-step verification?
Лише коли ви переводите основний номер (Етап 2). Тримайте її увімкненою, поки тестуєте на Етапі 1 — вона захищає ваш робочий номер.
9. Який номер варто використовувати для тестування маркетингових шаблонів?
Використовуйте не-US номер для тестів маркетингових шаблонів — WhatsApp наразі не доставляє маркетингові шаблони на US-номери (+1). Службові та автентифікаційні шаблони працюють всюди.
10. Чи є простій під час перемикання?
Підключення номера відбувається швидко. Зі спільним WABA ваші шаблони вже синхронізовано, тож затримки з повторним схваленням немає; з новим WABA переконайтеся, що ваші дубльовані шаблони схвалено, перш ніж перемикатися. Для надійності плануйте перехід на період низького трафіку.
11. Скільки провайдерів можна підключити одночасно?
Щонайбільше двох на одному WABA. Якщо у вас уже два, приберіть одного перед додаванням BSG.
12. Що робити, якщо мій WABA уже підключено до двох провайдерів?
Максимум у два партнери накладається WhatsApp, тож BSG не можна додати третім. Якщо ви пройдете Embedded Signup і виберете цей WABA, надання доступу не завершиться. Щоб продовжити, спершу звільніть слот: у Meta Business Settings → Accounts → WhatsApp Accounts → [ваш WABA] → Partners приберіть одного з наявних партнерів, а потім повторно запустіть Embedded Signup від BSG (або надайте доступ до WABA для BSG через Business Suite). Зверніть увагу, що видалення партнера зупиняє обмін повідомленнями цього провайдера на WABA, тож звільняйте слот лише для провайдера, з яким ви завершили роботу — або робіть це як частину перемикання. Якщо ви не хочете чіпати жоден зі слотів, скористайтеся натомість Варіантом B: підключіть новий WABA в межах того самого Business Portfolio з новим номером і перевірте BSG там.
Пов'язані посібники
- Початок роботи з 1-way WhatsApp на BSG — покрокове ознайомлення для нових користувачів (почніть звідси, якщо ви не мігруєте від іншого провайдера).
- Огляд BSG WhatsApp API — методи надсилання, структура шаблону та відстеження доставки, які ви перевірятимете тут.
- Поширені помилки Embedded Signup (онбордингу) на BSG — проблеми під час підключення вашого облікового запису.
- Callback-и WhatsApp на BSG — callback статусу доставки, який ви підтвердите під час тестування.
- Повний довідник API: BSG API documentation · Swagger explorer.
Документація Meta
- WhatsApp Business Accounts — модель спільного використання WABA та надання доступу до WABA партнеру: https://developers.facebook.com/docs/whatsapp/overview/business-accounts/
- Embedded Signup (включно з обмеженнями вибору наявного WABA та виставленням рахунків): https://developers.facebook.com/docs/whatsapp/embedded-signup
- Pricing — модель оплати за повідомлення; ви платите безпосередньо Meta, без націнки: https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing
- Міграція номерів телефонів між партнерами через Embedded Signup: https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/support/migrating-phone-numbers-among-solution-partners-via-embedded-signup/
- Business phone numbers — реєстрація та two-step verification: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers
- Керування кредитними лініями (надання / відкликання): https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/share-and-revoke-credit-lines
- Messaging limits (на рівні portfolio): https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits
- Per-user marketing limits (включно з US-номерами): https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits/
- Template management (створення/керування в Meta): https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-management/
Коментарі
0 коментарів
Стаття закрита для коментарів.