Собирайте сводку по сделкам Мегаплана к утренней планёрке

Агент обращается к API Мегаплана третьей версии на адресе вашего аккаунта: сделки, задачи, проекты и контрагенты — четыре раздела, из которых собирается почти любой отчёт. По ним считаются суммы в работе по этапам и менеджерам, зависшие сделки, просроченные и подходящие к дедлайну задачи, активность сотрудников за период. Карточку конкретной сделки или задачи он дочитывает отдельным запросом, когда нужны детали, а не тянет всё подряд.

У Мегаплана свой стиль запросов: фильтры, поля и сортировка передаются JSON-структурой прямо в адресе, а связанные сущности приходят ссылками — контрагент в сделке это идентификатор, а не название. Поэтому агент перечисляет нужные поля и подтягивает связи адресно, иначе ответ распухает, а в отчёте вместо клиента остаётся номер. Мегаплан совмещает CRM и трекер, и ответственный за задачу далеко не всегда менеджер сделки — агент их не путает.

На запись агент создаёт сделки и задачи, меняет статусы и назначает ответственных: например, разбирает входящие обращения и заводит по ним карточки по вашим правилам. Смену статуса сделки он подтверждает отдельно — в Мегаплане это событие, на которое навешаны уведомления и переходы. О новых, изменённых и удалённых сделках и о смене их статуса Мегаплан присылает подписанные вебхуки, так что реакция не ждёт следующего опроса.

Подключение — логин и пароль учётной записи: агент обменивает их на токен, который живёт около часа и продлевается сам, — копировать ключи вручную не нужно. Длинные списки Мегаплан отдаёт страницами с ограничением на размер выборки, поэтому период агент проходит постранично и складывает итог сам, а не обрывает отчёт на первой сотне. Запросы к сделкам, задачам, контрагентам и проектам идут в щадящем темпе, групповые операции — ещё реже. Если записей за период нет, агент скажет это прямо, а не покажет пустую таблицу.