Інтегратор — Хаб інтеграцій ConnectiveOne

Сторінка для інтегратора, який налаштовує інтеграції ConnectiveOne з зовнішніми системами. Тут ви підключите API, налаштуєте Custom Channel, webhook та інші механізми для обміну даними між ConnectiveOne та вашими системами. Кожна інструкція допоможе швидко налаштувати потрібну інтеграцію та перевірити результат роботи.

Огляд можливостей для бізнесу дивіться на сторінці «Інтеграції ConnectiveOne».

Верхньорівневі цілі та сценарії

Розуміння типів інтеграцій

Мета — зрозуміти, які типи інтеграцій доступні та коли їх використовувати.

Що таке інтеграції — загальний огляд типів інтеграцій (Custom Channel, API, call_node, Webhooks, Deeplink) та їх призначення. → ./explanation/what-are-integrations.md

API інтеграції

Мета — отримувати та змінювати дані ConnectiveOne через REST API.

Використання API — як використовувати Enterprise API та публічні API для роботи з даними. → ./how-to/use-api.md
API довідник — повний список доступних endpoints та їх параметрів. → ./reference/api-reference.md

Custom Channel інтеграції

Мета — інтегрувати зовнішні системи через HTTP запити.

Інтеграція через Custom Channel — як підключити зовнішню систему до ConnectiveOne через Custom Channel. → ./how-to/custom-channel/integrate-via-custom-channel.md

Webhook інтеграції

Мета — отримувати події з операторської панелі на зовнішній сервіс.

Налаштування webhook панелі оператора — як налаштувати отримання подій з операторської панелі на ваш сервіс. → ./how-to/webhook/configure-operator-panel-webhook.md

Запуск сценаріїв з зовнішніх систем

Мета — запускати сценарії ботів з ваших систем.

Запуск сценарію через API call_node — як запустити сценарій бота з зовнішньої системи через API. → ./how-to/launch-scenario-via-call-node.md
Запуск сценарію через deeplink — як створити прямі посилання для запуску сценаріїв з параметрами. → ./explanation/deeplink-launch.md

Інтеграції з CRM/ERP

Мета — інтегрувати ConnectiveOne з вашими CRM/ERP системами.

Інтеграція з Odoo CRM — операторська панель, webhook, ліди. → ./how-to/crm-erp/integrate-connectiveone-with-odoo-crm.md
Віджет операторської панелі в Odoo — autologin та iframe у картці контакта. → ./how-to/crm-erp/integrate-operator-panel-as-widget-odoo.md
Інтеграція операторської панелі як віджету — як вбудувати операторську панель у CRM/ERP як віджет. → ./how-to/crm-erp/integrate-operator-panel-as-widget.md
Налаштування назви продукту для Zoho CRM — як налаштувати відображення назви продукту в Zoho CRM. → ./how-to/crm-erp/setup-zoho-crm-product-name.md

Інтеграції з маркетинговими сервісами

Мета — інтегрувати ConnectiveOne з маркетинговими платформами.

Інтеграція з eSputnik — як підключити ConnectiveOne до eSputnik для синхронізації контактів. → ./how-to/marketing/integrate-with-esputnik.md
Розсилка по телефону через route — як налаштувати розсилку повідомлень по телефону. → ./how-to/marketing/send-phone-broadcast-route.md

Передача даних

Мета — обмінюватися даними між ConnectiveOne та зовнішніми системами.

Отримання даних через send_request — як отримати дані з зовнішнього API та обробити відповідь в сценарії. → ./how-to/data-transfer/get-data-via-send-request.md
Передача даних через send_request — як відправити дані з ConnectiveOne на зовнішній сервіс. → ./how-to/data-transfer/send-data-via-send-request.md
Підписка користувача на нотифікації — як налаштувати підписку користувачів на нотифікації з боту. → ./how-to/data-transfer/subscribe-user-to-notifications.md

Explanation документи

Мета — зрозуміти концепції та принципи роботи інтеграцій.

Загальні концепції

Що таке інтеграції — огляд типів інтеграцій та їх використання. → ./explanation/what-are-integrations.md
Передача UTM-міток — як передавати UTM-мітки через повідомлення для відстеження джерел трафіку. → ./explanation/utm-tags-transfer.md
Запуск сценарію через deeplink — як створювати прямі посилання для запуску сценаріїв. → ./explanation/deeplink-launch.md

Де працювати в інтерфейсі

Основна робота з інтеграціями відбувається в різних розділах ConnectiveOne:

Налаштування ботів (/settings/bots): для налаштування Custom Channel, API ключів
Swagger UI (/api-docs): для перегляду та тестування API endpoints
Меню допомоги → API документація: доступ до Swagger документації
Налаштування → Список ботів → Налаштування бота: для отримання API ключів
Scenario Builder (рекомендований): для налаштування сценаріїв з використанням actions (send_request, call_node). Див. Scenario Builder
Scenario Dialog (Legacy): для налаштування сценаріїв у старому інтерфейсі

Швидкі посилання

Розуміння інтеграцій

Запуск сценаріїв

CRM/ERP

Інтеграція операторської панелі як віджету

Передача даних

Маркетингові інтеграції

CRM/ERP

Важливі примітки

⚠️ Більшість інтеграцій потребують технічних знань з REST API та JSON
🔒 Завжди використовуйте HTTPS для безпечного обміну даними
🔑 Зберігайте API ключі та токени в безпечному місці, не передавайте їх у публічних місцях
📝 Перевіряйте формати запитів та відповідей перед інтеграцією
🔄 Використовуйте retry логіку для надійності запитів
📖 Для детальної інформації про endpoints використовуйте Swagger UI в системі