Как подключить Instagram* к аккаунту на GetCourse через Bothelp

Если вы уже работаете с подписчиками из Instagram* в сервисе BotHelp, то вы можете настроить связь и с вашим аккаунтом на GetCourse. Это позволит обмениваться сообщениями через аккаунт GetCourse, если пользователи написали:

• в директ вашего бизнес-аккаунта в Instagram*,
• комментарии под постами или Reels, если на стороне BotHelp настроен «Инструмент роста» «Новый комментарий к публикации».

Для связи с аккаунтом на GetCourse вам нужно использовать личный кабинет в BotHelp, в котором уже настроена интеграция с вашим бизнес-профилем в Instagram*.

Подключить BotHelp могут:

• владелец аккаунта,
• сотрудник или администратор с правом «Может настраивать мессенджеры».

Чтобы связать аккаунт GetCourse и кабинет в BotHelp:

1. Войдите в ваш кабинет в BotHelp.
2. Перейдите в раздел «Настройки» — «Интеграции», затем найдите пункт «GetCourse» и откройте настройки.

3. В открывшемся окне укажите данные из раздела «Профиль» — «Настройки аккаунта» — «АПИ» на стороне GetCourse.
   При создании ключа API выберите вариант «Для чтения и записи».

4. Проверьте, что на стороне BotHelp отобразилась корректная интеграция в виде зеленой кнопки.

5. Скопируйте BotHelp SecretKey.

6. Перейдите в аккаунт на GetCourse.
7. Зайдите в раздел «Сообщения» — «Instagram*».
8. Вставьте скопированный BotHelp SecretKey в поле «Токен».

9. Задайте имя бота, оно может быть любым.
10. Нажмите «Добавить».

Интеграция завершена. Теперь если пользователь напишет в директ вашего бизнес-профиля Instagram*, то сообщение через BotHelp будет доставлено во Входящие вашего аккаунта на GetCourse.

На GetCourse вы можете обмениваться сообщениями через директ вашего бизнес-профиля Instagram*. Такую переписку может инициировать только пользователь, написать ему первым вы не сможете.

Работать с сообщениями от пользователей могут:

• владелец аккаунта,
• администратор,
• сотрудник с правом «Может работать со входящими сообщениями».

Сообщение от пользователя из Instagram* поступит в раздел «Входящие», а также будет отображаться в переписке в «Общении с пользователем».

В сообщении вы увидите маркер того бота Instagram*, через которого поступило сообщение от пользователя. Также вы увидите все вложения, которые были отправлены с сообщением (изображения, аудио, видео, голосовые сообщения).

Когда вы напишете ответ, он поступит пользователю в тот же диалог в Instagram* от имени бизнес-профиля. К ответу можно приложить вложения:

• изображение JPEG, PNG до 8 МБ;
• видео MP4, OGG, AVI, MOV, WEBM до 25 МБ;
• аудио aac, m4a, wav, mp4 до 25 МБ;
• файл PDF до 25 МБ.

Если прошло более 7 дней с момента получения последнего сообщения от пользователя, то возможности отправить ответное сообщение не будет.

Если пользователь заблокирует бизнес-профиль или удалит переписку на стороне Instagram*, то при попытке отправить этому пользователю сообщение привязка к Instagram* в профиле пользователя на GetCourse удалится.

При получении сообщения с определенным ключевым словом от пользователя в директ вашего бизнес-профиля Instagram* можно запускать процесс. С его помощью удобно, например, добавлять пользователя в группу, отправлять ему дополнительное сообщение в Instagram* и многое другое.

Для запуска процесса при получении ключевого слова:

1. В разделе «Сообщения» — «Instagram*» перейдите к настройкам автоматического запуска процесса при получении команд.

2. Укажите ключевое слово, при получении которого будет запускаться процесс.
3. Выберите из списка процесс по пользователям и сохраните изменения.

При этом предусмотрена возможность использования дополнительного синтаксиса:

• текст — процесс запустится, если сообщение содержит только искомый текст;
• */текст — процесс запустится, если сообщение заканчивается на искомый текст;
• текст/* — процесс запустится, если сообщение начинается с искомого текста;
• */текст/* — процесс запустится, если в сообщении искомый текст содержится в любом месте.

Когда клиент отправит сообщение, содержащее ключевое слово, то оно будет выделено жирным шрифтом во Входящих/Helpdesk и в «Общении с пользователем».

Если в одном сообщении сразу несколько ключевых слов, то обрабатывается только одна команда в следующем приоритете:

1. Искомый текст в начале (например, Привет/*).
2. Искомый текст в конце (например, */вебинар).
3. Искомый текст в любом месте (например, */купить/*).

При настроенной интеграции вы сможете также отправлять сообщения пользователям в Instagram* через модуль Воронки. Принцип отправки и правила общения в рамках семидневного окна в данном случае остаются такими же, как было описано выше.

Чтобы появилась возможность отправлять сообщения в Instagram* внутри воронки, свяжите со сценой вашу Instagram*-интеграцию.

Отправить сообщения можно с помощью следующих нод:

• Отправить сообщение
• Отправить видео
• Отправить фото
• Отправить вложение

Сообщения поддерживают следующие вложения:

• Изображение (JPEG, PNG, GIF, WebP)
• Видео (MP4)
• Голосовое сообщение (OGG)
• Документ PDF

В нодах «Ввод пользователя» и «Команда бота» вы можете использовать запуск по ключевому слову из Instagram*. Когда пользователь напишет ключевое слово в диалоге с вашим бизнес-аккаунтом, в воронке сработает триггер и запустит дальнейшую цепочку нод. Запуск по ключевому слову также можно использовать для комментариев под постами или Reels, если на стороне BotHelp настроен инструмент роста «Новый комментарий к публикации».

Также следующие ноды поддерживают работу с сообщениями из Instagram*:

• Обновить метки чата
• Проверить метки чата

Чтобы составить список пользователей, у которых подключен Instagram*:

1. Перейдите в раздел «Ученики» — «Пользователи» и нажмите «новая выборка».
2. Добавьте условие «Подключен Instagram*» и нажмите «Выбрать».

Подробнее о правах для работы с сегментами в разделе «Пользователи» читайте в статье.

В списке пользователей с привязанным Instagram* вы можете увидеть как пользователей с обычными почтами так и с техническими вида имя*@instagram*. Пользователи с технической почтой появляются в момент написания сообщения в ваш бизнес-профиль Instagram*. При передаче информации из Instagram* через BotHelp идет сопоставление пользователя по CUID:

• если сопоставление прошло успешно и такой пользователь найден в базе на GetCourse, то профиль Instagram* будет привязан к нему;
• если такой пользователь не был найден, то будет создан новый профиль с технической почтой вида cuid*@instagram*.

У пользователя с технической почтой в профиле будет указан тип регистрации «Instagram*».

У одного пользователя на GetCourse может быть только одна активная привязка к Instagram*. Если пользователь заблокирует ваш бизнес-профиль на стороне Instagram* или удалит переписки с ним, то привязка Instagram* будет удалена и на стороне GetCourse.