7. Интеграция GRAVITY

Интеграция Gravity Business Messenger в amoCRM

Интеграция с amoCRM позволяет автоматически передавать контакты и сделки — больше не придётся создавать их вручную.

После настройки в чате Gravity появится панель интеграции: с её помощью можно создать в amoCRM контакт и сделку, заполнив поля «Имя», «E‑mail», «Телефон».
Если посетитель не представился (поле «Имя» пусто), в amoCRM будет создан контакт на основе ID пользователя в Gravity и имени по умолчанию (например, Visitor 123).

![Панель интеграции в диалоге]({{ :ia1.png }})
Панель интеграции в диалоге.

Управлять передачей данных можно из окна текущего диалога или из Журнала.

![Завершённый диалог в Журнале Gravity]({{ :ia2.png }})
Завершённый диалог в Журнале Gravity.

В рамках этой инструкции принимаем, что ЛИД и сделка в amoCRM — это одно и то же.

Шаг 1. Откройте меню интеграции в amoCRM

Войдите в amoCRM и перейдите в раздел amoМаркет.
В правом верхнем углу нажмите Меню → Создать интеграцию.

![Создание новой интеграции в amoMarket]({{ :ia3.png }})
Создание новой интеграции в amoMarket.
Выберите тип «Внешняя интеграция».

![Выбор типа интеграции в amoCRM]({{ :ia4.png }})
Выбор типа интеграции в amoCRM.

Почему внешняя интеграция? Она использует только API amoCRM (без JS‑кода виджета), настраивается индивидуально для каждого сайта и даёт больше возможностей.

Шаг 2. Заполните основные сведения об интеграции

Заполните поля следующим образом:

Поле	Значение
Ссылка для перенаправления	`https://amo.gravi.org/`
[Пустое поле]	Оставьте пустым
Предоставить доступ	Галочка «Все»
Контроль дублей	Галочка
Название интеграции	Любое
Описание	Любое
Логотип	Загрузите изображение

![Заполнение полей]({{ :ia5.png }})
Заполните поля.

Шаг 3. Выключите и включите интеграцию

Отключите созданную интеграцию.

![Отключение интеграции]({{ :ia6.png }})
Отключите созданную интеграцию.
Снова включите её, поставив галочку «Согласен».

![Включение интеграции]({{ :ia7.png }})
Включите созданную интеграцию, установив галочку «Согласен».

Шаг 4. Создайте интеграцию с amoCRM в личном кабинете Gravity

Интеграции в Gravity привязываются к каналам связи. Если у вас несколько каналов и нужно передавать данные по каждому — создайте отдельную интеграцию для каждого канала.

![Создание интеграции в amoCRM со стороны Gravity]({{ :ia8.png }})
Создание интеграции в amoCRM со стороны Gravity.

Шаг 5. Скопируйте и вставьте секретный ключ, ID интеграции и код авторизации

В amoCRM скопируйте:
- секретный ключ;
- ID интеграции;
- код авторизации.
![Копирование данных в amoCRM]({{ :ia9.png }})
Скопируйте секретный ключ, ID интеграции и код авторизации в amoCRM.
В настройках интеграции Gravity вставьте:
- субдомен amoCRM;
- секретный ключ;
- ID интеграции;
- код авторизации.
![Вставка данных в Gravity]({{ :ia10.png }})
Вставьте из amoCRM в Gravity субдомен amoCRM, секретный ключ, ID интеграции и код авторизации.

⚠️ Важно! Код авторизации действителен только 20 минут. Если время вышло, а интеграция в Gravity ещё не настроена, удалите старую интеграцию в amoCRM и создайте новую.

Субдомен и ID интеграции изменить нельзя. Секретный ключ можно сгенерировать заново в amoCRM и обновить в настройках Gravity.

![Субдомен amoCRM]({{ :ia11.png }})
Для каждого аккаунта amoCRM создаёт собственный субдомен. Чаще всего он совпадает с именем администратора, создавшего учётную запись.

Шаг 6. Проверьте успешность интеграции

Если всё настроено верно, вы увидите соответствующее уведомление.

![Успешная интеграция]({{ :ia12.png }})
Если интеграция выполнена успешно, вы увидите этот экран.

Важные нюансы:

Интеграцию можно включать и отключать. При отключении обмен данными прекращается, при повторном включении — возобновляется.
Панель интеграции отображается только для каналов с настроенной интеграцией. Если интеграция отключена, панель исчезает.
Удаление интеграции — необратимое действие. После этого придётся настраивать всё заново (и в amoCRM, и в Gravity).

Шаг 7. Функции интеграции amoCRM в журнале Gravity

Обмен данными возможен в автоматическом и ручном режимах.

Автоматическая передача данных

Установите флажки «Создавать контакт при начале диалога» (в режиме бета‑тестирования отключено) и «Создавать лид по завершении диалога».

Ручной режим

Если контакт создан, но сделка не сформирована автоматически, в архивном диалоге появится панель интеграции с кнопкой «Создать Лид».

![Панель интеграции в журнале Gravity]({{ :ia13.png }})
Панель интеграции в журнале Gravity.

Если сделка уже создана (вручную или автоматически), вместо кнопки отобразится её ID.

![ID сделки]({{ :ia14.png }})
Если сделка была создана ранее, отобразится её ID.

В сделку передаётся копия диалога и контактные данные посетителя.

![Автоматически созданная сделка в amoCRM]({{ :ia15.png }})
Автоматически созданная сделка в amoCRM на основе данных из Gravity.

Панель интеграции отображается, только если контакт в amoCRM уже создан. Если контакта нет — панель не показывается.

Интерфейс интеграции доступен только в режимах TRIAL и PROF.

При возникновении сложностей напишите на support@gravi.org.

Интеграция Gravity Business Messenger в Bitrix24

Реализация интеграции в меню настроек

Интеграция настраивается отдельно для каждого канала связи.

⚠️ Требования: у пользователя должны быть права администратора; лицензия — PROF или TRIAL.

Порядок действий:

Перейдите в Меню настроек (иконка с тремя горизонтальными линиями) → Каналы связи.
Выберите нужный канал связи.
В окне настроек канала откройте вкладку Интеграция CRM → Bitrix24.
Нажмите «Создать интеграцию».

![Начало настройки интеграции]({{ b1.png }})

После нажатия откроется окно «Создать интеграцию с Bitrix24».

![Окно создания интеграции]({{ b2.png }})

Как заполнить поле «Субдомен Bitrix24»:

Для каждого аккаунта Bitrix24 создаёт свой субдомен — обычно он совпадает с именем администратора.

Все нужные данные находятся в свойствах интеграции в Bitrix24. Часть адреса, выделенную зелёным прямоугольником (без начального и конечного слеша!), вставьте в поле «Webhook для вызова REST API».

![Пример субдомена Bitrix24]({{ b3.png }})

После подтверждения в форме канала появятся настройки интеграции.

![Настройки интеграции в Gravity]({{ b4.png }})

Нюансы:

Интеграцию можно включать/отключать. При отключении обмен данными останавливается, при включении — возобновляется.
Удаление интеграции — необратимо. Повторную настройку придётся делать заново (только в Gravity).
Субдомен и ID интеграции нельзя изменить. Секретный ключ можно перегенерировать в Bitrix24 и обновить в Gravity.

Автоматическая и ручная передача данных

Для автоматической передачи активируйте флажки:

«Создавать контакт при начале диалога»;
«Создавать лид по завершении диалога».

Если имя посетителя не указано, в Bitrix24 создаётся контакт на основе ID в Gravity BM и имени по умолчанию (например, Visitor 123).

Реализация интеграции в пользовательском интерфейсе

Передача данных возможна из окна текущего Диалога или Журнала.

Интерфейс интеграции доступен только в режимах TRIAL и PROF.

В правой части экрана текущего диалога отображается панель интеграции. Она видна только для каналов с активной интеграцией. При отключённой интеграции панель исчезает.

![Панель интеграции в диалоге]({{ b5.png }})

Для новых посетителей доступна кнопка «Новый». При нажатии в Bitrix24 отправляются данные из полей «Имя», «Email», «Телефон». После этого Bitrix24 возвращает ID контакта — он отобразится в интерфейсе.

Обновить информацию о посетителе можно кнопкой «Обновить». Обратная синхронизация в текущей версии недоступна.

![Кнопка «Обновить»]({{ b6.png }})
Обновить информацию о посетителе возможно, нажав кнопку «Обновить». Обратная синхронизация недоступна.

В Журнале также доступны функции интеграции:

Если контакт есть, но лид не создан — появится кнопка «Создать Лид».
Если лид уже есть — отобразится его ID.

![Функции интеграции в Журнале]({{ b7.png }})

Если контакт в Bitrix24 не создан, панель интеграции не отображается.

Интеграция канала Gravity с Telegram

Регистрация бота в Telegram

Сначала нужно зарегистрировать пользовательского бота через BotFather (@BotFather).

Его можно найти через поиск или по ссылке: https://t.me/BotFather. Убедитесь, что аккаунт верифицирован (есть галочка).

Запустите сервис кнопкой /start. BotFather покажет меню с описанием функций.

Для создания нового бота выберите команду /newbot.

Регистрация проходит в два этапа:

Введите название бота — оно будет видно пользователям.
Укажите username — уникальное имя бота. Оно должно состоять из английских букв и цифр и обязательно заканчиваться на «bot».

![Регистрация нового бота]({{ :ф4.png }})

После завершения регистрации сохраните token — он нужен для связи с Gravity. С его помощью будут отправляться и приниматься сообщения.

Чтобы узнать token для существующего бота, используйте команду /mybots. BotFather покажет список ваших ботов и меню для каждого. Выберите нужную команду, чтобы получить API Token.

![Список ботов]({{ :ф5.png }})
![Получение токена]({{ :ф6.png }})

Настройка канала Gravity

Перейдите в Меню → Каналы связи.
Выберите канал, через который хотите работать с Telegram.

![Выбор канала связи]({{ :ф7.png }})
В настройках канала откройте Интеграция с мессенджерами → Telegram.

![Переход к интеграции с Telegram]({{ :ф8.png }})
В поле «Код авторизации» вставьте token, полученный от BotFather, и нажмите «Сохранить».

Управление интеграцией:

Чтобы удалить интеграцию — нажмите «Удалить интеграцию».
Чтобы временно отключить обмен сообщениями, снимите галочку «Включена» и нажмите «Сохранить» (настройки сохранятся).

Распространение ссылки на Telegram‑бота

Ссылку на бота можно распространять любыми способами: через сайты, форумы, соцсети и мессенджеры.

Gravity позволяет дополнительно опубликовать ссылку в разделе «Дополнительные виды связи».

Нажмите кнопку «Добавить» в правом нижнем углу.
В открывшемся окне укажите ссылку на вашего Telegram‑бота.

![Добавление вида связи]({{ :пф1.png }})

Интеграция Gravity‑чата в Yandex Metrika

Чтобы анализировать конверсию и эффективность работы чата, подключите его к Yandex Metrika. Вы получите статистику по целевым действиям.

![Статистика в Yandex Metrika]({{ :301.png }})

Пошаговая настройка:

Перейдите в Меню → Каналы связи.

![Переход в Каналы связи]({{ :iy302.png }})
В настройках канала выберите вкладку Yandex Metrika и вставьте номер вашего счётчика.

![Настройка счётчика]({{ :iy303.png }})
Двойным кликом выделите код нужной цели.

![Выделение кода цели]({{ :iy304.png }})
Добавьте новую цель в Яндекс Метрике.

![Добавление цели]({{ :iy305.png }})
Статистику по цели просматривайте в разделе «Конверсии».

![Просмотр статистики]({{ :iy306.png }})

Если у вас остались вопросы по интеграции, напишите на support@gravi.org.