Руководство Mokapen

3CX

3CX связывает АТС с Mokapen для всплывающего окна контакта, журнала звонков и — если настроить — click-to-call. Mokapen не становится АТС: генерирует API-ключ и XML-шаблон, который вы загружаете в админке 3CX. Оттуда 3CX спрашивает у Mokapen, кто этот номер, а Mokapen может записать заметку о звонке на контакте или компании.

Обзор: Интеграции.

Требования

• Установка 3CX, в которой вы можете открыть Admin → Integrations → CRM и загрузить шаблон.
• План Mokapen Medium.
• Для click-to-call дополнительно: план 3CX с Call Control / WebAPI (Enterprise), хост 3CX, доступный из Mokapen, и внутренний номер, сопоставленный с пользователем, который кликает.

API-ключ и шаблон

Меню пользователя → Интеграции → 3CX. Mokapen показывает API-ключ для CRM-шаблона: как имя пользователя Basic auth или в заголовке X-Api-Key. Скачайте XML-шаблон. Ключ уже вставлен как значение по умолчанию. Загрузите его в 3CX Admin → Integrations → CRM.

На странице также указан базовый URL CRM API: это адрес, который вызывает шаблон. Если 3CX за сетью, которая не достигает Mokapen, всплывающее окно не откроется даже с загруженным шаблоном.

Ключ можно перегенерировать при сохранении. Предыдущий перестаёт действовать: загрузите шаблон снова или обновите уже вставленный ключ в 3CX. Оставить старый ключ в АТС — это ошибки аутентификации, а не второе подключение.

Заметки о звонках и click-to-call

Два переключателя определяют поведение по отношению к адресной книге:

• Сохранять заметки о звонках на контактах и компаниях — в конце звонка Mokapen пишет заметку на найденной карточке.
• Разрешить создание контактов из 3CX, если номер неизвестен — если номера нет в адресной книге, Mokapen создаёт контакт. Выключите, если АТС принимает общий трафик (офисная АТС, служебные номера): иначе каждый неизвестный станет карточкой.

Click-to-call отдельно. Нужны хост 3CX (FQDN) и ключ WebAPI / Call Control. Без ключа Mokapen сообщает, что ключ Call Control не настроен. Без хоста — что отсутствует FQDN. Без сопоставления звонок не знает, какой внутренний номер звонить.

Сопоставление — одна строка на человека в форме внутренний=user_id (пример 102=15). Нужно и чтобы приписать заметку о звонке нужному пользователю, и для click-to-call. Если у вашего пользователя нет строки, Mokapen сообщает, что нет сопоставленного внутреннего номера. Обычный клик звонит через 3CX; Shift, Ctrl или Alt вместе с кликом открывает набор номера устройства.

Если 3CX отклоняет запрос, проверьте по порядку FQDN, ключ Call Control и внутренний номер. Сообщение на странице — что 3CX не принял вызов.

Когда всплывающее окно не появляется

• Шаблон не загружен или загружен до перегенерации ключа.
• Входящий номер не совпадает с телефоном в адресной книге, а автоматическое создание выключено. Всплывающему окну нечего открыть.
• Вы ищете видеозвонок встречи. 3CX не ставит Meet или Teams на карточку встречи.