WhatsApp API для бізнесу: інтеграція, сповіщення, чат-боти
Клієнти пишуть у WhatsApp, а ви відповідаєте днями — або не відповідаєте взагалі. Замовлення губляться, підтримка перевантажена. За статистикою, до 60% користувачів надають перевагу месенджерам для зв'язку з бізнесом, а середній час відповіді у WhatsApp — менше 5 хвилин. Ми вирішуємо цю проблему: інтегруємо WhatsApp Business API з вашим сайтом так, щоб сповіщення про статуси замовлення, відповіді на питання та чат-бот працювали без збоїв. Наш досвід — понад 5 років на ринку, більше 30 реалізованих інтеграцій WhatsApp API, у тому числі для інтернет-магазинів з великим обігом. Впровадження окупається в середньому за 2–3 місяці, а навантаження на підтримку знижується на 40%.
Які проблеми вирішує WhatsApp Business API?
Типові помилки при самостійній інтеграції:
- Верифікація шаблонів: без правильно оформлених шаблонів не можна відправляти вихідні сповіщення. Ми готуємо шаблони, що проходять модерацію Meta з першого разу. 90% наших шаблонів проходять перевірку з першої спроби.
- 24-годинне вікно: багато хто забуває, що довільні повідомлення можна відправляти тільки в межах сесії. Ігнорування цього призводить до блокування номера на 24 години. Ми налаштовуємо коректне управління сесіями.
- Webhook та черги: вхідні повідомлення потрібно обробляти асинхронно, інакше API блокує запити. Використовуємо черги Laravel або Nest.js для надійної обробки.
Як підключити WhatsApp Business API до сайту?
Вибір способу підключення:
| Критерій | Meta Cloud API (прямий) | BSP-провайдер (Twilio, 360dialog) |
|---|---|---|
| Вартість | Безкоштовно (тільки за повідомлення) | Плата за повідомлення вища |
| Складність підключення | Потрібна верифікація Business Manager | Реєстрація за 1 день |
| Гнучкість | Повний контроль | Обмеження провайдера |
| Підтримка | Тільки документація Meta | Техпідтримка провайдера |
Для більшості проектів ми рекомендуємо прямий Cloud API — він дешевший і гнучкіший. Пряме підключення дозволяє економити до 70% на повідомленнях порівняно з BSP, а наш досвід дозволяє виконувати інтеграцію вдвічі швидше за середньоринкові терміни. BSP підходить, якщо потрібно швидко запуститися без глибокого технічного налаштування.
Як ми це робимо
Використовуємо PHP 8.3+ з Laravel 11, а для високонавантажених проектів — Nest.js (Node.js). Приклад відправки шаблонного повідомлення через Cloud API:
Приклад відправки шаблонного повідомлення
$response = Http::withToken(env('WHATSAPP_ACCESS_TOKEN'))
->post("https://graph.facebook.com/v19.0/{$phoneNumberId}/messages", [
'messaging_product' => 'whatsapp',
'to' => $phone,
'type' => 'template',
'template' => [
'name' => 'order_confirmation',
'language' => ['code' => 'ru'],
'components' => [
[
'type' => 'body',
'parameters' => [
['type' => 'text', 'text' => $orderId],
['type' => 'text', 'text' => $orderTotal . ' ₽']
]
]
]
]
]);
Шаблони повідомлень. Для вихідних сповіщень обов'язково використовувати попередньо схвалені шаблони. Шаблон створюється в Meta Business Manager і проходить перевірку (зазвичай 24–48 годин). Довільний текст у вихідних повідомленнях не можна відправляти — тільки в межах 24-годинного вікна сесії.
24-годинне вікно та сесійні повідомлення. Якщо користувач написав боту першим або відповів на шаблонне повідомлення — відкривається 24-годинне вікно, в яке можна відправляти довільні повідомлення. Це використовується для підтримки та діалогів:
Http::withToken($token)->post($url, [
'messaging_product' => 'whatsapp',
'to' => $phone,
'type' => 'text',
'text' => ['body' => "Ваше замовлення відправлено, трек-номер: {$trackNumber}"]
]);
Webhook для вхідних. Верифікація та обробка:
if ($request->has('hub_challenge')) {
if ($request->hub_verify_token === env('WHATSAPP_VERIFY_TOKEN')) {
return response($request->hub_challenge);
}
}
$body = $request->json()->all();
foreach ($body['entry'] as $entry) {
foreach ($entry['changes'] as $change) {
$messages = $change['value']['messages'] ?? [];
foreach ($messages as $message) {
dispatch(new ProcessWhatsAppMessageJob($message));
}
}
}
Інтерактивні кнопки. Дозволяють отримувати підтвердження від клієнта без введення тексту:
[
'type' => 'interactive',
'interactive' => [
'type' => 'button',
'body' => ['text' => 'Ваше замовлення готове до видачі. Підтвердьте отримання:'],
'action' => [
'buttons' => [
['type' => 'reply', 'reply' => ['id' => "confirm_{$orderId}", 'title' => 'Отримав ✓']],
['type' => 'reply', 'reply' => ['id' => "problem_{$orderId}", 'title' => 'Проблема']]
]
]
]
]
Як проходить процес інтеграції?
- Аналітика — вивчаємо поточні бізнес-процеси, визначаємо сценарії сповіщень.
- Проектування — розробляємо архітектуру: вебхуки, черги, шаблони.
- Реалізація — налаштовуємо Cloud API або BSP, пишемо інтеграційний код.
- Тестування — перевіряємо відправку, прийом, обробку помилок.
- Деплой — запускаємо на продакшен, моніторимо перші дні.
Що входить в роботу
- Налаштування WhatsApp Business API (прямий або через BSP).
- Створення шаблонів повідомлень для замовлень, оплат, статусів.
- Реалізація вебхука для обробки вхідних повідомлень.
- Інтеграція з вашою CRM або сайтом.
- Документація по API та інструкція для адміністраторів.
- Навчання співробітників роботі з системою.
- Гарантія якості: 30 днів безкоштовної підтримки після запуску.
Строки та вартість
Базова інтеграція (сповіщення + вхідні) — від 3 до 5 днів, вартість від 5000 грн. Повний проект з чат-ботом та кастомними сценаріями — від 7 до 14 днів, вартість від 15 000 грн. Точна ціна розраховується індивідуально — напишіть нам для оцінки.
Типові помилки при інтеграції WhatsApp Business
Типові помилки при самостійному підключенні: використання номера, вже прив'язаного до особистого WhatsApp; неправильна конфігурація вебхука; відправка непідтверджених шаблонів; ігнорування лімітів API; відсутність обробки помилок. Ми допомагаємо уникнути цих проблем завдяки багаторічному досвіду.
Порівняння типів повідомлень
| Тип повідомлення | Коли використовується | Потрібен шаблон |
|---|---|---|
| Шаблонне | Вихідне сповіщення (замовлення, оплата) | Так |
| Сесійне | Всередині 24-годинного вікна (підтримка) | Ні |
| Інтерактивне | Підтвердження дії (кнопки) | Ні, але можна в шаблоні |
Отримайте безкоштовну консультацію по вашому проекту — оцінимо задачу і запропонуємо оптимальне рішення. Замовте інтеграцію, і ми зв'яжемося протягом години.
Детальніше про можливості API читайте в офіційній документації WhatsApp Business API.