Скилл Манго Телеком (MANGO OFFICE) в Aizor: звонки, записи и SMS через ИИ-агента
Содержание
Коротко. Скилл Манго Телеком (MANGO OFFICE) позволяет агенту Aizor работать с облачной телефонией: инициировать звонок (callback), смотреть историю и статистику звонков, получать записи разговоров и отправлять SMS. Для подключения нужны два значения из личного кабинета: уникальный код ВАТС и ключ для создания подписи. Они находятся в разделе «Интеграции» → «API коннектор». Цена использования API в документации не указана.
Что даёт скилл MANGO OFFICE в Aizor
Официальное описание скилла от команды Aizor: облачная телефония MANGO OFFICE, инициировать звонок (callback), история и статистика звонков, записи разговоров, отправка SMS.
Агент может по вашей просьбе набрать клиента с номера сотрудника, показать статистику звонков за период, найти запись разговора или отправить SMS. Это полезно руководителю отдела продаж и владельцу небольшого бизнеса, у которого звонки идут через MANGO OFFICE. Что такое Aizor, читайте на странице «Что такое Aizor».
Что понадобится
- Виртуальная АТС MANGO OFFICE и доступ в личный кабинет, где есть раздел «Интеграции».
- Сотрудник с внутренним номером (идентификатором). Для звонка и SMS API требует указать сотрудника: без идентификатора выполнение команды от его имени невозможно.
- Приложение Aizor для macOS или Windows и скилл MANGO OFFICE из каталога.
Какая роль в кабинете нужна для этого раздела, документация не уточняет. Если раздела нет, обратитесь к администратору АТС.
Нужен аккаунт Aizor? Скачивание бесплатное, промокод kalsin5 даёт −5% на каждое пополнение.
Открыть Aizor ↗Как получить ключ API: по шагам
В отличие от многих сервисов, здесь один «токен» заменён парой значений: уникальный код ВАТС (vpbx_api_key) и ключ для создания подписи (vpbx_api_salt).
- Войдите в личный кабинет MANGO OFFICE и выберите вашу ВАТС.
- Откройте раздел «Интеграции».
- Нажмите пункт «API коннектор». Если коннектор не подключён, на вкладке настройки нажмите «Подключить API Коннектор».
- В полях формы «Данные вашей АТС» посмотрите уникальный код и ключ для создания подписи. При подключении они генерируются автоматически.
- По желанию включите безопасный доступ и составьте список IP-адресов, с которых разрешён доступ по API.
- Включите только нужные настройки: «Записи разговоров» (для доступа к записям) и «Услуги ВАТС».
Если нажать кнопку генерации нового кода и ключа, старые перестанут подходить: настройки подключённой системы придётся обновить. Срок действия значений в документации не указан. Затем установите скилл MANGO OFFICE из каталога Aizor и вставьте код и ключ в его настройки. Подпись запросов по формуле из документации (sign = sha256(vpbx_api_key + json + vpbx_api_salt)) обычно считает сам скилл, вам это делать не нужно.
Проверка: первые запросы агенту
- «Покажи статистику звонков за вчера» (только чтение).
- «Найди запись последнего разговора с этим номером».
- «Отправь SMS клиенту с текстом…» (отправка: включите подтверждение действий).
- «Позвони клиенту с номера сотрудника…» (звонок: тоже под подтверждением).
Попробовать на своём кабинете. Aizor скачивается бесплатно, есть тариф со своими API-ключами. Промокод kalsin5 даёт скидку 5% на пополнение баланса.
Сценарии автоматизации
Сводка по звонкам по расписанию
Через планировщик Aizor агент может раз в день присылать вам статистику вызовов: сколько звонков было и сколько осталось без ответа. Запрос статистики в документации устроен в два шага: сначала запуск формирования, потом получение результата.
Поиск записи разговора
Вы просите найти запись по номеру клиента и дате. Агент находит её и отдаёт ссылку или файл. Помните, что при включённой настройке «Записи разговоров» записи по прямым ссылкам доступны без авторизации в кабинете.
Обратный звонок
Агент инициирует вызов (callback) от имени сотрудника на номер клиента. Вы говорите, кому позвонить, а сотрудник берёт трубку. Только по вашей команде и лучше с подтверждением.
SMS клиенту
Агент отправляет короткое SMS, например напоминание. В документации сказано, что тарификация идёт за счёт указанного сотрудника, поэтому следите за расходом на связь. Для сообщений в WhatsApp или Telegram есть отдельные скиллы, например Telegram-бот.
Частые ошибки
| Что видите | Причина | Что делать |
|---|---|---|
| Ошибка 401 | Превышена квота неверных запросов: допускается 1 неверный запрос в 2 минуты. | Подождите 2 минуты и проверьте код, ключ и подпись. |
| Код ответа 3100 | Переданы неверные параметры команды. | Проверьте номер и сотрудника в запросе. |
| Код ответа 2xxx | Команда запрещена биллинговой системой ВАТС. | Проверьте баланс и тариф в кабинете. |
| Код ответа 4300 | SMS отправить не удалось. | Проверьте номер, имя отправителя и текст. |
| Ответ 429 «Rate limit exceeded» | Превышен лимит запросов в секунду. | Подождите и повторите. Для callback лимит 4 в секунду по продукту. |
Безопасность
- Код и ключ дают доступ ко всем возможностям API вашей АТС. Хранить их нужно только в настройках скилла.
- Включите список разрешённых IP-адресов, если у вас постоянный адрес. Документация рекомендует безопасный доступ с белыми адресами.
- Включайте «Записи разговоров» только если они нужны: записи по прямым ссылкам доступны без входа в кабинет.
- Звонки и SMS стоят денег и уходят клиентам, поэтому пускайте их через ручное подтверждение.
- Если код или ключ утекли, сгенерируйте новые в «API коннектор» и обновите настройки скилла. Старые значения перестанут работать.
Инструкция написана по официальной документации MANGO OFFICE (mango-office.ru/support/5_api-i-razrabotka), состояние на октябрь 2026 года. Интерфейс кабинета и условия могут измениться. Автор Aizorlab участвует в партнёрской программе Aizor.
