Як налаштувати канал телефонії

Налаштуйте канал телефонії для обробки дзвінків клієнтів у ConnectiveOne. Після налаштування дзвінки будуть зберігатися як діалоги в Операторській панелі, де оператори зможуть переглядати історію, прослуховувати записи та переглядати транскрипти.

Передумови

  • Доступ до налаштувань бота в ConnectiveOne
  • Доступ до панелі управління провайдера телефонії (Ringostat, Binotel тощо)
  • Webhook URL та токен для підключення

Коли знадобиться

  • Потрібно інтегрувати телефонію з ConnectiveOne
  • Потрібно зберігати історію дзвінків разом з іншими каналами комунікації
  • Потрібно дати операторам доступ до записів та транскриптів дзвінків

Основні елементи інтерфейсу

  • Канал телефонії — налаштування для підключення до провайдера телефонії
  • Webhook URL — адреса, на яку провайдер надсилає події дзвінків
  • Webhook Token — токен для безпечної верифікації запитів
  • Advanced Config — JSON конфігурація для маппінгу полів від провайдера

Крок 1: Відкрити налаштування телефонії

  1. Перейдіть в Налаштування → Боти
  2. Оберіть потрібного бота
  3. Перейдіть на вкладку Телефонія

Крок 2: Створити новий канал

  1. Натисніть кнопку Створити канал
  2. Введіть назву каналу (наприклад, "Основна телефонія")
  3. Увімкніть перемикач Активний, якщо канал має працювати зараз

Крок 3: Налаштувати webhook

  1. Скопіюйте Webhook URL — він генерується автоматично
  2. Скопіюйте Webhook Token — він також генерується автоматично
  3. В панелі провайдера телефонії налаштуйте webhook:
    • Вставте скопійований Webhook URL
    • Додайте токен до URL або налаштуйте верифікацію згідно з документацією провайдера
  4. Оберіть формат даних: JSON або Form-urlencoded (залежить від того, що підтримує провайдер)

Крок 4: Налаштувати маппінг полів (Advanced Config)

Маппінг полів потрібен для того, щоб система зрозуміла, які поля з webhook провайдера відповідають нашим внутрішнім полям.

  1. В розділі Advanced Config відкрийте JSON редактор
  2. Налаштуйте field_mapping — відповідність полів провайдера нашим полям:
{
  "field_mapping": {
    "call_id": "call_id",
    "caller_number": "caller",
    "callee_number": "callee",
    "operator_id": "manager_id",
    "status": "status",
    "duration": "call_duration",
    "recording_url": "recording_url",
    "transcript_text": "transcript"
  }
}

Примітка: Назви полів залежать від того, як провайдер називає поля в своєму webhook. Перевірте документацію провайдера або використайте preset для Ringostat.

  1. Якщо потрібно, налаштуйте маппінг статусів:
{
  "status_mapping": {
    "PROPER": "answered",
    "MISSED": "missed"
  }
}
  1. Якщо потрібно, налаштуйте маппінг напрямку дзвінка:
{
  "direction_mapping": {
    "in": "in",
    "out": "out"
  }
}

Крок 5: Налаштувати нормалізацію номерів

  1. В розділі Нормалізація номерів оберіть код країни за замовчуванням (наприклад, +380 для України)
  2. Формат телефону завжди E.164 — система автоматично нормалізує номери до цього формату

Крок 6: Зберегти та протестувати

  1. Натисніть Зберегти
  2. Натисніть Тест для перевірки роботи webhook
  3. Перевірте, що тестовий діалог створено успішно

Додаткові налаштування

Налаштування записів

Якщо провайдер надає записи дзвінків, налаштуйте в Advanced Config:

{
  "recordings": {
    "enabled": true,
    "download": false
  }
}
  • enabled: true — увімкнути обробку записів
  • download: false — зберігати тільки URL, не завантажувати файл

Налаштування транскриптів

Якщо провайдер надає транскрипти дзвінків, налаштуйте в Advanced Config:

{
  "transcription": {
    "enabled": true,
    "source": "provider"
  }
}
  • enabled: true — увімкнути обробку транскриптів
  • source: "provider" — транскрипт надається провайдером

Перевірка роботи

Після налаштування перевірте:

  1. Статус каналу — має бути "Активний"
  2. Тестовий webhook — має створити тестовий діалог
  3. Реальний дзвінок — після завершення дзвінка він має з'явитися в Операторській панелі

Пов'язані статті