Інтеграція з WhatsApp

Попередні вимоги

• Акаунт Facebook або керований акаунт Meta.
• Реєстрація в якості розробника.
  Якщо ви ще не зареєстровані, відвідайте сторінку реєстрації розробників і дотримуйтесь інструкцій.
• Пристрій із підтримкою WhatsApp для надсилання та отримання тестових повідомлень.

1. Створення нового додатка Meta за допомогою WhatsApp

1. Відкрийте панель керування додатками Meta, щоб створити новий додаток.
2. Натисніть Create App (Створити додаток).
3. Вкажіть назву вашого додатка та вашу електронну адресу.
4. Виберіть сценарій використання Connect with customers through WhatsApp і натисніть Next.
5. Виберіть наявне бізнес-портфоліо або створіть нове.
6. На екрані з'явиться список вимог до публікації. На цьому етапі у вас може не бути жодних вимог. Натисніть Next.
7. Підтвердіть свої дані, сценарій використання та бізнес-портфоліо. Натисніть Previous, щоб внести зміни, або Create app, щоб завершити створення додатка.

2. Налаштування сценарію використання (Use Case)

Налаштуйте параметри сценарію використання та права доступу.

Етап 1. Тестування (Try it out)

Надішліть повідомлення зі свого тестового номера, щоб зрозуміти, як працює API WhatsApp:

1. Натисніть Generate token, щоб створити тимчасовий токен доступу для відправки тестового повідомлення.
2. Виберіть тестовий номер телефону відправника з випадного меню.
3. У полі Recipient додайте номер телефону, на який буде надіслано тестове повідомлення.
4. Натисніть кнопку Send message, щоб надіслати ваше перше повідомлення.

Етап 2. Робоче налаштування (Production setup)

Створіть один або кілька акаунтів, щоб зв'язуватися з клієнтами через API WhatsApp:

1. Розділ Configure Webhooks поки що пропустимо (налаштування Webhooks детально описано у Кроці 5).
2. У розділі Register your WhatsApp phone number натисніть кнопку Add new number і дотримуйтесь інструкцій, щоб додати та підтвердити свій номер WhatsApp Business.
   • Важливо: Після підключення в панелі налаштувань відобразиться ID вашого номера WhatsApp Business. Скопіюйте та збережіть його для використання на наступних етапах.
3. У розділі Add payment to send business-initiated messages прив'яжіть спосіб оплати для надсилання повідомлень, ініційованих компанією. Перейдіть у Billing Hub, натисніть Add payment method і дотримуйтесь інструкцій.
4. Для відправки повідомлень через API потрібно створити постійний токен доступу (докладніше у Кроці 3).

Етап 3. Підтвердження компанії (Business verification)

Завантажте документи для перевірки Meta:

1. Ознайомтеся з тим, що таке перевірка бізнесу (підтвердження реєстрації компанії для її легітимності) та які додаткові переваги WhatsApp це відкриває.
2. Натисніть кнопку Start verification і завершіть процедуру підтвердження бізнесу, дотримуючись інструкцій на екрані.

3. Створення системного користувача та генерація постійного токена

Вам необхідно створити постійний токен для використання на всій платформі WhatsApp Business.

1. Перейдіть у розділ Business Settings і натисніть System users на бічній панелі.
2. Натисніть кнопку +Add у правому верхньому куті та дотримуйтесь інструкцій, щоб створити нового системного користувача.
3. Виберіть створеного користувача та натисніть Assign Assets.
   • У розділі Apps виберіть свій додаток і увімкніть параметр Manage app (у блоці Full control).
   • У розділі WhatsApp account виберіть свій акаунт WhatsApp і увімкніть параметр Everything (у блоці Full control).
   • Натисніть кнопку Assign assets.
4. Натисніть Generate token.
   • Дотримуйтесь інструкцій щодо генерації токена.
   • Обов'язково додайте до токена такі дозволи (Assign permissions):
     • whatsapp_business_messaging
     • whatsapp_business_management
   • Скопіюйте згенерований токен і надійно збережіть його.

4. Налаштування Gincore

1. Відкрийте ваш додаток у Meta, перейдіть до розділу App settings > Basic. Скопіюйте значення App secret і збережіть його.
2. У системі Gincore перейдіть до меню: Більше > Налаштування > Інтеграція з чатами.
   • У блоці «Інтеграція з чатами» натисніть кнопку +Додати.
   • Як «Джерело чатів» виберіть WhatsApp і вкажіть збережені раніше дані:
     • Маркер доступу — постійний токен користувача (з Кроку 3).
     • App secret — App secret (з пункту 4.1).
     • ID номера телефону — ID номера WhatsApp Business (з Кроку 2, етап 2).
3. Після збереження у вікні налаштувань Gincore з'являться Webhook (URL) та Токен для перевірки вебхуку. Обов'язково скопіюйте та збережіть їх.

5. Налаштування Webhooks у Meta

Повертаємося назад до панелі додатка Meta, щоб завершити налаштування Webhooks, яке ми пропустили раніше.

1. Відкрийте сторінку Use cases > Connect with customers through WhatsApp > Customize і перейдіть до Step 2. Production setup.
2. У розділі Configure Webhooks введіть дані, скопійовані з Gincore, і натисніть кнопку Verify and save:
   • Callback URL — вставте Webhook (URL).
   • Verify token — вставте Токен для перевірки вебхуку.
3. Після успішної перевірки необхідно налаштувати Field Webhooks (підписатися на окремі поля). Обов'язково виберіть:
   • user_preferences
   • messages

6. Завершення та публікація

• У розділі Publish виконайте публікацію додатка. Переконайтеся, що всі вимоги виконані, а сценарії використання додані коректно.
• Обов'язково додайте посилання на політику конфіденційності. Для цього перейдіть у App settings > Basic і заповніть поле Privacy policy URL. Також заповніть решту контактної інформації про компанію.
• Ще раз перевірте налаштування сценарію використання Connect with customers through WhatsApp і результати перевірки додатка (див. Крок 2).