Подключить FreePBX к amoCRM

Результат: при звонке сотрудник видит в amoCRM уведомление с именем клиента, звонок с записью попадает в карточку, незнакомые номера превращаются в контакты, сделки или неразобранное по вашим правилам, а клик по номеру в amoCRM запускает звонок с телефона сотрудника.

На стороне amoCRM больше ничего настраивать не нужно: внутренние номера сотрудников вводятся в кабинете Callbee (шаг 6).

Что потребуется

Что Откуда
Адрес аккаунта amoCRM, например company.amocrm.ru Адресная строка браузера
Администратор amoCRM Устанавливает виджет и подтверждает доступ Callbee к аккаунту
Публичный адрес FreePBX и пароль AMI-пользователя callbee Настройка AMI
Ссылка на записи, рекомендуем https:// Публикация записей
Список сотрудников и их внутренних номеров на FreePBX Понадобится на шаге 6

Шаг 1. CRM & PBX

В my.callbee.io откройте Интеграции и нажмите «Создать».

TODO: скриншот — шаг 1 мастера для amoCRM: выбор CRM, домен, PBX ASTERISK
TODO: скриншот — шаг 1 мастера для amoCRM: выбор CRM, домен, PBX ASTERISK
Поле Значение
Выбор CRM AMOCRM
Домен адрес аккаунта без https://, например company.amocrm.ru
PBX ASTERISK

Нажмите «Продолжить».

Если мастер пишет «Пожалуйста, установите приложение Сallbee | FreePBX и Yeastar в вашем AmoCRM»

Это значит, что Callbee ещё не получил доступ к этому аккаунту amoCRM. Сообщение появляется и после установки виджета, пока доступ не подтверждён:

  1. Нажмите на название приложения в сообщении: откроется окно amoCRM с запросом доступа. TODO: скриншот — сообщение мастера о доступе и окно amoCRM с запросом доступа
  2. Подтвердите доступ администратором amoCRM.
  3. Вернитесь в мастер и снова нажмите «Продолжить».

Повторно выдать доступ можно позже по иконке «Предоставление доступа к интеграции в Amocrm» рядом с доменом в карточке интеграции.

Если мастер пишет «Установка интеграции не удалась: crm domain already exists»

Этот аккаунт amoCRM уже привязан к другой интеграции Callbee, один аккаунт — одна интеграция. Найдите её в списке интеграций.

Шаг 2. AMI

TODO: скриншот — шаг 2 мастера: «AMI сервер» с публичным адресом и портом 5038, «AMI имя пользователя» callbee
TODO: скриншот — шаг 2 мастера: «AMI сервер» с публичным адресом и портом 5038, «AMI имя пользователя» callbee
Поле Значение
AMI сервер публичный адрес FreePBX и порт через двоеточие: pbx.company.by:5038
AMI имя пользователя callbee — имя секции в manager_custom.conf
AMI пароль пароль из той же секции, без пробелов в начале и конце

Нажмите «Продолжить».

Шаг 3. Asterisk

Шаг 3: настройки Asterisk
Шаг 3: настройки Asterisk
Поле Значение
Ссылка на запись разговора адрес, по которому папка записей FreePBX открывается из интернета, например https://recs.company.by/
Игнорировать линии (DID) номера, звонки на которые не нужно передавать в amoCRM, через пробел. Обычно пусто

Запись передаётся в amoCRM ссылкой: файл остаётся на АТС и проигрывается в карточке по этому адресу, поэтому адрес должен открываться из интернета. К нему Callbee добавляет путь файла записи; если в ссылке есть monitor, всё начиная с него Callbee отрежет и подставит сам. Если доступ к записям ограничен по IP, добавьте и офисную подсеть: записи слушают сотрудники.

Нажмите «Продолжить».

Шаг 4. Все линии

TODO: скриншот — шаг 4 мастера для amoCRM: режим при исходящем, входящие линии, ID пользователя, умная маршрутизация
TODO: скриншот — шаг 4 мастера для amoCRM: режим при исходящем, входящие линии, ID пользователя, умная маршрутизация

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

Поле Что делает
Режим при исходящем вызове Что создавать, когда сотрудник звонит на номер, которого нет в amoCRM: None — ничего; Contact — контакт; Contact + Lead — контакт и сделку в главной воронке. Ответственным становится звонящий сотрудник
Входящие линии Что создавать при входящем с незнакомого номера: None — ничего, сотрудник получает уведомление со ссылкой на создание контакта; Contact — контакт; Contact + Lead — контакт и сделку в воронке линии; Unsorted — запись в «Неразобранном», она создаётся после окончания звонка
ID пользователя (ответственный за пропущенные) Оставьте значение по умолчанию: после создания интеграции Callbee всё равно заменит его первым сотрудником из amoCRM, настоящего ответственного вы выберете на шаге 7. Роль ответственного линии: при входящем с незнакомого номера на него создаются контакт, сделка или неразобранное по пропущенному; неразобранное по отвеченному звонку — на ответившего; в режиме None он получает уведомления о пропущенных с незнакомых номеров
Умная маршрутизация Перевод входящего на ответственного за контакт или компанию. Сам переключатель на линии ничего не меняет: маршрутизация включается у каждого сотрудника отдельно на шаге 6 и работает по его расписанию

Нажмите «Продолжить».

Шаг 5. Регион

Шаг 5: регион и часовой пояс
Шаг 5: регион и часовой пояс
Поле Значение
Регион код региона, где развёрнут ваш сервис Callbee: BY — Беларусь, RU — Россия, DE — Финляндия и остальная Европа
Часовой пояс пояс офиса, например Europe/Minsk; по умолчанию подставляется пояс вашего браузера

Часовой пояс используется для расписаний умной маршрутизации.

Нажмите «Создать». Мастер ответит «Интеграция создана успешно!».


Шаг 6. Привяжите сотрудников к внутренним номерам

Callbee не использует телефоны из профилей amoCRM: внутренние номера вводятся в кабинете.

  1. В списке интеграций разверните строку новой интеграции (стрелка слева) или нажмите на кнопку настроек справа, перейдите на вкладку Пользователи. Список сотрудников Callbee взял из amoCRM при создании интеграции: до 250 активных пользователей.
  2. У каждого сотрудника, который работает со звонками, введите в поле номер его внутренний номер на FreePBX, только цифры, и включите переключатель активный. Без номера включить сотрудника нельзя.
  3. При необходимости включите Авто ответ (при звонке по клику телефон сотрудника снимет трубку сам) или Множественная регистрация (номер зарегистрирован на нескольких устройствах, вызов пойдёт на все). Вместе их включить нельзя.
  4. Для умной маршрутизации включите её у сотрудника и проверьте расписание: по умолчанию пн–пт 09:00–18:00.
  5. Нажмите «Сохранить».
TODO: скриншот — вкладка «Пользователи» интеграции amoCRM с номером, переключателями «активный», «Авто ответ», «Множественная регистрация»
TODO: скриншот — вкладка «Пользователи» интеграции amoCRM с номером, переключателями «активный», «Авто ответ», «Множественная регистрация»

Активных сотрудников обслуживается не больше лимита лицензии (вкладка Лицензия); лишние в конце списка не обслуживаются. Сотрудник без номера не получит уведомлений и не сможет звонить по клику. Новые сотрудники amoCRM, добавленные после создания интеграции, в списке не появятся.

Шаг 7. Проверьте линию «все линии»

После создания Callbee ставит для линии «все линии» ответственным первого сотрудника из списка amoCRM, а воронкой — первую воронку, независимо от того, что вы ввели на шаге 4. Откройте вкладку Линии, найдите линию без DID и выставьте нужного ответственного за пропущенные и воронку для сделок. Здесь же добавляются линии по городским номерам: DID, описание, воронка, ответственный, режим создания.

Проверка

Интеграция в списке должна быть со статусом ACTIVE. В карточке вкладка Логи — журнал интеграции; в нём строка +++ integration start +++ и phones | … | count N, где N — число привязанных сотрудников на момент запуска. Не путайте с пунктом меню Журнал звонков.

Откройте amoCRM в браузере: уведомления приходят в ту вкладку amoCRM, которую открыли первой.

  1. Позвоните с мобильного, которого нет в amoCRM, на городской номер компании. У сотрудника, чей внутренний номер звонит, появится уведомление «Звонок от {номер}» со ссылкой на создание контакта.
  2. Ответьте, поговорите несколько секунд, положите трубку. Результат зависит от режима входящих: Contact — контакт auto contact {номер} с примечанием о звонке и записью; Contact + Lead — ещё и сделка auto leads {номер}; Unsorted — запись в «Неразобранном» на ответившего с длительностью и записью; None — ничего.
  3. Позвоните с другого мобильного, которого нет в amoCRM, и не отвечайте. None — ответственный линии «все линии» (шаг 7) получит уведомление «Пропущен вызов от {номер}»; Contact и Contact + Lead — в созданном контакте появится примечание «вызов пропущен»; Unsorted — неразобранное на ответственного линии.
  4. В amoCRM откройте контакт с номером вашего тестового мобильного (в режимах Unsorted и None создайте его вручную) и нажмите на номер, действие «Callbee call out». Внутренний телефон сотрудника зазвонит, после ответа АТС соединит с клиентом; с «Авто ответ» трубку снимет сам телефон. Если за 12 секунд телефон не ответил, звонок отменяется.

Общий чек-лист: Первый звонок.

Если что-то не работает

Симптом Причина, куда смотреть
Журнал пуст, нет integration start Интеграция не может подключиться к AMI: неверный адрес или пароль, либо порт 5038 закрыт для IP Callbee. Настройка AMI, IP-адреса
В журнале amocrm error: … Callbee не смог обновить доступ к amoCRM. Выдайте доступ заново по иконке рядом с доменом в карточке интеграции
Уведомления не приходят никому Лицензия не активна (вкладка Лицензия); сотрудникам не заданы номера (шаг 6); DID в «Игнорировать линии»; открыта не первая вкладка amoCRM
В журнале link record not found Файл записи не найден по ссылке. Публикация записей
Запись в карточке есть, но не играет Ссылка на записи по http://: опубликуйте записи по HTTPS
Умная маршрутизация не переводит У ответственного за контакт выключена умная маршрутизация или нет номера; сейчас вне его расписания; клиент найден только по сделке, а не по контакту или компании
Клик по номеру не звонит; в журнале click to call error - … not found in extension list Сотрудник не активен или без номера на вкладке Пользователи
Клик по номеру не звонит; в журнале click to call … status … Внутренний номер сотрудника занят
При добавлении линии «This DID is already in used» или «Please, enter responsible user» Такой DID уже есть у другой линии; не выбран ответственный

Другие случаи: Решение проблем.

Что дальше

  • ROISTAT. Для сквозной аналитики подключите отдельную интеграцию FreePBX + ROISTAT.