AmoCRM

Об инструменте

Инструмент amoCRM позволяет агенту работать с данными вашей CRM — находить, создавать и обновлять сделки, контакты, компании и задачи, добавлять примечания. Поддерживаются также покупатели, каталоги, звонки и «Неразобранное». Агент подключается к аккаунту через API amoCRM в рамках прав, выданных интеграции; изменяющие действия выполняются только по команде пользователя или после подтверждения.

Настройка

1. Авторизация в Evo

Способ 1. Вход через amoCRM (OAuth)

1. Скопируйте адрес обратного вызова в EvoAI

• Откройте amoCRM в разделе Инструменты.

• Откройте настройки OAuth-клиента.

• Скопируйте адрес перенаправления (Redirect URI), показанный на экране. Пример, https://<ваш-домен-evo>/console/api/oauth/plugin/<plugin\_id>/amocrm/tool/callback

Используйте адрес именно из интерфейса Evo — его нужно будет вставить в amoCRM без изменений.

2. Создайте интеграцию в amoCRM

1. Войдите в amoCRM.

2. Откройте amoМаркет.

3. Нажмите Создать интеграцию.

4. Включите Внешняя интеграция.

5. Заполните необходимые поля. Описание полей от amoCRM

   • В поле «Ссылка для перенаправления» вставьте Redirect URI из EvoAI.

6. Выдайте права доступа: сделки, контакты, компании, задачи. Для расширенных сценариев добавьте покупателей, каталоги, звонки и «Неразобранное».

7. Сохраните интеграцию.

8. На вкладке «Ключи и доступы» скопируйте:

   • ID интеграции;

   • Секретный ключ.

3. Укажите ключи в EVO

В настройках OAuth-клиента AmoCRM вставьте:

• ID интеграции;

• секретный ключ;

• площадку: amoCRM (Россия) или Kommo (глобальная).

Сохраните настройки и авторизуйтесь.

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

1. В карточке авторизации нажмите кнопку входа через OAuth (Authorize).

2. Войдите в amoCRM и подтвердите доступ.

3. Домен аккаунта определится автоматически.

Готово: агент может обращаться к подключённому аккаунту.

Если после входа появляется ошибка обмена кода — чаще всего не совпадает «Ссылка для перенаправления» в amoМаркет и Redirect URI в EVO. Сверьте адреса.

Способ 2. Долгосрочный токен («API-ключ»).

1. Получите токен в amoCRM

1. Войдите в amoCRM.

2. Откройте amoМаркет.

3. Нажмите Создать интеграцию (или откройте уже созданную).

4. Заполните необходимые поля. Описание полей от amoCRM

5. Перейдите на вкладку Ключи и доступы.

6. Скопируйте долгосрочный токен.

7. Проверьте права интеграции: сделки, контакты, компании, задачи и другие нужные разделы.

2. Введите данные в EVO

В форме API-ключа заполните поля:

1. Имя авторизации - назовите авторизацию

2. Адрес аккаунта

   • можно указать поддомен: mycompany (станет mycompany.amocrm.ru);

   • или полный адрес: mycompany.amocrm.ru;

   • для Kommo укажите полностью: mycompany.kommo.com.

3. Долгосрочный токен — вставьте значение из amoМаркет.

4. Сохраните. Подключение проверяется сразу: если домен или токен неверны, ошибка появится при сохранении.

2. Права доступа

Независимо от способа авторизации у интеграции в amoМаркет должны быть права на те разделы, с которыми будет работать агент:

• основной сценарий: сделки, контакты, компании, задачи;

• расширенный: покупатели, каталоги, звонки, «Неразобранное»;

• список сотрудников — если интеграцию устанавливал администратор аккаунта.

3. Использование инструмента

Добавьте инструмент amoCRM агенту. Агент сам решает, когда обратиться к CRM: сначала уточняет структуру аккаунта (воронки, этапы, пользовательские поля, ответственных), затем ищет и читает нужные сущности с фильтром.

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

Примеры задач агенту:

• «Найди контакт Иван Иванов и покажи его сделки» — агент найдёт контакт и подтянет связанные с ним сделки.

• «Покажи открытые задачи по сделке Поставка оборудования» — агент найдёт сделку и отфильтрует задачи по статусу «не выполнена».

• «Добавь контакт Иван Иванов, телефон +79990000000, email test@example.com» — агент создаст контакт с указанными полями.

• «Создай сделку Поставка оборудования для контакта Иван Иванов» — агент найдёт контакт, создаст сделку и привяжет её к контакту.

• «Переведи сделку Поставка оборудования на этап Принимают решение» — агент найдёт сделку, определит нужный этап в её воронке и обновит статус.

Первые три примера — чтение, агент выполнит их сразу. Последние три изменяют данные в CRM, поэтому агент запросит подтверждение.