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.