amoCRM

Приложение amoCRM подключает к рабочему столу аккаунт amoCRM или Kommo. После подключения агент работает со сделками, контактами, компаниями, воронками, задачами и примечаниями через API v4.

Назначение

Используйте приложение, когда нужно:

• разобрать открытые сделки по воронкам и этапам;
• найти сделки без следующего шага;
• проверить просроченные задачи и ответственных;
• сопоставить сделки с контактами и компаниями;
• подготовить изменение карточек после проверки результата.

Само приложение не дублирует интерфейс amoCRM. На главной находятся готовые сценарии для агента, а на экране настроек — состояние подключения и управление доступом.

Подключение

Подключать и отключать amoCRM может только владелец рабочего стола.

1. Откройте amoCRM → Настройки.
2. Укажите адрес аккаунта, например https://company.amocrm.ru или адрес в домене kommo.com.
3. Выберите один из вариантов авторизации:

• вставьте долгоживущий токен в поле Долгоживущий токен;
• либо укажите Integration ID, секрет интеграции, код авторизации и тот же Redirect URI, который задан в интеграции amoCRM.

1. Нажмите Проверить и подключить.

При подключении Promto вызывает GET /api/v4/account. Подключение сохраняется только после успешного ответа аккаунта. Код авторизации действует ограниченное время, поэтому вводите его сразу после получения.

Если подключение выполнено через OAuth-код, сервер сохраняет refresh-токен и обновляет access-токен автоматически. Учётные данные хранятся на сервере Promto и не передаются агенту.

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

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

В настройках показаны:

• адрес или имя подключённого аккаунта;
• примеры доступных методов API;
• последняя ошибка подключения;
• переключатель доступа агента;
• кнопка отключения.

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

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

Инструмент агента — promto_amocrm. Сначала агент вызывает capabilities, затем выполняет request к API v4.

Основные пути:

• /api/v4/leads — сделки;
• /api/v4/leads/pipelines — воронки и этапы;
• /api/v4/contacts — контакты;
• /api/v4/companies — компании;
• /api/v4/tasks — задачи;
• /api/v4/leads/{id}/notes — примечания сделки.

Для больших списков агент использует пагинацию page и limit и запрашивает только нужные поля. Ответ прокси ограничен 512 КБ; если он не поместился, в результате будет truncated=true.

Сценарии

Разбор воронки

Через promto_amocrm сначала вызови capabilities, затем прочитай сделки и воронки. Сгруппируй открытые сделки по этапам, покажи сумму, ответственного и сделки без следующей задачи. Ничего не меняй.

Просроченные задачи

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

Обновление сделки

Сначала попросите агента прочитать карточку и показать точный набор изменений. После проверки явно подтвердите запись — только тогда агент повторит запрос с confirm=true.

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

• Запросы POST, PATCH, PUT и DELETE меняют живые данные и требуют отдельного явного подтверждения.
• Адрес подключения принимается только для аккаунтов amoCRM или Kommo.
• Права агента не шире прав выданного токена или интеграции.
• При подключении одним access-токеном без OAuth-набора сервер не сможет получить новый токен, если текущий перестанет действовать.
• Отключение удаляет сохранённые данные подключения и сразу отзывает доступ агента.

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

• Адрес не принимается. Укажите корневой HTTPS-адрес аккаунта в домене amocrm.ru или kommo.com.
• Код авторизации отклонён. Получите новый код и проверьте, что Redirect URI совпадает символ в символ.
• 401 после подключения. Токен истёк или отозван. Для автоматического обновления переподключитесь через OAuth-набор с refresh-токеном.
• 403 на отдельном методе. Проверьте права интеграции на нужные сущности.
• Ответ обрезан. Уменьшите limit, сузьте фильтр или разделите запрос на страницы.

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

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