Поширені помилки Embedded Signup (онбордингу) на BSG

Ви підключаєте свій обліковий запис WhatsApp до BSG через процес Meta Embedded Signup. Будь-які проблеми тут виникають під час підключення — ще до того, як ви щось надішлете. Як і під час надсилання, BSG показує власні помилки Meta, а повний перелік наведено в документації Meta Embedded Signup flow errors.

Цей посібник охоплює ті, з якими ви найімовірніше зіткнетеся. (Про помилки під час надсилання див. Поширені помилки WhatsApp API (надсилання).)

Як Embedded Signup повідомляє про проблеми

Embedded Signup працює у спливному вікні та надсилає повідомлення-event на сторінку, яка його відкрила:

• ERROR — щось не вдалося під час процесу.
• CANCEL — користувач закрив процес, не завершивши його. Поле data.current_step у корисному навантаженні вказує, на якому екрані він перебував, тож ви можете скерувати його назад:

{ "data": { "current_step": "PHONE_NUMBER_VERIFICATION" },
  "type": "WA_EMBEDDED_SIGNUP", "event": "CANCEL", "version": 3 }

До кроків належать BUSINESS_ACCOUNT_SELECTION, WABA_PHONE_PROFILE_PICKER, WHATSAPP_BUSINESS_PROFILE_SETUP, PHONE_NUMBER_SETUP, PHONE_NUMBER_VERIFICATION та PERMISSIONS.

Найпоширеніші проблеми онбордингу

1. У вас немає дозволу створювати/вибирати WhatsApp Business Account

Meta: "User does not have permission to create WhatsApp Business Accounts."

Чому ви можете це побачити: ви не є Admin вибраного вами Meta Business Portfolio.

Що робити: отримайте доступ рівня Admin до цього Business Portfolio (або виберіть той, який ви адмініструєте), а потім повторіть спробу.

2. Ви не можете вибрати свій наявний WhatsApp Business Account

Чому ви можете це побачити: Meta не дозволяє вибирати WABA в Embedded Signup, якщо його було створено через інший застосунок або провайдера.

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

3. Ваш WABA вже підключено до двох partners

Чому ви можете це побачити: WABA можна надати у спільний доступ щонайбільше двом partners одночасно, тож BSG не вдасться додати третім.

Що робити: у Meta Business Settings → WhatsApp Accounts → [ваш WABA] → Partners видаліть одного з наявних partners, щоб звільнити місце, а потім повторно запустіть підключення. (Повний процес див. у Як підключити BSG як паралельного другого провайдера на Whatsapp.)

4. Ваш обліковий запис Facebook/Business занадто новий або позначений

Meta: напр. "Your Facebook account is too new to create a business account. Try again in an hour," або повідомлення про обмеження щодо кількості бізнесів, які ви можете створити.

Чому ви можете це побачити: зовсім нові або раніше позначені облікові записи Facebook обмежені у створенні Business/WhatsApp облікових записів.

Що робити: використовуйте давно створений, активний обліковий запис Facebook із правами Admin або зачекайте та повторіть спробу.

5. Процес було закрито до завершення (CANCEL)

Чому ви можете це побачити: користувач вийшов на одному з екранів (дозволи, підтвердження номера телефону тощо).

Що робити: прочитайте data.current_step з event CANCEL, щоб побачити, де він зупинився, і запропонуйте йому продовжити — найчастіше на PHONE_NUMBER_VERIFICATION (він не ввів код) або PERMISSIONS (він не надав доступ).

Проблеми онбордингу можуть проявитися пізніше як помилки надсилання

Деякі проблеми налаштування не блокують процес, але спричиняють збої, щойно ви починаєте надсилати — наприклад, відсутність payment method у Meta (помилка надсилання 131042) або неповна реєстрація номера телефону. Якщо ваше підключення завершилося, але надсилання не вдаються, звірте з Поширені помилки WhatsApp API (надсилання).

Де знайти всі інші помилки

Оскільки BSG віддзеркалює Meta, будь-яка помилка онбордингу, не наведена тут, описана в документації Meta Embedded Signup flow errors.

Пов'язані посібники

• Початок роботи з 1-way WhatsApp на BSG — повний покроковий опис підключення.
• Як підключити BSG як паралельного другого провайдера на Whatsapp — підключення поряд із наявним провайдером.
• Поширені помилки WhatsApp API (надсилання) — проблеми під час надсилання.