MANGO Office: подключение виртуальной АТС

Получение API-доступа

На стороне MANGO Office (mango-office.ru):

1. Войдите в личный кабинет.
2. Личный кабинет → Интеграции → API.
3. Создайте новое подключение:

- Введите название: «CRMservice» - Выберите тип: vpbx

1. Скопируйте 4 значения:

- ключ API (числовой) - API Salt (длинная строка) - vpbx_api_key (для CallBack API) - Номер вашего vpbx (городской/мобильный)

Включение вебхук'ов

В том же разделе API:

1. Откройте вкладку «События».
2. Включите типы событий:

- Входящий звонок (incoming_call) - Ответ на звонок (answered) - Завершение звонка (completed) - Запись разговора (recording_ready) — критично, без этого записи не попадут в CRM.

1. URL вебхука: https://crm.<ваш-домен>/api/v1/webhooks/telephony/mango (CRM покажет точный URL).

Подключение в CRMservice

1. Настройки → Интеграции → Телефония → Добавить → MANGO Office.
2. Вставьте ключ API и API Salt.
3. Укажите номер vpbx.
4. Сохранить — CRM сделает тестовый запрос к MANGO, проверит подпись.

Маппинг сотрудников

В MANGO у каждого сотрудника есть «внутренний номер» — 3-значное число (101, 102…).

1. В CRM откройте Настройки → Сотрудники.
2. Для каждого сотрудника впишите его внутренний номер MANGO.
3. Сотрудники без внутреннего номера могут только принимать звонки на общий номер, не на свой.

Правила входящих

В кабинете MANGO настраиваете маршрут (например, очередь menu):

```
Городской номер → IVR-приветствие → нажми 1 — продажи (группа 100)
→ нажми 2 — поддержка (группа 200)
→ не нажимать — секретарь (101)
```

CRM подхватывает информацию из IVR — в карточке звонка видно, какую кнопку нажал клиент.

Исходящие через CRM (Click-to-Call)

После подключения в карточке клиента появляется кнопка-телефон:

1. Менеджер кликает на номер клиента.
2. CRM делает запрос commands/callback в MANGO.
3. MANGO звонит сначала менеджеру (на его внутренний или мобильный), он берёт трубку.
4. Потом MANGO звонит клиенту — соединяет.

Возможные проблемы

• «SignatureMismatch» — API Salt введён неверно. Перевыпустите ключ в кабинете MANGO.
• «Recording 404» — запись ещё не готова, MANGO готовит её 1–3 минуты после завершения звонка. Подождите и обновите карточку.
• «Вебхук timeout» — наш сервер не ответил MANGO за 5 сек. Может быть из-за пиковой нагрузки — звонок всё равно состоится, но карточка не подтянется. См. Журнал интеграций.
• «Не работает IVR в CRM» — IVR-меню должно быть настроено как «многоуровневое меню» в MANGO, не «сценарий». Сценарии передают данные иначе.