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

Сторінка для інтегратора, який налаштовує інтеграції ConnectiveOne з зовнішніми системами. Тут ви підключите API, налаштуєте Custom Channel, webhook та інші механізми для обміну даними між 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 системами.

• Інтеграція операторської панелі як віджету — як вбудувати операторську панель у 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 ключів
• Dialog (Scenario Dialog): для налаштування сценаріїв з використанням actions (send_request, call_node)

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

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

• Що таке інтеграції
• API довідник

API

• Використання API

Custom Channel

• Інтеграція через Custom Channel

Webhook

• Налаштування webhook панелі оператора

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

• Запуск сценарію через API call_node
• Запуск сценарію через deeplink

CRM/ERP

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

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

• Отримання даних через send_request
• Передача даних через send_request
• Підписка користувача на нотифікації

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

• Інтеграція з eSputnik
• Розсилка по телефону через route

CRM/ERP

• Інтеграція операторської панелі як віджету
• Налаштування назви продукту для Zoho CRM

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

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