API документация · /mango/office · 341 документ

MANGO OFFICE API: Виртуальная АТС, Контакт-центр, коллтрекинг и Манго Диалоги

Методы API Виртуальной АТС: команды вызовов и SMS, уведомления API Realtime, статистика, записи разговоров, сотрудники и адресная книга. Плюс API Контакт-центра, Коллтрекинга и Манго Диалогов. Ищите на сайте или подключите MCP-сервер — каждый ответ со ссылкой на docs.mango-office.ru.

Паспорт источника

Service ID
/mango/office
Источник
docs.mango-office.ru — официальная документация
Документов
341
Состав
341 страница · 164 метода · ВАТС, КЦ, коллтрекинг и диалоги
Проверка источника
31.07.2026
Версия API
не подтверждена
docs.mango-office.ru/ru/5_api-i-razrabotka/index.html

Что включено

341 документ MANGO OFFICE API в одном поиске

Сохранённые копии docs.mango-office.ru. У каждого документа — ссылка на официальную страницу и дата импорта.

  • Общие сведения и подключение

    36

    Назначение и требования, лимиты запросов, модели взаимодействия и авторизации, ключи и параметр sign, эмулятор, коды результатов, примеры поведения.

    • Параметр sign
    • Лимиты запросов к API
    • Список кодов результатов
  • API ВАТС: события, команды, статистика

    47

    Уведомления API Realtime, команды вызовов и SMS, правила переадресации, статистика вызовов, записи разговоров и речевая аналитика.

    • POST /vpbx/commands/callback
    • Уведомление о вызове
    • POST /vpbx/stats/request
  • API ВАТС: конфигурация и справочники

    90

    Сквозная аналитика, сотрудники, SIP-учётки и баланс, запрещённые направления вызова, адресная книга, записи из офлайн-источников.

    • POST /vpbx/config/users/request
    • Создать SIP-учётку
    • Адресная книга: контакты
  • API Контакт-центра

    90

    Подключение API КЦ, автоперезвон, статусы и сессии, сделки, кампании исходящего обзвона, данные для звонка, обращения, задачи, мобильное приложение.

    • Задача на автоперезвон
    • Кампании исходящего обзвона
    • Работа с обращениями
  • API Коллтрекинга

    15

    Получение звонков на номера коллтрекинга, вебхуки и их параметры, пользовательские параметры, JavaScript API, API для сторонних АТС.

    • Количество звонков
    • Вебхуки коллтрекинга
    • JavaScript API
  • API Манго Диалоги

    63

    Текстовые каналы — WhatsApp, Telegram, ВКонтакте, Авито, MAX, почта, чат на сайте; каскадные рассылки, управление сессиями, Realtime-вебхуки, коды ошибок.

    • POST /cc/send_text_message
    • Управление сессиями
    • Realtime-вебхуки

С чего начать

Как подключить API Виртуальной АТС: пять шагов по документации

Коротко по разделам «Основные сведения» и «Общие положения о взаимодействии систем» на docs.mango-office.ru. Подробности каждого шага — в поиске Bridge8 или у вашего ИИ-агента.

  1. Подключите API коннекторВ Личном кабинете: «Интеграции» → «API коннектор» → «Подключить API коннектор». Без этого методы, которые работают с услугами ВАТС, вернут код 5201.
  2. Скопируйте ключиНа странице «API коннектор» — уникальный код ВАТС (vpbx_api_key) и ключ для создания подписи (vpbx_api_salt).
  3. Укажите адрес своей системыПри подключении задайте базовый адрес внешней системы — на него ВАТС шлёт запросы и уведомления. Можно ограничить IP, с которых принимаются запросы к API.
  4. Подписывайте запросыPOST на https://app.mango-office.ru/vpbx/ с полями json, vpbx_api_key и sign = sha256(vpbx_api_key + json + vpbx_api_salt).
  5. Откройте доступ для API RealtimeРазрешите входящие запросы с 81.88.80.132, 81.88.80.133, 81.88.82.36, 81.88.82.44 и 81.88.82.45 — с этих адресов ВАТС отправляет уведомления.

Лимиты API ВАТС, запросов в секунду

Все запросы
10 на продукт · 100 всего
Заказ звонка (callback)
4 на продукт · 10 всего
Чтение адресной книги
50 на продукт · 100 всего

При превышении лимита обработка запросов временно останавливается, API отвечает статусом 429 «Rate limit exceeded». Свои лимиты — у перевода вызова, записи разговора, статистики и баланса.

docs.mango-office.ru/ru/5_api-i-razrabotka/1_api-mango-office/3_osnovnye_svedeniya/1_4_limity_kolichestva_zaprosov_k_api/1_4_2_api_vats.html
Только TLS 1.2

Внешняя система должна работать по HTTPS с TLS 1.2: TLS 1.0, 1.1 и 1.3 API не поддерживает — раздел 1.3 «Ограничения».

Документация

Частые задачи: методы и руководства

Название ведёт на документ в поиске Bridge8, стрелка — на официальную страницу docs.mango-office.ru.

Методы API

7 из 164
Все 164 метода в поиске

Руководства и справка

7 из 341
Все 341 страница документации в поиске

Как использовать

Три способа работать с документацией MANGO OFFICE API

Без регистрации — на сайте. С регистрацией — через MCP-сервер прямо в Claude Code, Cursor или своём агенте.

  1. 01 · На сайте

    Поиск без регистрации

    Выберите MANGO OFFICE API в поиске и введите метод или задачу. Результаты — только из этого источника, со ссылкой на docs.mango-office.ru.

    MANGO OFFICE API · 341 → инициирование вызова
  2. 02 · ИИ-агент по MCP

    Спросите Claude Code или Cursor

    Агент сам находит сервис, ищет фрагменты и читает документ целиком. В ответе — ссылка на источник и дата импорта.

    «Напиши на Python подпись запроса к API ВАТС MANGO OFFICE и заказ звонка через /vpbx/commands/callback. Сверь параметры с docs.mango-office.ru»
    resolve_service → search_docs → get_document

  3. 03 · Документ целиком

    Читайте страницу полностью

    get_document отдаёт документ постранично: параметры, поля, примеры. Удобно, когда агенту нужна вся страница, а не фрагмент.

    get_document → POST /vpbx/commands/callback

Пример ответа · POST /vpbx/stats/request

MANGO OFFICE API /mango/office

POST /vpbx/stats/request

Запускает формирование базовой статистики вызовов по фильтру. Обязательны только date_from и date_to; период выборки — не больше одного месяца.

Параметры

date_fromtimestamp
Начало периода: unix-время, часовой пояс UTC+3, точность до секунды.
date_totimestamp
Конец периода статистики.
fieldsstring
Какие поля и в каком порядке включить в выгрузку, например entry_id.
docs.mango-office.ru/ru/5_api-i-razrabotka/1_api-mango-office/5_opisanie_metodov_api_virtualnoy_ats_mango/4_4_api_statistika/1_4_1_zapros_bazovoy_statistiki/3_4_1_1_zapusk_formirovaniya_statistiki.html

API ВАТС · раздел 3.4.1.1версия не подтверждена

Подключение

Подключите документацию MANGO OFFICE API к ИИ-агенту

Один MCP-сервер Bridge8 — и агент знает MANGO OFFICE API и ещё 16 API: VK, Яндекс Директ, Битрикс24, Авито и другие. Доступ бесплатный, вход по коду из письма — без пароля.

Как подключить за минуту

  1. Получите токенВойдите в личный кабинет по почте и создайте Bearer-токен.
  2. Добавьте серверАдрес https://bridge8.ru/mcp, транспорт Streamable HTTP. В совместимых клиентах можно войти через OAuth.
  3. Спросите про MANGO OFFICE API«Найди в MANGO OFFICE API, как рассчитать параметр sign, и покажи ссылку на источник».
Только документация

Bridge8 не подключается к вашей Виртуальной АТС, не хранит vpbx_api_key и vpbx_api_salt, не звонит и не отправляет SMS. Агент получает документацию и сам пишет код.

Claude Code — команда
claude mcp add --transport http bridge8 \ https://bridge8.ru/mcp \ --header "Authorization: Bearer <TOKEN>"
JSON для --mcp-config
{ "mcpServers": { "bridge8": { "type": "http", "url": "https://bridge8.ru/mcp", "headers": { "Authorization": "Bearer <TOKEN>" } } } }

Инструменты сервера — в порядке вызова

  1. resolve_serviceНаходит сервис и версию по названию: «VK API», «Директ», «Битрикс24».
  2. search_docsИщет фрагменты внутри выбранного сервиса — до 10 за запрос.
  3. get_documentЧитает документ целиком, постранично, со ссылкой на источник.

Вопросы

Вопросы о MANGO OFFICE API

Что такое API MANGO OFFICE?

Раздел «API и разработка» документации MANGO OFFICE: API Виртуальной АТС (уведомления, команды вызовов и SMS, статистика, записи, конфигурация), API Контакт-центра, API Коллтрекинга и API Манго Диалоги. Внешняя система подключается через API коннектор, а её права определяются правами сотрудника ВАТС.

Где взять ключи и как подписать запрос?

В Личном кабинете: ВАТС → «Интеграции» → «API коннектор» — там код ВАТС vpbx_api_key и ключ подписи vpbx_api_salt. В тело POST передают json, vpbx_api_key и sign = sha256(vpbx_api_key + json + vpbx_api_salt). Подписываются все запросы — и от внешней системы, и от API ВАТС.

Какие лимиты у API ВАТС?

Общий лимит — 10 запросов в секунду по продукту и 100 всего, для заказа звонка — 4 и 10. При превышении API отвечает 429 «Rate limit exceeded». Неверные запросы (коды 3ХХХ) — не чаще 1 раза в 2 минуты, иначе ошибка 401 и блокировка доступа на 2 минуты.

Как получать события о звонках?

Через API Realtime: ВАТС сама отправляет уведомления на адрес вашей системы — например, POST /events/call с entry_id, call_id, call_state и location. Откройте доступ для адресов 81.88.80.132, 81.88.80.133, 81.88.82.36, 81.88.82.44 и 81.88.82.45.

Как получить запись разговора?

Методом POST /vpbx/queries/recording/post с recording_id и action (download или play) — документация называет его наиболее защищённым способом. Ссылки в ответе временные: после первого доступа к файлу они недействительны, сохранять их не нужно.

Как подключить API Коллтрекинга?

Создайте токен в Личном кабинете: «Коллтрекинг» → «Настройки» → «API» → «Создать токен» — он подходит для всех виджетов. Ещё нужен идентификатор виджета. Токен передают в access_token или в заголовке Authorization: Bearer; в данных о звонке есть yaCid — идентификатор клиента Яндекс Метрики.

Это официальный сайт MANGO OFFICE?

Нет. Bridge8 хранит копию раздела «API и разработка» с docs.mango-office.ru для поиска и ИИ-агентов. У каждого фрагмента — ссылка на первоисточник и дата импорта; версия API не подтверждена. Разделы «Интеграции» и «API Сервер-клиент» в корпус не входят.

Bridge8 может звонить через мою АТС?

Нет. Bridge8 — документация для разработчиков: он не подключается к Виртуальной АТС от вашего имени, не выдаёт и не хранит vpbx_api_key и vpbx_api_salt, не звонит и не отправляет SMS.

Ещё в Bridge8

Один поиск и один MCP-сервер для 17 API, справки и курсов. Сервисы и версии ищутся раздельно и не смешиваются.

Другие API в Bridge8

16 API · 5 417 документов

Справка и курсы

8 источников

Справка Яндекс Директа, Справка Яндекс Метрики, Справка Яндекс Вебмастера, Справка Яндекс Вордстата, Справка VK Рекламы, Справка Авито Рекламы, Курсы Яндекса (ЯРД), Курсы VK Рекламы.

Каталог на главной

Нет нужного API?

Добавим документацию вашего API в Bridge8

Напишите, какой API нужен вам или вашим клиентам, и пришлите ссылку на официальную документацию. Мы проверим источник и подключим его к поиску, каталогу и MCP-серверу — со ссылкой на первоисточник у каждого ответа.

info@lidfly.rugithub.com/awaik/bridge8

Что прислать

  1. Ссылку на документациюОфициальный сайт, OpenAPI/Swagger или репозиторий с описанием методов.
  2. Название и версию APIНапример, «Ozon Seller API». Версии ищутся отдельно и не смешиваются.
  3. Для чего он нуженИнтеграция, ИИ-агент, поддержка клиентов — так мы поймём приоритет.