Как подключить телефонию на базе Asterisk (PBX)

Рассказываем, как интегрировать свою телефонию на базе Asterisk для совершения звонков в KeyCRM.
Автор Андрей Гадай
Обновлено 1 месяц назад

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. Источник — выберите источник, с которым будет создаваться карточка. Если не выбрать – карточка создается с пустым значением в поле источника.

Обратите внимание! Функция deep link позволяет сразу начинать вызов с телефонии покупателю после начала звонка в CRM. Без deep link звонок поступает сначала на софтфон или IP-телефон менеджера, а после ответа уже начнется соединение с покупателем.

Использование deep link необходимо активировать только если вы используете софтфон, который поддерживает эту технологию (например, MicroSIP или платный Zoiper).

Если вы не уверены, то можете протестировать. Сначала активируйте, если исходящие звонки из CRM не будут работать, то деактивируйте. 

IP телефоны функцию deep link не поддерживают, поэтому при работе с ними — она должна быть выключена

Шаг 2. Подключение номеров

В открывшемся окне настроек перейдите на вкладку «Номера пользователей» и заполните данные:  

  • Внутренний номер  — номер внутренней линии;
  • Менеджер  — пользователь CRM, который соответствует этому номеру.

В списке для выбора будут пользователи, которым предоставлен доступ к телефонии. 

После внесенной информации обязательно сохраните канал и переходите к следующему шагу.

Шаг 3. Настройка на стороне телефонии

Теперь вам нужно реализовать отправку и обработку запросов между телефонией и KeyCRM. 

Пример запроса для получения информации о покупателе:

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

Пример запроса для хранения звонка:

{
  "action": "call",
   "call": {
      "id": "1233123",  // уникальный ID звонка
      "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!

Теги: телефония, Asterisk, Asterik, астериск, астерикс, другая телефония, программная ATC, шлюз
Оцените эту статью