WhatsApp 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' => 'Проблема']] ] ] ] ] 

Як проходить процес інтеграції?

1. Аналітика — вивчаємо поточні бізнес-процеси, визначаємо сценарії сповіщень.
2. Проектування — розробляємо архітектуру: вебхуки, черги, шаблони.
3. Реалізація — налаштовуємо Cloud API або BSP, пишемо інтеграційний код.
4. Тестування — перевіряємо відправку, прийом, обробку помилок.
5. Деплой — запускаємо на продакшен, моніторимо перші дні.

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

• Налаштування WhatsApp Business API (прямий або через BSP).
• Створення шаблонів повідомлень для замовлень, оплат, статусів.
• Реалізація вебхука для обробки вхідних повідомлень.
• Інтеграція з вашою CRM або сайтом.
• Документація по API та інструкція для адміністраторів.
• Навчання співробітників роботі з системою.
• Гарантія якості: 30 днів безкоштовної підтримки після запуску.

Строки та вартість

Базова інтеграція (сповіщення + вхідні) — від 3 до 5 днів, вартість від 5000 грн. Повний проект з чат-ботом та кастомними сценаріями — від 7 до 14 днів, вартість від 15 000 грн. Точна ціна розраховується індивідуально — напишіть нам для оцінки.

Типові помилки при інтеграції WhatsApp Business

Типові помилки при самостійному підключенні: використання номера, вже прив'язаного до особистого WhatsApp; неправильна конфігурація вебхука; відправка непідтверджених шаблонів; ігнорування лімітів API; відсутність обробки помилок. Ми допомагаємо уникнути цих проблем завдяки багаторічному досвіду.

Порівняння типів повідомлень

Отримайте безкоштовну консультацію по вашому проекту — оцінимо задачу і запропонуємо оптимальне рішення. Замовте інтеграцію, і ми зв'яжемося протягом години.

Детальніше про можливості API читайте в офіційній документації WhatsApp Business API.