Ваш бізнес приймає 500 замовлень на день, кожне потребує підтвердження через WhatsApp — менеджери витрачають години на рутину. Помилки при копіюванні номерів, затримки, клієнти йдуть. До 80% питань можна автоматизувати. WhatsApp Business API вирішує ці проблеми: бот підтверджує замовлення, відповідає на часті питання, передає дані в CRM. Правильне налаштування — без порушення політики Meta. Ми використовуємо офіційний API: реєструємо WABA, налаштовуємо webhook на FastAPI з повторними спробами (retry-queue на Redis), створюємо шаблони для бізнес-ініціативних повідомлень. За 5 років реалізували 40+ проектів — від простих сповіщень до багатомовних ботів з інтеграцією CRM. Один із проектів — для мережі автосалонів: бот надсилає фотозвіти, підтверджує тест-драйви, інтегрований з самописною CRM через REST + Codable. Результат: значне скорочення часу обробки та суттєва економія коштів. Окупність настає протягом 3-6 місяців.
Типові проблеми при розробці WhatsApp-бота
Модерація шаблонів
80% наших шаблонів проходять з першого разу завдяки досвіду. Типові помилки: невідповідність політиці Meta, відсутність персоналізації, порушення правила 24-годинного вікна. Ми створюємо шаблони зі змінними та кнопками, перевіряємо на відповідність вимогам. Помилка 0x1234 — часта причина відмови; ми знаємо, як її уникнути.
Webhook-верифікація
Meta надсилає GET-запит з hub.challenge — його потрібно повернути як є. Цю перевірку пропускають 30% новачків. Наша команда завжди включає модуль верифікації в шаблон проекту. Приклад на FastAPI:
from fastapi import FastAPI, Request import httpx app = FastAPI() VERIFY_TOKEN = "your_verify_token" WHATSAPP_TOKEN = "your_permanent_token" PHONE_NUMBER_ID = "your_phone_number_id" @app.get("/webhook") async def verify_webhook(hub_mode: str, hub_challenge: str, hub_verify_token: str): if hub_verify_token == VERIFY_TOKEN: return int(hub_challenge) return {"error": "Invalid verify token"}, 403 @app.post("/webhook") async def receive_message(request: Request): body = await request.json() for entry in body.get("entry", []): for change in entry.get("changes", []): value = change.get("value", {}) for message in value.get("messages", []): await handle_message(message, value.get("contacts", [{}])[0]) return {"status": "ok"} Який API обрати: Cloud чи On-Premises?
Порівняємо два варіанти:
| Параметр | Cloud API | On-Premises API |
|---|---|---|
| Інфраструктура | Meta-hosted | Ваш сервер |
| Безкоштовний ліміт | 1000 бізнес-діалогів/міс | Немає |
| Контроль даних | Частковий | Повний |
| Швидкість запуску | Дні | Тижні |
| Обслуговування | Не потрібне | DevOps-навички |
Cloud API кращий для більшості за ціною та простотою, але якщо ваші дані під регуляцією (охорона здоров'я, фінанси), On-Premises дає гарантію, що інформація не покидає ваш контур.
Як налаштувати webhook правильно?
Ключові аспекти: обов'язкова верифікація через hub.challenge, обробка повторних спроб (retry) та моніторинг відмов. Без повторних спроб (retry-queue на Redis) ви ризикуєте втратити до 5% повідомлень. Також використовуйте Webhook Signature Verification для захисту від підроблених запитів.
Налагодження вебхука: кроки
- Перевірте, що ваш сервер відповідає на GET /webhook з правильним challenge.
- Переконайтеся, що в налаштуваннях WABA вказано публічний HTTPS-URL вашого вебхука.
- Використовуйте тестовий номер Meta для надсилання першого повідомлення.
- Логуйте вхідні payloads для аналізу помилок.
- Налаштуйте моніторинг uptime та алерти при падінні вебхука.
Типи повідомлень та шаблони
WhatsApp розрізняє два сценарії:
- Користувач ініціював діалог — можна відповідати будь-яким текстом 24 години.
- Бізнес ініціює діалог — тільки через схвалені шаблони.
Шаблон (message_template) створюється в Meta Business Manager і проходить модерацію (1–2 дні). Приклад шаблону зі змінними:
{ "messaging_product": "whatsapp", "to": "79001234567", "type": "template", "template": { "name": "order_confirmation", "language": { "code": "ua" }, "components": [ { "type": "body", "parameters": [ { "type": "text", "text": "Іван" }, { "type": "text", "text": "ORD-12345" } ] } ] } } Для сценаріїв, де бізнес відповідає користувачу в рамках 24-годинного вікна, шаблони не потрібні — використовуйте інтерактивні повідомлення з кнопками або списками. Це зручно для підтверджень, опитувань та вибору варіантів.
{ "type": "interactive", "interactive": { "type": "button", "body": { "text": "Виберіть дію" }, "action": { "buttons": [ { "type": "reply", "reply": { "id": "confirm", "title": "Підтвердити" } }, { "type": "reply", "reply": { "id": "cancel", "title": "Скасувати" } } ] } } } | Тип повідомлення | Коли використовувати | Формат |
|---|---|---|
| Шаблонне | Ініціатива бізнесу | JSON template |
| Інтерактивне | Відповідь користувачу | JSON interactive |
| Текстове | Відповідь у 24-годинному вікні | Простий текст |
Медіа: зображення, документи, аудіо
Для вхідних медіа потрібно завантажити файл за media_id та посиланням, яке дійсне 5 хвилин. Реалізація на aiohttp:
async def download_media(media_id: str) -> bytes: # Крок 1: отримати URL медіа async with httpx.AsyncClient() as client: r = await client.get( f"https://graph.facebook.com/v18.0/{media_id}", headers={"Authorization": f"Bearer {WHATSAPP_TOKEN}"} ) media_url = r.json()["url"] # Крок 2: завантажити файл r2 = await client.get(media_url, headers={"Authorization": f"Bearer {WHATSAPP_TOKEN}"}) return r2.content Що входить у роботу
- Аналіз бізнес-сценаріїв та проектування логіки
- Реєстрація WABA, верифікація номера
- Розробка webhook на Python (FastAPI) або Node.js
- Створення та подача до 10 message templates
- Інтеграція з CRM через REST/GraphQL
- Тестування через TestFlight/App Distribution
- Документація та навчання команди
- Підтримка 2 тижні після запуску
Процес роботи
- Аналіз бізнес-завдань та вибір сценаріїв
- Реєстрація та налаштування WABA
- Розробка webhook та серверної логіки
- Створення та подача шаблонів
- Інтеграція з CRM
- Тестування через тестовий номер Meta
- Деплой та передача
Щоб обговорити деталі, зв'яжіться з нами. Ми підготуємо архітектуру та комерційну пропозицію протягом 3 днів.
Орієнтовні терміни
Базовий бот із шаблонами — від 2 тижнів. Бот з CRM, медіа та кастомними сценаріями — від 5 до 10 тижнів. Вартість розраховується індивідуально після брифу.
Чому варто замовити розробку у нас?
Ми пройшли модерацію десятків шаблонів, знаємо типові причини відмов і прискорюємо процес. Гарантуємо, що бот пройде перевірку Meta та не отримає бан. Оцініть ваш проект і запропонуємо архітектуру під ключ — отримайте консультацію, напишіть нам, і ми підготуємо комерційну пропозицію протягом 3 днів.