JAICP

Instagram


Instagram – одна из важных площадок ведения бизнеса: для многих небольших компаний это единственное место, где они предлагают свои услуги. Многие пользователи узнают о новинках именно из ленты Instagram.

Бота можно подключить к Instagram, чтобы он отвечал в автоматическом режиме:

  • на сообщения в Direct;
  • на комментарии к постам.

Подключить бота к обработке сообщений в Direct можно следующими способами: подключив Instagram напрямую к Aimylogic, через сервис Wazzup или через Jivo.

При подключении Instagram через Jivo бот также сможет обрабатывать ответы и упоминания в Instagram Stories.

Подключение бота к комментариям осуществляется через Открытые линии Битрикс24.

В данной статье описана интеграция Aimylogic с Instagram Direct напрямую.

Подробнее о других способах подключения к Instagram


Возможности интеграции

Канал поддерживает следующие функции:

  • отправку изображений;
  • отправку аудио- и видеофайлов;
  • перевод диалога на оператора;
  • интеграцию с CRM-системами;
  • отправку email и SMS.

Кнопки в интеграции с Instagram не поддерживаются.


Подключение бота к Direct

Прежде чем перейти к настройке интеграции, создайте бизнес-аккаунт в Instagram и аккаунт Business Manager на Facebook.

Для использования интеграции с Instagram Direct:

  1. Создайте и настройте Страницу на Facebook.
  2. Создайте приложение на Facebook.
  3. Добавьте аккаунты Facebook и Instagram в приложение.
  4. Создайте канал Instagram в Aimylogic.
  5. Подключите вебхук.
  6. Протестируйте бота.
  7. Пройдите проверку приложения на Facebook.
  8. Опубликуйте приложение и Страницу.

Создание и настройка Страницы на Facebook

Создание Страницы

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

  1. Авторизуйтесь в аккаунте Facebook и на главной странице в меню слева выберите раздел Страницы.

instagram 1

  1. На открывшейся странице в меню слева нажмите + Создать новую Страницу.

instagram 2

  1. Заполните информацию о Странице: обязательно укажите название страницы и ее категорию. После этого нажмите Создать Страницу.

instagram 3

  1. После создания Страницы вы можете установить фото профиля и обложки, а также заполнить опциональные поля.

Настройка Страницы

Сделайте Страницу неопубликованной:

  1. В меню Управление Страницей нажмите Настройки.
  2. В поле Статус Страницы установите Страница снята с публикации. В качестве причины укажите Страница еще не закончена > Снять с публикации. Теперь вашу страницу могут видеть только администраторы страницы.

instagram 9

Далее предоставим права администратора всем пользователям, которым нужно просматривать диалоги с ботом.

  1. В меню Настройки Страницы перейдите на вкладку Роли на Странице.
  2. Перейдите в раздел Назначить новую роль на Странице.
  3. Выберите пользователя и роль Администратор > Добавить.

Подключение Страницы к бизнес-аккаунту Instagram

Созданную Страницу необходимо привязать к бизнес-аккаунту Instagram, на котором будет общаться бот.

К одному бизнес-аккаунту Instagram можно подключить только одну Страницу.

  1. На главной странице Facebook в меню слева выберите Страницы > (Имя вашей страницы) > Настройки > Instagram.
  2. Нажмите кнопку Подключить аккаунт.

instagram 17

  1. В модальном окне разрешите доступ к сообщениям из Instagram в разделе Входящие и нажмите Продолжить.

instagram 18

  1. В новом окне авторизуйтесь в аккаунте Instagram и выберите Страницу, которую хотите привязать.

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


Настройка приложения на Facebook

Создание нового приложения

  1. Перейдите на сайт Facebook for Developers.
  2. Нажмите Войти и авторизуйтесь в аккаунте Facebook. Вы будете перенаправлены на главную страницу Facebook for Developers.
  3. Нажмите Начать работу в шапке страницы.
  4. Пройдите все шаги создания аккаунта Facebook for Developers.
  5. После того как аккаунт будет создан, откройте страницу Мои приложения, нажмите Создать приложение, выберите тип приложения Компания и нажмите Продолжить.

instagram 4

  1. Дайте название приложению и укажите Вы или принадлежащая вам компания в качестве назначения приложения. Выберите ваш аккаунт в Business Manager и сохраните настройки.

instagram 5

После создания приложения вы будете перенаправлены на его страницу.


Добавление аккаунтов Facebook и Instagram

На странице приложения из меню слева перейдите на вкладку Панель. Найдите секцию Добавление продуктов в приложение и выберите Messenger, а затем перейдите на вкладку Настройки Instagram.

Чтобы добавить аккаунты, выполните следующие шаги:

  1. В секции Маркеры доступа нажмите кнопку Добавить или удалить Страницы.

instagram 6

  1. В открывшемся окне для авторизации через Facebook нажмите Продолжить как (имя вашего аккаунта).
  2. Выберите бизнес-аккаунт Instagram, который вы собираетесь использовать в интеграции, и нажмите Далее.
  3. Выберите Страницу на Facebook, связанную с выбранным бизнес-аккаунтом Instagram.
  4. Задайте разрешения создаваемому приложению. Для корректной работы интеграции все разрешения должны быть активны. Нажмите Готово, и приложение будет связано с Facebook, а Страница появится в секции Маркеры доступа на странице приложения.

instagram 7

Если вы выберете Страницу, которая не привязана к выбранному вами бизнес-аккаунту Instagram, она не будет добавлена и не появится в секции Маркеры доступа.

Далее вам необходимо получить маркер доступа. Для этого нажмите Сгенерировать маркер напротив только что добавленной вами Страницы. В модальном окне активируйте опцию Я понимаю и скопируйте маркер. Он понадобится вам при настройке канала на стороне Aimylogic.

instagram 8


Создание канала

На странице бота перейдите на вкладку Каналы. В блоке каналов Мессенджеры, соцсети и API выберите канал Instagram.

Заполните поля:

  • Токен — укажите маркер доступа, который вы скопировали на предыдущем шаге.
  • Название канала — укажите название для канала или оставьте по умолчанию.

Нажмите Подключить.

instagram 10


Подключение вебхука

Под названием созданного канала нажмите Получить webhook. Адрес вебхука будет скопирован в буфер обмена.

instagram 11

Для подключения вебхука к приложению на Facebook перейдите обратно на страницу Настройки Instagram и выполните шаги:

  1. В секции Webhooks нажмите Добавить URL обратного вызова.

instagram 19

  1. В модальном окне в поле URL обратного вызова вставьте скопированный вебхук, а в поле Маркер подтверждения вставьте justai_verify_token. Нажмите Подтвердить и сохранить.

instagram 12

  1. В той же секции Webhooks нажмите Редактировать подписки. Активируйте поля messages и messaging_postbacks, а затем нажмите Сохранить.

instagram 13

  1. Обновите страницу. В меню слева перейдите на вкладку Webhooks и в выпадающем списке, где по умолчанию выбран Instagram, выберите Permissions.

instagram 14

  1. Нажмите Subscribe to this object и заполните поля как было описано в пунктах 1 и 2, после чего нажмите Подтвердить и сохранить.
  2. Найдите в списке разрешения instagram_basic, instagram_manage_messages и pages_manage_metadata. Нажмите Subscribe напротив каждого из этих параметров.

instagram 15

После выполнения всех указанных шагов интеграция готова к тестированию.


Тестирование бота

Для того чтобы протестировать бота, на странице приложения на Facebook необходимо добавить другой аккаунт в качестве тестировщика.

Для этого:

  1. Перейдите на страницу Роли из меню слева и в секции Тестировщики нажмите Добавить тестировщика.

instagram 20

  1. В модальном окне укажите идентификатор аккаунта тестировщика на Facebook или его имя и нажмите Отправить. Аккаунт будет добавлен в секцию с пометкой На рассмотрении.

instagram 16

  1. Авторизуйтесь на Facebook с аккаунта, который вы добавили в качестве тестировщика, и подтвердите запрос на добавление в список тестировщиков.

instagram 21

  1. Авторизуйтесь в Instagram через аккаунт, привязанный к аккаунту Facebook, который вы добавили в качестве тестировщика.
  2. Перейдите на страницу аккаунта, который вы добавили при настройке приложения, и отправьте сообщение в Direct данного аккаунта.

Если вы осуществили все настройки корректно, бот ответит вам согласно сценарию.


Проверка приложения на Facebook

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

Документация Facebook по проверке приложений

Прежде всего убедитесь, что ваше приложение не противоречит:

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

Если Facebook не сможет протестировать ваше приложение, оно не пройдет проверку.

Чтобы оставить заявку на проверку приложения:

  1. В меню на странице приложения перейдите на вкладку Проверка приложения > Запросы и нажмите кнопку Запросить разрешения или функции.

instagram 22

  1. Напротив каждого из параметров instagram_basic, instagram_manage_messages и Human Agent в столбце Действие нажмите Запросить расширенный доступ.

instagram 23

  1. Перейдите на вкладку Запросы и нажмите Редактировать напротив черновика запроса с данными параметрами.

instagram 24

  1. Заполните заявку в соответствии с требованиями. К заявке необходимо будет прикрепить видеоролики с записью экрана, которые будут подтверждать необходимость подключения каждого запрашиваемого разрешения, демонстрировать процесс настройки и использования приложения.
  2. После того как вы заполнили все поля, нажмите Отправить на проверку.

Дождитесь решения со стороны Facebook. Если ваша заявка будет одобрена, вы можете начинать использование интеграции.


Публикация приложения и Страницы

Если ваш бот прошел модерацию, перейдите к публикации вашей Страницы и приложения.

Для публикации Страницы откройте ее и перейдите на вкладку Настройки из меню Управление Страницей. В поле Статус Страницы установите Страница опубликована.

Для публикации приложения перейдите на его страницу и выберите Настройки > Основное. Укажите ссылку на вашу политику конфиденциальности и заполните необходимые поля. Загрузите здесь логотип вашего приложения и укажите его категорию.

instagram 25

Нажмите Сохранить изменения.

После публикации приложения вашему боту смогут писать все пользователи Facebook, которые заходят на вашу Страницу или находят вашего бота в приложении Messenger.