Asterisk (PBX) (Private Branch Exchange) - відкрита комунікаційна платформа, яка використовується для впровадження програмних АТС, систем голосового зв'язку, VoIP-шлюзів, IVR-систем (інтерактивне голосове меню), голосової пошти, телефонних конференцій і call-центрів.

На основі цієї технології працює багато телефоній, які ви можете приєднати до KeyCRM, щоб: 

• здійснювати дзвінки з CRM та обробляти вхідні;
• бачити, хто вам дзвонить, якщо покупець вже є в системі;
• створювати покупців, замовлення чи заявки прямо з картки дзвінка;
• бачити всю історію дзвінків із записами розмов.

Крок 1. Створюємо канал телефонії у KeyCRM

Перейдіть до «Налаштування» → «Комунікації» → вкладка «Телефонія» та натисніть кнопку «Додати нову службу».

У вікні, що з'явилося, на вкладці «Загальні»:

1. Назва — ведіть назву телефонії;
2. Сервіс телефонії — виберіть «Other».
3. Посилання для ініціалізації дзвінка — на цей URL буде надіслано запит, методом POST для ініціалізації дзвінка. Контекст запиту у форматі json:
   caller: номер внутрішної лінії
destination_number: номер клієнта
4. Посилання для завершення дзвінка — на цей URL буде надіслано запит, методом POST для завершення дзвінка. Контекст запиту у формати json:
   call_id: ідентифікатор дзвінка
   Якщо посилання заповнено в налаштуваннях телефонії, в картці дзвінка буде кнопка для завершення дзвінка;
5. Посилання на Webhook — скопіюйте посилання для подальших налаштувань на стороні телефонії;
6. Використовувати deep link —  активуйте, якщо ви використовуєте софтфон, який підтримує цю технологію;
7. Зв'язок з воронками —  активуйте та оберіть значення:
   • Ні — картки НЕ будуть створюватись з дзвінків автоматично;
   • Одноразовий — картки будуть створені тільки один раз за умови, що ще не має картки з цим номером;
   • Повторюваний — картки будуть створюватись завжди при повторних дзвінках за умови, що в номера не має картки в робочих статусах (усі статуси крім успішного і відхилених).  
8. Тип дзвінка — оберіть тип дзвінків з яких будуть створюватись картки: тільки вхідні, тільки вихідні або усі — вхідні та вихідні;
9. Воронка — вкажіть воронку для створення карток. Якщо у вас тільки одна воронка — вона обирається автоматично, а самого поля з вибором не буде;
10. Джерело — оберіть джерело з яким буде створюватись картка. Якщо не вибрати — картка створиться з пустим значенням в полі джерела.

Крок 2. Підключення номерів

У вікні налаштувань перейдіть на вкладку «Номера користувачів» та заповніть дані:

• Внутрішній номер — номер внутрішньої лінії;
• Менеджер — користувач у CRM, який відповідає цьому номеру.

У списку для вибору будуть користувачі, яким надано доступ до телефонії.

Після внесеної інформації обов'язково збережіть канал і переходьте до наступного кроку.

Крок 3. Налаштування на стороні телефонії

Тепер вам потрібно реалізувати відправку та обробку запитів між вашою телефонією та KeyCRM. 

Приклад запиту для отримання інформації про покупця:

{
  "action": "route",
  "route": "380730000001"
}

Приклад запиту для зберігання дзвінка:

{
  "action": "call",
   "call": {
      "id": "1233123",  // унікальний ІД дзвінка
      "direction": "outgoing",  // or incoming
      "destination_number": "380730000001",
      "caller": "301",
      "state": "started", // pending | answered | canceled | busy | completed | transferred
      "duration": 5666, // в секунах
      "audio_url": "https://google.com" посилання на аудіо
   }
}

Тепер ви можете працювати з телефонією в KeyCRM!