Начало работы

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

Что понадобится

Перед настройкой подготовьте:

• проект Senler, в который установлено приложение amoCRM;
• пользователя amoCRM с правом предоставить приложению доступ к CRM;
• агента Senler или автоматизацию, где нужны данные amoCRM.

Подключение относится к конкретному проекту Senler. В другом проекте его нужно выполнить отдельно.

1. Откройте приложение

Откройте установленное приложение amoCRM из нужного проекта Senler. Не используйте прямую ссылку на встроенную страницу: безопасная сессия и идентификатор проекта передаются только при запуске из Senler.

2. Авторизуйте проект Senler

На первом экране нажмите «Войти» и подтвердите доступ приложения к текущему проекту Senler. Эта авторизация нужна один раз; если набор разрешений приложения изменится, вместо неё появится кнопка «Обновить токен».

3. Подключите аккаунт amoCRM

Нажмите «Подключить». В открывшемся окне войдите в amoCRM, выберите аккаунт и подтвердите доступ. Для автоматического подключения событий о смене этапа используйте пользователя amoCRM с правами администратора; доступность API вебхуков также зависит от тарифа.

После успешного возврата статус изменится на «Подключено», а в карточке подключения появятся название аккаунта и его домен.

4. Добавьте действие в Senler

Выберите подходящий способ:

• добавьте инструмент приложения агенту, если решение о работе с CRM должен принимать агент в диалоге;
• добавьте шаг приложения в автоматизацию, если действие должно выполняться в заданном месте сценария.

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

5. При необходимости настройте реакцию на смену этапа

В агенте включите событие приложения «Изменение этапа сделки», если агент должен сам продолжить диалог после смены этапа. Для сценария из нескольких шагов создайте контекстную автоматизацию с одноимённым начальным шагом. Можно включить оба варианта; отдельно настраивать webhook во встроенной странице не нужно.

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

Что получится

После настройки приложение сможет:

• отдельно создать контакт и сделку в amoCRM; чтобы не создавать дубли, сначала проверить контакт текущего лида и список его сделок;
• получить список открытых или завершённых сделок контакта и выбрать нужную по ID, названию и этапу;
• создать новую сделку либо изменить явно выбранную по deal_id;
• изменить этап, воронку, бюджет, ответственного, причину отказа и теги сделки;
• получить актуальные поля контакта и сделки;
• добавить примечание или задачу к контакту либо сделке;
• передать смену этапа назначенному агенту и/или запустить автоматизацию в подходящем диалоге.

Приложение не удаляет сущности amoCRM и не передаёт OAuth-токены агенту, автоматизации или браузеру.