Українська English (United States) Русский

Статті в цьому розділi

Початок роботи з 1-way WhatsApp на BSG

Support Department
  • Оновлено
Читати

Цей посібник проведе вас від створення облікового запису BSG до надсилання вашого першого вихідного повідомлення WhatsApp через API. «1-way» означає, що ваша компанія надсилає клієнтам затверджені шаблонні повідомлення; ви також можете отримувати статуси доставки (а в майбутньому — і вхідні відповіді) на ваш callback URL.

Що ви зробите (коротко)

  1. Створіть обліковий запис або увійдіть до свого облікового запису BSG.
  2. Відкрийте канал WhatsApp на платформі.
  3. Підключіть свій WhatsApp Business Account (WABA) — Business Portfolio, WABA та номер телефону — через Embedded Signup від Meta.
  4. Додайте спосіб оплати в Meta, щоб ваші повідомлення можна було надсилати.
  5. (Рекомендовано) Верифікуйте свій Business Portfolio, щоб підвищити початковий ліміт надсилання.
  6. Створіть та затвердіть свої шаблони у WhatsApp Manager від Meta.
  7. Отримайте свій API key і встановіть свій WhatsApp callback URL у BSG.
  8. Надішліть своє перше повідомлення через API.

Як WhatsApp працює на BSG

BSG є Meta Tech Provider. На практиці це означає:

  • Ви платите Meta напряму за трафік повідомлень за опублікованими тарифами Meta — див. тарифи Meta. BSG стягує плату лише за платформу; націнки на трафік немає. Ви отримаєте окремий рахунок від Meta (це відрізняється від таких провайдерів, як Twilio чи Infobip, які виставляють вам рахунок за трафік).
  • Ви володієте своїм WhatsApp Business Account. BSG підключається до нього як Tech Provider (за потреби — паралельно з вашим поточним BSP).
  • Шаблони, відправники, ліміти та тарифікація знаходяться в Meta. BSG синхронізує їх у режимі лише для читання, щоб ви могли надсилати й відстежувати, — але створюєте їх і керуєте ними ви в інструментах Meta (деталі нижче).
  • Це спеціалізований вихідний канал за принципом API-first для масового надсилання затверджених шаблонів. Статуси доставки доступні вже зараз, а пересилання вхідних повідомлень/кнопок з'явиться у майбутньому. (Двостороння вхідна скринька, чат-бот та конструктори шаблонів/кампаній знаходяться поза цим каналом.)

Чим ви керуєте і де

У BSG У Meta (WhatsApp Manager / API)
Надсилання повідомлень через API Створення, редагування та подання шаблонів на затвердження
Перегляд синхронізованих шаблонів, відправників, статусу WABA Керування відправниками / відображуваними іменами
Перегляд статусів доставки та аналітики Спосіб оплати та тарифікація
Налаштування вашого callback URL Ліміти повідомлень та верифікація
Керування платформним stop-list Володіння Portfolio / WABA

Перш ніж почати

Переконайтеся, що у вас є:

  • Обліковий запис Meta (Facebook) Business з правами адміністратора для Business Portfolio, який ви підключатимете.
  • Номер телефону, який використовуватиметься як ваш номер-відправник WhatsApp — або новий номер, або наявний WABA/номер, який ви вже використовуєте (ви можете обрати наявний WABA під час реєстрації).
  • Ваші бізнес-дані (та, в ідеалі, верифікований Business Portfolio — див. Крок 5).
  • Можливість додати спосіб оплати до вашого облікового запису Meta.
  • Обліковий запис BSG (створіть його нижче).

Крок 1 — Створіть обліковий запис або увійдіть до BSG

Зареєструйтеся в кабінеті BSG та увійдіть. Якщо у вас уже є обліковий запис для SMS, Viber чи інших каналів, використовуйте той самий.

Крок 2 — Відкрийте канал WhatsApp

У лівому меню перейдіть до Products → Channels → WhatsApp, потім розпочніть процес підключення. (Якщо ваша навігація відрізняється, шукайте WhatsApp у розділі Channels.)

Крок 3 — Підключіть свій обліковий запис через Embedded Signup

Embedded Signup — це офіційне вікно підключення Meta. Вас попросять:

  1. Увійти за допомогою облікового запису Facebook/Meta, який керує вашим бізнесом.
  2. Переглянути та прийняти умови WhatsApp Business і Meta.
  3. Обрати свій Business Portfolio.
  4. Обрати свій WhatsApp Business Account — виберіть наявний WABA або створіть новий.
  5. Додати або обрати номер телефону, з якого ви надсилатимете повідомлення, та верифікувати його.
  6. Надати запитувані дозволи.

Коли ви завершите, BSG автоматично виконує технічне налаштування: безпечно обмінює вашу авторизацію на access token, підписується на сповіщення вашого облікового запису (webhooks), реєструє ваш номер для надсилання та синхронізує ваші шаблони, відправників та статус облікового запису на платформу.

Підключення наявного WABA: якщо ваш WABA був створений через інший застосунок або провайдера, Meta може не дозволити вам обрати його у вікні реєстрації — у такому разі поділіться ним з BSG через Meta Business Suite → Business Settings → WhatsApp Accounts.

Уже користуєтеся іншим провайдером? Вам не потрібно переносити все одразу. WhatsApp дозволяє підключити BSG як другого партнера на тому самому WABA, тож ви можете перевірити BSG на реальних надсиланнях, поки ваш поточний провайдер продовжує працювати, — а потім перенести свій основний номер, коли будете готові. Повний покроковий опис (включно з обмеженням на двох партнерів і тим, як відбувається перемикання) див. у Як підключити BSG як паралельного другого провайдера на Whatsapp.

Дізнайтеся більше про процес у документації Meta про Embedded Signup та про WhatsApp Business Accounts. Якщо ви зіткнетеся з проблемою під час підключення, див. Поширені помилки Embedded Signup (онбордингу) на BSG.

Крок 4 — Додайте спосіб оплати в Meta

З BSG ви отримуєте прямі ціни Meta без націнки, тож ви платите за трафік на платформі Meta. Додайте дійсний спосіб оплати до свого облікового запису Meta (WhatsApp Manager → Account tools → Payment settings), щоб ваші повідомлення були готові до надсилання. Ця оплата не пов'язана з оплатою послуг BSG. Див. як працює ціноутворення Meta.

Крок 5 — Верифікуйте свій Business Portfolio (рекомендовано)

Ми рекомендуємо починати з верифікованого Meta Business Portfolio.

  • Неверифікований: ваш portfolio починається з обмеження 250 унікальних отримувачів за кожні 24 години (rolling). Ви можете надсилати повідомлення такій кількості отримувачів (будь-які номери) одразу після підключення свого номера — див. документацію Meta про Embedded Signup.
  • Верифікований (і в міру того, як ви надсилаєте якісний трафік): ваш ліміт масштабується до 1 000 → 2 000 → 10 000 → 100 000 → без обмежень.

Це ліміти повідомлень від Meta, які розраховуються на рівні Business-Portfolio (спільні для всіх ваших номерів). Див. Ліміти повідомлень Meta. (Це окремо від вашого платформного ліміту BSG — див. FAQ.)

Крок 6 — Створіть та затвердіть свої шаблони у Meta

WhatsApp вимагає попередньо затверджених шаблонів для повідомлень, ініційованих бізнесом. Ви створюєте, редагуєте та подаєте шаблони на затвердження у WhatsApp Manager від Meta (або через API Meta) — не в BSG. Після затвердження BSG синхронізує їх у режимі лише для читання (приблизно щогодини), щоб ви могли їх надсилати.

  • Категорії: Marketing, Utility, Authentication. Затвердження зазвичай займає ~24–48 год для Utility/Authentication і до кількох днів для Marketing.
  • Ціна залежить від категорії та країни — Marketing значно дорожчий за Utility/Authentication. Шаблони Utility, надіслані у відкритому 24-годинному вікні, можуть бути безкоштовними. Див. ціноутворення.

Дізнайтеся більше про створення шаблонів та керування ними.

Крок 7 — Отримайте свій API key та встановіть свій WhatsApp callback

У лівому меню перейдіть до Management → Integrations & API → SMPP/API – password:

  • Live API Key — використовується для автентифікації ваших реальних запитів на надсилання. Тримайте його в секреті.
  • Test API Key — безпечний sandbox для розробки вашої інтеграції: він повертає зразкові дані, тож ви можете вільно тестувати, не надсилаючи реальних повідомлень і не сплачуючи за них.
  • Callback URL For WhatsApp — введіть HTTPS URL (включно з https://), куди BSG має надсилати ваші звіти WhatsApp. У міру просування кожного повідомлення BSG надсилає сюди оновлення з ID повідомлення, вашим reference, поточним статусом доставки (sent → delivered → read → failed) та, у разі невдачі, error code. (Пересилання вхідних повідомлень і натискань кнопок з'явиться тут у майбутньому.) Точний payload та поля див. у Callback-и WhatsApp на BSG. Натисніть Save.

Крок 8 — Надішліть своє перше повідомлення

З вашим Live API key та затвердженим шаблоном ви готові надсилати через API. Використовуйте той метод OneAPI, який підходить для вашого випадку, — кожна сторінка містить повний формат запиту, параметри та приклади:

Для ознайомлення з методами надсилання, структурою шаблону та відстеженням доставки див. Огляд BSG WhatsApp API.

Опціонально: SMS fallback

Якщо повідомлення WhatsApp не вдається доставити, BSG може автоматично надіслати його повторно як SMS — корисно для термінових повідомлень, таких як одноразові паролі.

  • Це opt-in для кожного запиту на надсилання. Включіть параметри SMS fallback (alternative-channel) — текст SMS та відправник — у той самий виклик API щоразу, коли вам потрібен резервний шлях доставки. Пропустіть їх, щоб надіслати лише через WhatsApp.
  • SMS оплачується окремо. Трафік WhatsApp тарифікується Meta; SMS fallback тарифікується BSG за його стандартними SMS-тарифами для країни призначення.

Ви включаєте параметри SMS fallback у запит Send Single WhatsApp Message або Send WhatsApp campaign — точні поля див. у цих методах OneAPI.

Розуміння ваших лімітів

Застосовуються два незалежні ліміти, і вони підраховуються окремо:

  • Ліміт повідомлень від Meta — зі скількома унікальними отримувачами ви можете розпочати розмови за кожні rolling 24 год на рівні Business-Portfolio. Починається з 250 (неверифікований) і масштабується з верифікацією та якістю.
  • Ваш платформний ліміт BSG — обсяг, включений у ваш тариф (за замовчуванням Free становить до 1 000 доставлених повідомлень); підвищіть його через свого менеджера облікового запису.

Про те, як працює кожен з них, як масштабувати і як вони взаємодіють, див. Ліміти WhatsApp на BSG.

Корисно знати

  • Meta є джерелом ваших шаблонів, відправників та WABA. Ви керуєте ними в Meta, а BSG віддзеркалює їх (синхронізовано ~щогодини), щоб ви могли надсилати й відстежувати, — враховуйте невелику затримку після внесення змін у Meta.
  • BSG є API-first. Ви надсилаєте через API та створюєте шаблони в Meta; конструктора шаблонів чи кампаній усередині BSG немає.
  • Наразі вихідний (1-way). Надсилайте затверджені шаблони та отримуйте статуси доставки вже зараз; пересилання вхідних з'явиться у майбутньому.
  • Щоб уникнути затримок у відправленнях, тримайте у Meta актуальний спосіб оплати. Оскільки BSG є Tech Provider у Meta, ви платите Meta напряму за обсяг — без націнки.
  • Кілька розширених типів шаблонів створюються через API Meta, а не через інтерфейс WhatsApp Manager.

FAQ

1. Чому кількість/ліміт моїх повідомлень у BSG відрізняється від того, що показує Meta? 
Вони вимірюються незалежно. BSG підраховує доставлені повідомлення, надіслані через BSG, у межах свого стандартного ліміту 1 000, тоді як Meta розраховує свій ліміт повідомлень окремо, на своєму боці, на рівні portfolio. Якщо у вас два провайдери, підключені до одного WABA паралельно, BSG відображає лише повідомлення, надіслані через BSG, — а не ті, що надіслані через іншого провайдера, — тож дві кількості не збігатимуться.

2. Як збільшити ліміт за замовчуванням у 1 000 повідомлень? 
Зверніться до свого менеджера облікового запису — платформний ліміт BSG підвищується за запитом.

3. Як збільшити мій ліміт повідомлень від Meta (наприклад, понад 250)? 
Верифікуйте свій Business Portfolio у Meta та продовжуйте надсилати якісний трафік; Meta масштабує ліміт автоматично (250 → 2 000 → 10 000 → 100 000 → без обмежень). Див. ліміти повідомлень.

4. Хто виставляє мені рахунок за повідомлення? 
Meta, напряму, за своїми опублікованими тарифами. BSG стягує плату лише за платформу — без націнки на трафік. Переконайтеся, що спосіб оплати збережено в Meta.

5. Де я створюю та редагую шаблони? 
У WhatsApp Manager від Meta (або через API Meta). BSG синхронізує ваші затверджені шаблони, щоб ви могли одразу їх надсилати, — немає потреби нічого відтворювати на нашому боці.

6. Не бачите свого наявного облікового запису WhatsApp у вікні реєстрації? 
Якщо ваш WABA був створений через інший застосунок або провайдера, Meta пропонує вам поділитися ним через Meta Business Suite → Business Settings → WhatsApp Accounts (використовуючи Business Portfolio ID від BSG), а не обирати його у вікні реєстрації.

7. Чи коштує SMS fallback додатково? 
Так. SMS fallback тарифікується BSG за стандартними SMS-тарифами для країни призначення, окремо від трафіку WhatsApp, за який ви платите Meta. Він спрацьовує лише якщо ви включили параметри fallback у свій запит на надсилання.

8. З яким номером мені тестувати? 
Meta наразі не доставляє маркетингові шаблони на номери США (+1), тож для тестування маркетингових надсилань використовуйте номер не зі США. Службові та автентифікаційні шаблони працюють усюди. Див. ліміти на користувача.

Наступні кроки та пов'язані посібники

Документація Meta

Пов'язані статті

Коментарі

0 коментарів

Стаття закрита для коментарів.