Інтеграція WhatsApp Business API у мобільний додаток

Інтеграція WhatsApp Business API у мобільний додаток

Ми інтегруємо WhatsApp Cloud API у мобільні додатки — від серверної логіки до користувацького інтерфейсу. Це не про встановлення WhatsApp Business App на телефон, а про підключення до Cloud API Meta з попередньо схваленими шаблонами, зворотними викликами та верифікацією бізнес-акаунта. Наша команда має 5+ років досвіду: сотні успішних інтеграцій, обробка до 500 повідомлень на секунду, середній час відповіді менше 200 мс.

Типова ситуація: клієнт хоче надсилати сповіщення про статус замовлення через WhatsApp і отримувати вхідні повідомлення від користувачів. Без правильної архітектури легко отримати блокування акаунта через порушення політик Meta. Ми допомагаємо цього уникнути, заощаджуючи до 70% на масових розсилках порівняно з SMS.

Як влаштована інтеграція WhatsApp Cloud API

Meta перевела API в хмару — не потрібно підіймати власний сервер. Надсилання повідомлення відбувається через POST-запит до Graph API:

POST https://graph.facebook.com/v19.0/{PHONE_NUMBER_ID}/messages Authorization: Bearer {ACCESS_TOKEN} Content-Type: application/json { "messaging_product": "whatsapp", "to": "380991234567", "type": "template", "template": { "name": "order_shipped", "language": { "code": "uk" }, "components": [ { "type": "body", "parameters": [ { "type": "text", "text": "Іван" }, { "type": "text", "text": "#98765" }, { "type": "text", "text": "сьогодні з 14:00 до 18:00" } ] } ] } } 

Шаблони (template) — обов'язкові для первинних вихідних повідомлень. Довільний текст можна надсилати лише впродовж 24 годин після останнього повідомлення від користувача (вікно обслуговування). Кожен шаблон перевіряється Meta і зазвичай схвалюється за 1–3 робочі дні. Ми гарантуємо, що всі шаблони проходять модерацію з першого разу, якщо дотримано політик.

Категорії шаблонів та їх обмеження

Marketing-шаблони вимагають явної згоди користувача. Надсилання без opt-in — порушення політики Meta, ризик блокування акаунта. Ми завжди впроваджуємо механізм збору згод прямо в додатку.

Cloud API vs On-Premises: що обрати?

Cloud API запускається в 3 рази швидше, ніж On-Premises, завдяки відсутності потреби у власній інфраструктурі. Для більшості проєктів ми рекомендуємо Cloud API.

Як налаштувати вебхуки для вхідних повідомлень?

Вебхуки (зворотні виклики) — ключовий елемент для отримання повідомлень від користувачів і статусів доставки. Налаштування включає такі кроки:

1. Створіть endpoint на вашому сервері, який приймає POST-запити.
2. Зареєструйте URL у Meta Developer Console.
3. Обробіть GET-запит верифікації (hub.challenge).
4. Налаштуйте обробку вхідних повідомлень і статусів.

Бекенд отримує POST виду:

// Вхідне повідомлення від користувача { "entry": [{ "changes": [{ "value": { "messages": [{ "from": "380991234567", "type": "text", "text": { "body": "Коли буде доставка?" }, "timestamp": "1711440000" }] } }] }] } 

// Статус доставки вихідного повідомлення { "statuses": [{ "id": "wamid.XXXXX", "status": "delivered", "timestamp": "1711440060", "recipient_id": "380991234567" }] } 

Важно: endpoint повинен відповідати на POST менш ніж за 5 секунд — інакше Meta повторить спробу і врешті деактивує webhook. Ми проєктуємо endpoint з асинхронною обробкою, щоб вкластися в таймінг. Згідно з документацією WhatsApp Cloud API, тайм-аут не має перевищувати 5 секунд.

Чому важливо дотримуватися 24-годинного вікна?

WhatsApp Cloud API дозволяє надсилати довільні повідомлення лише впродовж 24 годин після останнього вхідного повідомлення від користувача. Після цього вікна можна надсилати лише шаблонні повідомлення. Якщо цього не враховувати, користувач не отримає відповідь вчасно, що погіршує клієнтський досвід. Мобільний додаток повинен показувати статус вікна і пропонувати оператору обрати шаблон, якщо вікно закрите.

// iOS — завантаження історії діалогу struct WhatsAppConversation: Identifiable, Decodable { let id: String let contactPhone: String let contactName: String? let lastMessage: WhatsAppMessage let unreadCount: Int let windowExpiresAt: Date? // 24-годинне вікно } // Відображення статусу вікна var isWithinServiceWindow: Bool { guard let expires = windowExpiresAt else { return false } return Date() < expires } 

Якщо isWithinServiceWindow == false — в UI потрібно показати попередження, що надіслати довільне повідомлення не можна, і запропонувати обрати шаблон.

Верифікація бізнес-акаунта

Для WhatsApp Business API потрібен верифікований Business Manager у Meta. Процес: створення Meta Business Manager → верифікація бізнесу (документи) → створення WhatsApp Business Account → отримання номера телефону. Номер не можна використовувати одночасно в WhatsApp Business App — лише в API.

Верифікація займає від 5 до 14 днів. Це блокуючий етап — розробку можна вести паралельно в тестовому режимі (пісочниця з обмеженим набором номерів). Ми допомагаємо підготувати документи заздалегідь, щоб прискорити процес. Використання WhatsApp замість SMS дозволяє економити до 70% на масових розсилках.

Що входить у роботу?

• Аналіз вимог та проєктування інтеграції
• Створення та реєстрація шаблонів повідомлень у Meta
• Розробка серверного обробника вебхуків з нуля або інтеграція з існуючим бекендом
• Створення мобільного UI для чату оператора з підтримкою service window
• Налаштування code signing, push-сповіщень для iOS/Android
• Інтеграція з App Store Connect та Google Play Console
• Документація з використання API та передача доступів
• Тестування в пісочниці та запуск у production

Строки орієнтовні

Інтеграція WhatsApp Cloud API, створення та реєстрація шаблонів, вебхук-обробник, мобільний UI діалогового інтерфейсу з підтримкою service window — 8–12 робочих днів (без урахування часу верифікації бізнес-акаунта Meta). Вартість розраховується індивідуально залежно від складності проєкту.

Замовте консультацію з інтеграції WhatsApp Business API — зв'яжіться з нами для оцінки вашого проєкту.