amoCRM: подключение

Чтобы RevRoute забирал из amoCRM заявки, оплаты и отмены и сам начислял по ним комиссии партнёрам, нужны три вещи:

1. Долгосрочный токен внешней интеграции — с ним RevRoute читает сделки вашего аккаунта.
2. Метка перехода в сделке — по ней RevRoute узнаёт, от какого партнёра пришёл клиент.
3. Стадии сделок — на каких стадиях сделка считается оплаченной, возвращённой или отменённой.

Интеграция доступна на тарифе Business и выше. Подключает администратор amoCRM, это занимает несколько минут.

Токен

1. amoМаркет

В левом меню amoCRM откройте amoМаркет.

2. «Создать интеграцию»

Справа вверху нажмите «⋯» и выберите «Создать интеграцию».

3. «Внешняя интеграция»

В окне «Создание интеграции» нажмите «+ Создать» рядом с «Внешняя интеграция». Приватная интеграция не подходит: долгосрочный токен есть только у внешней.

4. Заполните форму и сохраните

• «Ссылка для перенаправления» — https://revroute.ru. Поле обязательное, RevRoute его не использует.
• «Предоставить доступ: Все» — поставьте галочку.
• «Название интеграции» — например, RevRoute.

Нажмите «Сохранить». amoCRM может попросить подтвердить создание кодом из письма.

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

Откройте созданную интеграцию, вкладку «Ключи и доступы», и в блоке «Долгосрочный токен» нажмите «Сгенерировать токен». Выберите срок действия — можно до пяти лет — и скопируйте токен кнопкой копирования справа от поля.

Токен длинный — больше тысячи символов. Копируйте его кнопкой, а не выделением: выделение легко захватывает не всё, и RevRoute такой токен не примет.

6. Интеграции → amoCRM

В RevRoute откройте «Настройки» → «Интеграции» и нажмите карточку amoCRM.

7. Поддомен аккаунта

Впишите часть адреса amoCRM до .amocrm.ru: для example.amocrm.ru это example.

8. Долгосрочный токен

Вставьте токен из шага 5 целиком.

9. «Подключить»

Нажмите «Подключить». RevRoute проверит токен, сам создаст в сделках поле для метки перехода и подпишется на изменения сделок.

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

Токен даёт доступ к вашему аккаунту amoCRM — не публикуйте его и не присылайте в открытые чаты. Если он попал не туда, удалите интеграцию в amoCRM («Редактировать» → «Удалить интеграцию») — старый токен перестанет работать, — создайте новую по шагам 1–5 и нажмите в RevRoute «Заменить токен». Роли стадий и история сохранятся. Токен, у которого заканчивается срок, меняется так же: сгенерируйте новый и нажмите «Заменить токен».

Метка перехода в сделке

При подключении RevRoute создаёт в сделках поле «RevRoute: метка перехода». Это единственное изменение в ваших данных amoCRM, больше RevRoute в них ничего не меняет.

Когда посетитель переходит по партнёрской ссылке, на вашем сайте в браузере сохраняется метка — cookie rr_id (её ставит скрипт RevRoute на сайте). Чтобы клиент засчитался партнёру, эту метку нужно положить в поле «RevRoute: метка перехода» вместе с заявкой:

• Форма на сайте с передачей в amoCRM. Добавьте в форму скрытое поле со значением cookie rr_id и сопоставьте его с полем сделки «RevRoute: метка перехода» — так же, как вы передаёте UTM-метки.
• Сайт создаёт сделки через API. Передайте метку по коду поля RR_CLICK_ID при создании сделки (POST /api/v4/leads):

[
  {
    "name": "Заявка с сайта",
    "price": 15000,
    "custom_fields_values": [
      {
        "field_code": "RR_CLICK_ID",
        "values": [{ "value": "<значение cookie rr_id>" }]
      }
    ]
  }
]

Метку можно дописать в сделку и позже, до оплаты: RevRoute заметит изменение сделки и засчитает клиента партнёру. Имя и почту клиента RevRoute берёт из основного контакта сделки.

Сделка из «Неразобранного» попадает в RevRoute, когда менеджер её примет. Отклонённые заявки у партнёра не появятся.

Стадии сделок

Откройте «Настройки» → «Интеграции» → «amoCRM», блок «Стадии сделок»: там все воронки вашего аккаунта. Для каждой стадии выберите роль:

• «Оплачено» — сделка на этой стадии считается продажей, партнёру начисляется комиссия.
• «Возврат» и «Отмена» — комиссия по сделке отменяется. Разница только в том, как событие называется в отчётах.
• Стадии без роли RevRoute не учитывает.

Для стандартных стадий amoCRM RevRoute сам предложит роли: «Успешно реализовано» — «Оплачено», «Закрыто и не реализовано» — «Отмена». Примите подсказки или выберите свои и нажмите «Сохранить».

Заявки загружаются сразу после подключения, а продажи — только со стадий с ролью «Оплачено».

Оплата — не последняя стадия воронки? Если после оплаты сделка идёт дальше («Документы», «Обучение», «Успешно реализовано»), для стадии оплаты выбирайте «Оплачено: эта и все следующие» — роль встанет на неё и на все следующие стадии воронки, кроме неуспешных. Тогда сделка, которая быстро миновала стадию оплаты или обошла её, всё равно станет продажей. Дубля не будет: одна сделка даёт одну продажу, сколько бы стадий она ни прошла.

После сохранения ролей RevRoute перечитает сделки за последние 30 дней по новым ролям. Изменения сделок обычно приходят в RevRoute в течение минуты, а кроме того RevRoute сам проверяет сделки раз в 5 минут. Кнопка «Синхронизировать сейчас» запускает проверку сразу.

Важно знать:

• Сумма продажи — бюджет сделки в момент перехода на стадию «Оплачено». Если бюджет изменить после оплаты, продажа останется на прежней сумме.
• Сделка, которую вернули из «Отмены» снова в «Оплачено», новой продажи не создаёт, отменённая комиссия остаётся отменённой.
• Если токен перестанет работать (его удалили в amoCRM, истёк срок или не оплачен тариф amoCRM), в настройках появится ошибка, а мы получим уведомление. Заявки и продажи за это время не потеряются: после замены токена RevRoute продолжит с того места, где остановился.
• Если комиссия по отменённой сделке уже выплачена, RevRoute автоматически её не отменяет — такие случаи разбирает команда вручную.