Мегаплан

Приложение Мегаплан подключает API v3 аккаунта к рабочему столу Promto. Агент работает со сделками, задачами, проектами, клиентами и контрагентами, не получая пароль пользователя API.

Назначение

Подключение удобно для регулярных сводок по продажам и задачам, поиска просрочек, контроля ответственных и подготовки согласованных изменений в Мегаплане.

Подключение

1. Подготовьте пользователя, которому доступен API v3 и нужные разделы Мегаплана.
2. В приложении укажите адрес аккаунта, например https://company.megaplan.ru.
3. Введите email и пароль пользователя.
4. Нажмите Проверить и подключить.

Promto получает токен у Мегаплана, затем проверяет чтение /api/v3/deal. Токен и пароль хранятся на сервере; при истечении токена сервер получает новый автоматически. Подключением управляет только владелец рабочего стола.

Интерфейс и данные

На главной доступны сценарии Активные сделки и Задачи на сегодня. Экран настроек показывает подключённый адрес, примеры возможностей, последнюю ошибку, разрешение агенту и кнопку отключения.

Данные сделок и задач показываются в ответах агента, а не отдельными таблицами внутри приложения.

Возможности агента

Инструмент — promto_megaplan. После capabilities агент обращается к путям относительно /api/v3:

• /deal — сделки;
• /task — задачи;
• /project — проекты;
• /contractor — клиенты и контрагенты;
• /docs — описание API конкретного аккаунта, если оно доступно.

GET-параметры API v3 передаются как один JSON-объект. Для постраничного чтения используются limit, pageAfter и pageBefore.

Сценарии

Активные сделки

Через promto_megaplan сначала вызови capabilities, затем прочитай активные сделки страницами. Покажи этап, сумму, ответственного и ближайшую задачу. Только чтение.

Загрузка команды на сегодня

Через promto_megaplan собери задачи на сегодня, сгруппируй по ответственным и отдельно покажи просроченные.

Ограничения и подтверждения

• Облачный API Мегаплана ограничивает частоту примерно пятью запросами в секунду; агент должен читать данные последовательно и страницами.
• POST, PUT, PATCH и DELETE требуют явного подтверждения и confirm=true.
• Поля и доступные методы зависят от версии аккаунта и прав пользователя.
• Ответы ограничены 512 КБ.
• Сохранённый пароль используется сервером для обновления токена, но не передаётся браузеру или агенту.

Если что-то не работает

• Неверный адрес. Укажите корневой HTTPS-адрес аккаунта без /api/v3.
• Авторизация отклонена. Проверьте email, пароль и право пользователя на API.
• 401 во время работы. Прокси попробует обновить токен. Если пароль изменился, переподключите аккаунт.
• 429 или нестабильные ответы. Уменьшите число параллельных запросов и добавьте паузу между страницами.
• Поле отсутствует. Сверьте схему в документации API вашего аккаунта, а не в примере другого Мегаплана.

Связанные материалы

• Интеграции
• Агенты
• Настройки Promto