Як підключити Viber до сайту: сповіщення, чат-бот та API

Клієнт не отримує сповіщення про статус замовлення — конверсії падають, підтримка захлинається питаннями. Кожен пропущений статус знижує лояльність: за даними нашого аналізу, до 30% покупців йдуть після двох прострочок інформування. Ми вирішуємо це завдання через інтеграцію Viber Business з сайтом. Підключаємо відправку транзакційних повідомлень, чат-бота та кнопку Viber за 2–5 днів. Гарантуємо стабільну роботу та економію до 70% бюджету на SMS (наприклад, 1000 грн/міс для 10 000 повідомлень). Viber Business Messages дозволяє надсилати до 10 000 повідомлень на день безкоштовно (за даними офіційної документації Viber). У країнах СНД Viber — другий за популярністю месенджер, його відкриваність перевищує 80%. Перехід на Viber-сповіщення дає швидкий приріст повернення клієнтів. Viber повідомлення в 5 разів ефективніші за email. Viber Business на 70% дешевший за SMS при масових розсилках, а інтеграція Viber у 2 рази швидша за інтеграцію WhatsApp.

Що ви отримаєте?

• Транзакційні сповіщення — статуси замовлень, підтвердження оплати, коди доступу. Користувачі в СНД читають Viber частіше, ніж email.
• Зниження навантаження на підтримку — чат-бот відповідає на типові питання "Де моє замовлення?", "Статус доставки?", — до 60% звернень йде в автомат.
• Кнопка Viber на сайті — один клік для переходу в діалог, підвищення конверсії в ліди на 15–25%.

Як підключити Viber Business до сайту?

Viber Business Messages — офіційний канал для сповіщень та маркетингу. На відміну від безкоштовного бота, Business Account може ініціювати діалог (за згодою користувача). Ми використовуємо Viber REST API або підключаємо через агрегаторів (SMSC Viber, Infobip, MessageBird) — єдиний інтерфейс для Viber, WhatsApp, SMS. Вибір залежить від обсягу та географії аудиторії.

Типи акаунтів

Для завдань з масовою розсилкою або сповіщеннями про статуси потрібен Viber Business Account. Якщо тестуєте — підійде і бот.

Практична реалізація

Кроки підключення

1. Реєстрація Business Account на порталі Viber та отримання токену.
2. Налаштування webhook для прийому подій.
3. Розробка модуля відправки повідомлень через Viber REST API.
4. Інтеграція з CRM або кошиком для автоматичної відправки сповіщень Viber.
5. Тестування всіх сценаріїв (успіх, помилки, відписки).
6. Деплой на production та моніторинг.

Відправка через Viber REST API

$authToken = env('VIBER_BOT_TOKEN');

// Відправка текстового повідомлення
$response = Http::withHeaders([
    'X-Viber-Auth-Token' => $authToken
])->post('https://chatapi.viber.com/pa/send_message', [
    'receiver' => $viberUserId,  // унікальний Viber ID користувача
    'type'     => 'text',
    'text'     => "Ваше замовлення #{$orderId} передано в доставку.",
    'sender'   => ['name' => 'Мій Магазин']
]);

Повідомлення з кнопкою

Http::withHeaders(['X-Viber-Auth-Token' => $authToken])
    ->post('https://chatapi.viber.com/pa/send_message', [
        'receiver' => $viberUserId,
        'type'     => 'rich_media',
        'rich_media' => [
            'Type'             => 'rich_media',
            'ButtonsGroupRows' => 2,
            'Buttons'          => [
                [
                    'Columns'    => 6,
                    'Rows'       => 1,
                    'Text'       => 'Відстежити замовлення',
                    'ActionType' => 'open-url',
                    'ActionBody' => $trackingUrl  // реальне посилання на відстеження
                ]
            ]
        ]
    ]);

Webhook та обробка вхідних

// Реєстрація webhook
Http::withHeaders(['X-Viber-Auth-Token' => $authToken])
    ->post('https://chatapi.viber.com/pa/set_webhook', [
        'url'         => env('VIBER_WEBHOOK_URL'),
        'event_types' => ['delivered', 'seen', 'failed', 'subscribed', 'unsubscribed', 'conversation_started', 'message']
    ]);

// Обробник
Route::post('/webhooks/viber', function (Request $request) {
    $event = $request->json()->all();
    $type  = $event['event'];

    if ($type === 'message') {
        $userId = $event['sender']['id'];
        $text   = $event['message']['text'];
        dispatch(new ProcessViberMessageJob($userId, $text));
    }

    if ($type === 'subscribed') {
        // Користувач підписався на бота
        ViberUser::updateOrCreate(['viber_id' => $event['user']['id']], [...]]);
    }

    return response()->json(['status' => 0]);  // 0 = OK для Viber
});

Отримання Viber ID користувача

Viber ID приходить у подіях conversation_started (перший діалог) або subscribed. Потрібно зберегти зв'язок user_id → viber_id в БД.

Відправка через агрегаторів (SMSC Viber)

Для відправки Viber-повідомлень без власного бота можна використовувати SMSC Viber — він підтримує Viber Business Messages через єдиний API.

Обсяг та терміни робіт

Етапи інтеграції

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

• Підготовка та верифікація Viber Business Account
• Налаштування webhook та обробка подій (message, subscribed, failed)
• Інтеграція з вашою CRM / кошиком (Laravel, WordPress, кастом)
• Реалізація шаблонів повідомлень (текст, кнопки, медіа)
• Чат-бот на базі Viber Chatbot API (опціонально)
• Тестування: функціональне, навантажувальне, відмовостійкість
• Документація: опис API, інструкція для операторів
• Навчання операторів роботі з чат-ботом та сповіщеннями
• Доступи до API та акаунту Viber Business
• Підтримка протягом 30 днів після здачі

Вартість та порівняння

Viber Business Messages у 3–4 рази дешевший за SMS у країнах СНД. Вартість повідомлень Viber Business — від 0.01€ за штуку, що при 10 000 повідомлень на місяць складає близько 100€. Відкриваність повідомлень у 5 разів вища за email (80–90% проти 10–15%).

Оцініть ваш проект — напишіть нам, і ми запропонуємо рішення під ключ. Інтеграція займає від 2 до 5 днів. Більше 5 років досвіду з Viber API — гарантуємо стабільну роботу без сюрпризів. Ми спеціалізуємося на інтеграції месенджерів, зокрема Viber Business Messages. Зв'яжіться з нами для консультації щодо вашого проекту. Отримайте пропозицію з індивідуальним кошторисом і термінами.

Інтеграція email розсилок: чому вона часто ламається?

Ми стикалися з тим, що тригерний лист через 10 хвилин після реєстрації конвертує в 4–5 разів краще, ніж той самий лист через 24 години. Це не маркетинговий міф — це механіка: поки користувач теплий, поки пам'ятає контекст. Але більшість інтеграцій з розсильниками зроблені так: форма сабмітиться → синхронний HTTP-запит до API → якщо API гальмує, користувач чекає 3 секунди → лист йде або не йде, ніхто не знає.

Якщо ви зіткнулися з втраченими листами або потраплянням у спам, замовте аудит існуючої інтеграції — ми знайдемо вузькі місця за 2 дні.

Провайдери та їх API

Unisender — російський провайдер, популярний у сегменті SMB. REST API, простий. Додавання контакту: importContacts, відправка транзакційного листа: sendEmail. Важливо: для транзакційних листів (підтвердження замовлення, скидання пароля) Unisender Go — окремий сервіс з іншим API та окремою ціною. Змішувати масові розсилки та транзакційні в одному потоці — погана ідея для репутації домену.

SendPulse — надає email, SMS, web push, Viber, Telegram-боти через єдиний API. Для проєктів, де потрібен омніканал, це зручно. Automation 360 — візуальний конструктор ланцюжків, можна запустити автоматизацію через API event. SDK для PHP (sendpulse/rest-api-php-sdk) підтримується, але оновлюється нерегулярно — краще використовувати напряму через Guzzle.

Mailchimp — вибір для міжнародної аудиторії та маркетингових команд, звиклих до екосистеми Mailchimp. Transactional email — через Mandrill (дочірній сервіс). Marketing API v3 для управління списками, тегами, кампаніями. Webhook для подій: відкриття, клік, відписка, bounce.

SMS. Для Росії: СМСЦ, МТС Exolve, Devino Telecom, SMS Aero. API у всіх схожий: метод send, параметри phone, message, sender (ім'я відправника — потрібно реєструвати окремо у оператора). Один нюанс: ім'я відправника має бути зареєстровано через агрегатора з договором — без цього SMS не відправляться на мережі МТС/МегаФон/Білайн.

Як побудувати інтеграцію, щоб не втрачати листи?

Розділяємо транзакційні та маркетингові потоки

Транзакційні листи (підтвердження замовлення, скидання пароля, статус доставки) — через окремий домен-відправник або субдомен tx.example.com. Маркетингові розсилки — через mail.example.com або news.example.com. Якщо маркетингова розсилка отримає багато скарг на спам, це не повинно зачепити репутацію транзакційного потоку. Згідно з документацією SendGrid, транзакційні повідомлення слід відправляти через виділений IP-пул для запобігання перехресному впливу.

Черга та retry

Будь-який виклик до email API — через чергу (Laravel Queue, Bull, Celery). Якщо Unisender повернув 503 — задача йде в retry через 5 хвилин, потім 15, потім 60. Після 5 невдалих спроб — у dead letter queue з алертом. Користувач при цьому вже отримав свій 200 OK і не знає про проблему. Завдяки цьому підходу bounce rate на проєктах знижується до 0.5%.

Приклад job для Laravel:

public function handle(): void
{
    try {
        $response = Http::post(config('services.unisender.email_url'), $this->params);
        if ($response->failed()) {
            $this->release(300); // retry через 5 хв
        }
    } catch (\Throwable $e) {
        $this->release(300);
    }
}

Шаблони

Зберігаємо шаблони в коді (Blade, Twig, React Email), не в інтерфейсі провайдера. Причини: версіонування через Git, preview у браузері без відправки, можливість тестування. Для складних шаблонів з динамічним контентом — react-email з експортом в HTML через @react-email/render.

Валідація та згоди

Перед додаванням контакту до списку — double opt-in (лист з підтвердженням). Зберігати факт підтвердження з timestamp у своїй БД. При відписці — синхронно відписуємо і у провайдера, і в своїй базі. Ігнорувати webhook відписки — прямий шлях до блокування акаунта у провайдера. Всі процеси відповідають ФЗ-152 про персональні дані.

Моніторинг доставності

Підключаємо webhook від провайдера на події bounce (жорсткий і м'який), spam_complaint, unsubscribe. Жорсткий bounce — негайно позначаємо email як невалідний у своїй БД, більше не відправляємо. М'який bounce 3 рази поспіль — те саме. Метрики: open rate, click rate, bounce rate, unsubscribe rate — дивимося не рідше разу на тиждень. Наші сертифіковані інженери налаштовують алерти в Grafana/Prometheus.

Чому важливо розділяти потоки?

Якщо відправити маркетингову розсилку з того ж домену, що й транзакційні листи, отримавши скарги на спам, ви ризикуєте заблокувати домен — і користувачі перестануть отримувати навіть підтвердження замовлень. SPF, DKIM, DMARC (Wikipedia SPF, Wikipedia DKIM) повинні бути налаштовані окремо для кожного потоку. Ми використовуємо субдомени з різними DNS-записами.

Обсяг робіт з інтеграції

• Аудит поточних потоків комунікації та репутації домену (SPF, DKIM, DMARC)
• Вибір провайдера та схеми: транзакційний vs маркетинговий трафік
• Налаштування DNS-записів SPF, DKIM, DMARC (Wikipedia DMARC)
• Розробка шаблонів листів (HTML + динамічний контент)
• Інтеграція з бекендом через черги та API
• Налаштування webhook для доставності та скарг
• Документація з експлуатації та навчання команди
• Гарантія доставності та підтримка після запуску

Терміни та вартість

Вартість розраховується індивідуально після аудиту. Ми працюємо під ключ: від аналізу до моніторингу в продакшені. Отримайте консультацію інженера — оцінимо проєкт безкоштовно та скажемо точні терміни. Досвід більше 7 років в інтеграції поштових сервісів, реалізовано 50+ проєктів. Замовте безкоштовний аудит поточної інтеграції — отримайте звіт з рекомендаціями.