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

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

Огляд можливостей для бізнесу дивіться на сторінці [«Інтеграції ConnectiveOne»](https://www.connectiveone.io/academy/integration).

---

## Короткий зміст
- [Верхньорівневі цілі та сценарії](#верхньорівневі-цілі-та-сценаріі)
- [Де працювати в інтерфейсі](#де-працювати-в-інтерфеисі)
- [Швидкі посилання](#швидкі-посилання)

---

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

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

### API інтеграції
**Мета** — отримувати та змінювати дані ConnectiveOne через REST API.
- **Використання API** — як використовувати Enterprise API та публічні API для роботи з даними. → [./how-to/use-api.md](/uk/integrations/how-to/use-api.md)
- **API довідник** — повний список доступних endpoints та їх параметрів. → [./reference/api-reference.md](/uk/integrations/reference/api-reference.md)

### Custom Channel інтеграції
**Мета** — інтегрувати зовнішні системи через HTTP запити.
- **Інтеграція через Custom Channel** — як підключити зовнішню систему до ConnectiveOne через Custom Channel. → [./how-to/custom-channel/integrate-via-custom-channel.md](/uk/integrations/how-to/custom-channel/integrate-via-custom-channel.md)

### Webhook інтеграції
**Мета** — отримувати події з операторської панелі на зовнішній сервіс.
- **Налаштування webhook панелі оператора** — як налаштувати отримання подій з операторської панелі на ваш сервіс. → [./how-to/webhook/configure-operator-panel-webhook.md](/uk/integrations/how-to/webhook/configure-operator-panel-webhook.md)

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

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

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

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

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

#### Загальні концепції
- **Що таке інтеграції** — огляд типів інтеграцій та їх використання. → [./explanation/what-are-integrations.md](/uk/integrations/explanation/what-are-integrations.md)
- **Передача UTM-міток** — як передавати UTM-мітки через повідомлення для відстеження джерел трафіку. → [./explanation/utm-tags-transfer.md](/uk/integrations/explanation/utm-tags-transfer.md)
- **Запуск сценарію через deeplink** — як створювати прямі посилання для запуску сценаріїв. → [./explanation/deeplink-launch.md](/uk/integrations/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](/uk/scenariobuilder/integrator-hub.md)
- **Scenario Dialog (Legacy)**: для налаштування сценаріїв у старому інтерфейсі

---

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

### Розуміння інтеграцій
- [Що таке інтеграції](/uk/integrations/explanation/what-are-integrations.md)
- [API довідник](/uk/integrations/reference/api-reference.md)

### API
- [Використання API](/uk/integrations/how-to/use-api.md)

### Custom Channel
- [Інтеграція через Custom Channel](/uk/integrations/how-to/custom-channel/integrate-via-custom-channel.md)

### Webhook
- [Налаштування webhook панелі оператора](/uk/integrations/how-to/webhook/configure-operator-panel-webhook.md)

### Запуск сценаріїв
- [Запуск сценарію через API call_node](/uk/integrations/how-to/launch-scenario-via-call-node.md)
- [Запуск сценарію через deeplink](/uk/integrations/explanation/deeplink-launch.md)

### CRM/ERP
- [Інтеграція операторської панелі як віджету](/uk/integrations/how-to/crm-erp/integrate-operator-panel-as-widget.md)

### Передача даних
- [Отримання даних через send_request](/uk/integrations/how-to/data-transfer/get-data-via-send-request.md)
- [Передача даних через send_request](/uk/integrations/how-to/data-transfer/send-data-via-send-request.md)
- [Підписка користувача на нотифікації](/uk/integrations/how-to/data-transfer/subscribe-user-to-notifications.md)

### Маркетингові інтеграції
- [Інтеграція з eSputnik](/uk/integrations/how-to/marketing/integrate-with-esputnik.md)
- [Розсилка по телефону через route](/uk/integrations/how-to/marketing/send-phone-broadcast-route.md)

### CRM/ERP
- [Інтеграція операторської панелі як віджету](/uk/integrations/how-to/crm-erp/integrate-operator-panel-as-widget.md)
- [Налаштування назви продукту для Zoho CRM](/uk/integrations/how-to/crm-erp/setup-zoho-crm-product-name.md)

---

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

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