# Телефония Облачные АТС подключаются в разделе **«Интеграции»**. Общие правила (виды подключения, статусы карточки, «Только чтение», отключение) описаны на странице [«Подключение сервисов»](/help/integrations). Как агент спрашивает перед действиями вроде звонка или переадресации, рассказано в [«Как агент меняет данные»](/help/trust). В каталоге телефония лежит в категории [«Мессенджеры»](/integrations/messengers) вместе с чатами и агрегаторами переписки (Wazzup24, Umnico, Chat2Desk и другие): их подключение описано на их страницах интеграций. ## Mango Office Виртуальная АТС: звонки, callback, SMS, статистика, записи разговоров. Подробнее на [странице интеграции](/integrations/mango-office). ### Что умеет агент Собирает статистику звонков по группам и сотрудникам, находит пропущенные, читает записи разговоров, запускает callback и отправляет SMS в пределах прав API коннектора. ### Что нужно заранее Учётная запись владельца или администратора ВАТС в кабинете lk.mango-office.ru. ### Шаги ### Откройте «API коннектор» В кабинете Mango Office: **«Интеграции» → «API коннектор»**. ### Подключите API коннектор Если услуга не активна, нажмите «Подключить API коннектор», отметьте «Я принимаю условия» и подтвердите. Пока коннектор выключен, реквизиты не показываются. ### Перенесите два значения «Уникальный код вашей АТС» в поле **«API-ключ»**, «Ключ для создания подписи» в **«Соль API»**. Значения разные, путать их нельзя: соль участвует в подписи запросов. ### Включите события звонков Скопируйте **«Адрес вебхука»** из карточки подключения целиком и вставьте его в настройках API коннектора в адрес внешней системы. ### Ограничения - События приходят три: звонок завершён, состояние звонка изменилось, запись разговора готова. По ним срабатывают [задачи](/help/tasks), например разбор каждого пропущенного звонка. - Статистика звонков в API Mango Office готовится в два шага: агент заказывает отчёт и ждёт его готовности, поэтому ответ приходит не мгновенно. ### Как отозвать доступ Нажмите **«Отключить»** у нас. В кабинете Mango Office API коннектор отключается в том же разделе «Интеграции». ### Неполадки - **«Ключи не приняты»**: перепутаны код АТС и ключ для подписи, либо коннектор выключен. - **События не приходят**: адрес вебхука вставлен не целиком или не в тот API коннектор. ## Билайн Облачная АТС Облачная АТС: звонки, переадресация, запись разговоров, чёрные списки, детализация. Подробнее на [странице интеграции](/integrations/beeline-cloudpbx). ### Что умеет агент Читает детализацию и записи разговоров, управляет переадресацией и чёрными списками. ### Что нужно заранее Доступ к кабинету cloudpbx.beeline.ru по учётным данным из договора и включённая услуга «Интеграция по API». Услуга платная у Билайна. ### Шаги ### Включите интеграцию по API **«Настройки» → вкладка «API» → переключатель «Интеграция по API»**. ### Выпустите токен На табе «Version 2.0» нажмите «Создать новый токен» и вставьте его в поле **«Токен Portal API»**. Если токена нет, на табе «Version 1.0» выдаётся пара логин и пароль: вставьте их в **«Имя пользователя»** и **«Пароль»**, а «Токен Portal API» оставьте пустым. Это реквизиты вкладки «API», а не вход в кабинет. ### Ограничения Пока услуга «Интеграция по API» выключена, запросы к АТС не проходят. Событий звонков Билайн нам не присылает: новые звонки проверяет задача по расписанию. ### Как отозвать доступ Нажмите **«Отключить»** у нас. В кабинете Билайна выключите «Интеграцию по API» или удалите токен. ### Неполадки - **«Ключи не приняты»**: вставлены логин и пароль кабинета вместо реквизитов вкладки «API». ## Гравител Облачная АТС Облачная АТС: звонки, SMS, история, сотрудники, номера, АОН, кампании обзвона. Подробнее на [странице интеграции](/integrations/gravitel). ### Что умеет агент Читает историю звонков, сотрудников и номера, запускает звонки, SMS и кампании обзвона. ### Шаги ### Установите интеграцию по REST API На gravitel.ru нажмите «Войти в АТС», затем меню **«Интеграции» → «Интеграция по REST API» → «Установить»**. Соседняя «Интеграция по API Гравител» из прошлого поколения не подойдёт. ### Откройте её настройки «Название интеграции» любое. «Адрес вашей CRM» и «Ключ для авторизации в Вашей CRM» заполнять не нужно. ### Перенесите адрес и ключ В подразделе «Авторизация» лежат адрес и ключ АТС. Ключ вставьте в **«API-ключ»**, а в **«Домен Gravitel»** только домен вашей АТС (участок пути после /v1/), а не весь адрес. ### Ограничения Событий звонков Гравител нам не присылает: новые звонки проверяет задача по расписанию. ### Как отозвать доступ Нажмите **«Отключить»** у нас. В кабинете АТС удалите «Интеграцию по REST API». ### Неполадки - **«Ключи не приняты»**: в «Домен Gravitel» вставлен весь адрес, а не домен АТС, или установлена интеграция прошлого поколения. ## Sipuni IP-телефония: история и пропущенные звонки, записи разговоров, статусы сотрудников. Подробнее на [странице интеграции](/integrations/sipuni). ### Что умеет агент Читает историю и пропущенные звонки, записи разговоров и статусы сотрудников. ### Что нужно заранее Подключённая услуга API статистики в кабинете Sipuni. ### Шаги ### Подключите API статистики В старом кабинете: «Настройки» → «API» → «Статистика» → «Подключить услугу». В новом: «Интеграции» → «Интеграция по API» → «Статистика». ### Скопируйте ключ интеграции «Настройки» → «Интеграция по API» (в старом кабинете «Настройки» → «API»). Если ключа нет, нажмите «Сгенерировать» и «Сохранить». Вставьте его в **«Секретный ключ»**. ### Перенесите номер кабинета Номер показан в правом верхнем углу. Вставьте его в **«Номер кабинета Sipuni»** целиком, вместе с начальными нулями. ### Ограничения Номер кабинета и ключ интеграции должны принадлежать одному аккаунту. Событий звонков Sipuni нам не присылает: новые звонки проверяет задача по расписанию. ### Как отозвать доступ Нажмите **«Отключить»** у нас. Ключ интеграции управляется в кабинете Sipuni, в разделе «Интеграция по API». ### Неполадки - **«Ключи не приняты»**: номер кабинета без начальных нулей, и подпись запроса не сходится.