# Мегаплан

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

Сделки, задачи, проекты, контакты, события

## Как агент работает с Мегаплан

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

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

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

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

## Сценарии интеграции

### Сводка по сделкам в воронке
Агент соберёт сделки Мегаплана по этапам и менеджерам, найдёт зависшие и посчитает суммы в работе за период.

### Контроль просроченных задач
Агент проверит задачи и проекты, выделит просроченные и подходящие к дедлайну и пришлёт список ответственным.

### Отчёт по активности менеджеров
Агент сведёт сделки, задачи и события по сотрудникам и покажет, кто тянет план, а у кого копятся зависшие сделки.

### Заявки и обращения в задачи
Агент разберёт входящие обращения, заведёт по ним задачи или сделки в Мегаплане и назначит ответственных по вашим правилам.

### Клиенты без движения
Агент пройдёт по контрагентам и их сделкам и покажет, кто не появлялся в новых сделках дольше квартала и на какую сумму покупал раньше.

## Как подключить

**Перед подключением**

- Аккаунт Мегаплана на собственном поддомене
- Токен приложения с правами на сделки, задачи и проекты
- Права на запись, если агент создаёт задачи и меняет статусы

### Скопируйте из браузера адрес аккаунта
Скопируйте из браузера полный адрес, например https://company.megaplan.ru.

### В настройках интеграций создайте токен
В настройках интеграций Мегаплана создайте токен с теми правами, которые нужны агенту.

### Вставьте адрес и токен
Укажите адрес аккаунта и токен приложения. Пароль сотрудника сохранять не нужно.

## Частые вопросы

### Как подключить Мегаплан?
Адресом аккаунта и токеном приложения: токен создаётся в настройках интеграций Мегаплана, и агент видит сделки, задачи и проекты, на которые у токена есть права.

### Какие данные видит агент?
Сделки, задачи, проекты, контакты и события в рамках прав токена. Права можно ограничить при создании токена.

### Может ли агент менять данные в Мегаплане?
Да, если у токена есть права: агент может создавать задачи и сделки, менять их статусы и назначать ответственных. С доступом только на чтение агент лишь анализирует.

### Как быстро появляются данные после подключения?
Сразу: агент обращается к API Мегаплана напрямую по вашему запросу, без промежуточных выгрузок.

[Открыть Мегаплан](https://megaplan.ru)