Інтеграції та канали: технічні подробиці

Канали додають повідомлення інших сервісів до тієї самої панелі операторів, що й чат сайту; інтеграції надсилають події іншим сервісам або отримують із них знання. Ця сторінка описує технічний бік. Керування в обліковому записі описано в Посібнику.

Стан: канали й більшість інтеграцій перевірено на змодельованих відповідях провайдерів, але ще не на кожному справжньому обліковому записі. Підписаний вебхук завершений (із зазначеним там обмеженням); для решти провайдерів після ввімкнення перевірте журнал інтеграції. Вважайте їх бета.

Спільні правила

• Адреси зворотного виклику мають вигляд https://reactive.chat/kanal/<kanal>/<SITE_KEY>. Ключ сайту є в обліковому записі в розділі Проєкт → Встановлення.
• Кожен вхідний шлях перевіряє підпис провайдера. Без секрету провайдера нічого не приймається.
• Облікові дані зберігаються зашифрованими й окремо від решти конфігурації.
• Відповіді команди йдуть до провайдера через вихідну чергу; зависла платформа не затримує чат.
• Довжина повідомлення: вхідні повідомлення понад ліміт тарифу скорочуються й позначаються [...] (Ліміти).
• Вкладення з каналів (електронна пошта, фото Telegram) проходять ту саму перевірку, що й у віджеті (тип, розмір, квота). Відхилені файли з’являються в тексті як «[Вкладення не прийнято: …]» стандартною мовою проєкту (de, en, pl, інакше англійською).

WhatsApp, Messenger, Instagram

Налаштування в обліковому записі в розділі Інтеграції. Потрібен власний застосунок у Meta Developer Dashboard; повідомлення не проходять через наш обліковий запис.

• Callback URL: https://reactive.chat/kanal/whatsapp/SITE_KEY, …/kanal/messenger/SITE_KEY або …/kanal/instagram/SITE_KEY
• Verify Token: довгий випадковий рядок, який вводиться однаково в Meta й у нас (порівняння за сталий час).
• App Secret: використовується для перевірки підпису кожного зворотного виклику. Без App Secret вхідний шлях нічого не приймає.
• Access Token: використовується для надсилання від вашого імені.

Правила платформ, через які доставки можуть мовчки не відбутися:

• WhatsApp: протягом 24 годин після останнього повідомлення клієнта можна відповідати вільно, потім лише схваленим шаблоном (тип UTILITY, рівно один заповнювач {{1}}). Уведіть його назву в конфігурації; поза вікном ми не надсилаємо вільних відповідей.
• Instagram: клієнт має написати першим.
• Messenger: із міток повідомлень залишається лише HUMAN_AGENT; інші відхиляються.

Meta очікує відповідь на зворотний виклик за п’ять секунд; наш вхідний шлях лише приймає й додає до черги.

Telegram, SMS, електронна пошта

Ці канали належать проєкту й налаштовуються в розділі Проєкт → Канали.

• Telegram: власний бот. Після збереження токена бота ми самі реєструємо адресу https://reactive.chat/kanal/telegram/SITE_KEY через setWebhook із випадковим secret_token, який має містити кожен зворотний виклик. Стандартно асистент теж відповідає.
• SMS: через ваш обліковий запис Twilio (інтеграція Twilio). Для номера введіть https://reactive.chat/kanal/sms/SITE_KEY у «A message comes in»; X-Twilio-Signature перевіряється. Стандартно асистент теж відповідає.
• Електронна пошта: скринька перевіряється через IMAP щохвилини, відповіді йдуть через ваш SMTP (інакше через наш сервіс надсилання з Reply-To). Під час ввімкнення старі листи не отримуються. Прив’язка до розмови через In-Reply-To/References, інакше — за відправником і темою за останні 30 днів. Не приймаються: повідомлення про відсутність, звіти доставки, розсилки, листи зі спамом, понад 20 листів на відправника за годину (300 на проєкт). Стандартно асистент не відповідає на пошту; після ввімкнення відповіді містять Auto-Submitted: auto-replied.

Відома прогалина: якщо доставка провайдеру остаточно не вдалася (заблокований номер, закрите вікно), причина є в журналі інтеграції, але ще не в розмові.

Інтеграції

Інтеграції вмикаються в обліковому записі в розділі Інтеграції. Кожна має власні облікові дані (ключ, токен, адреса або вхід у провайдера). Події (conversation.created, message.created, handoff.requested, csat.submitted, fehlerfall.erstellt) ідуть через чергу з повторними спробами:

• до п’яти повторів зі зростанням інтервалів (від 1 с до трохи більш як 10 хвилин),
• запобіжник для кожного провайдера й робочого простору: після 5 помилок за 60 секунд — пауза 30 секунд,
• події, старші за годину, більше не доставляються,
• чат ніколи не чекає на інтеграцію.

Провайдери в коді:

• Події у власні системи: вебхуки (підписані, див. Вебхуки), Zapier, Make, n8n (через REST hooks)
• Командний чат: Slack, Microsoft Teams, Discord
• Задачі й CRM: Zendesk, Freshdesk, HubSpot, Pipedrive, Jira, Linear, GitHub
• Магазини: Shopify, WooCommerce, Shopware, Stripe
• Знання: обхід сайту, WordPress, Notion, Confluence, Google Drive
• Аналітика й помилки: Google Analytics 4, Matomo, Plausible, Sentry
• Зустрічі: Cal.com
• Канали: WhatsApp, Messenger, Instagram, Telegram, Twilio, електронна пошта

Реєструвати власних провайдерів не можна. Для власних підключень використовуйте вебхуки, серверний API або MCP.

Функції магазину в чаті (як-от «Додати до кошика» для WooCommerce, Shopify та Shopware) вмикаються reactive.chat для окремого проєкту; працюють лише на зареєстрованому хості магазину й не мають власного JavaScript API.

Мобільні застосунки

Для застосунків немає нативного SDK, але є сторінка вбудовування для WebView: Мобільні застосунки.

Далі: Мобільні застосунки