Instagram как входящий канал

Бота можно подключить к аккаунту в Instagram, чтобы он отвечал в автоматическом режиме на сообщения в Direct.

Для настройки интеграции вам потребуется бизнес-аккаунт в Instagram, подключенный к аккаунту Business Manager на Facebook.

Также у вас предварительно должна быть создана Страница группы на Facebook.

Для использования Instagram как входящего канала:

Создайте приложение на Facebook.
Добавьте аккаунты Facebook и Instagram в приложение.
Создайте канал Instagram в JAICP.
Подключите вебхук.
Протестируйте бота.
Проверка приложения на Facebook.

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

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

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

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

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

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

Перейдите на сайт Facebook for Developers.
Нажмите Войти и авторизуйтесь в аккаунте Facebook. Вы будете перенаправлены на главную страницу Facebook for Developers.
Нажмите Начать работу в шапке страницы.
Пройдите все шаги создания аккаунта Facebook for Developers.
После того как аккаунт будет создан, откройте страницу Мои приложения, нажмите Создать приложение и выберите тип приложения Компания.
Дайте название приложению и укажите Вы или принадлежащая вам компания в качестве назначения приложения. Выберите ваш аккаунт в Business Manager и сохраните настройки.

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

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

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

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

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

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

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

На странице проекта в панели управления выберите Каналы > Входящие > Создать канал. Выберите канал Instagram.

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

Название — укажите название для канала или оставьте по умолчанию.
Токен — укажите маркер доступа, который вы скопировали на предыдущем шаге.
Ветка — укажите ветку проекта, которую вы хотите развернуть в канал, по умолчанию master. Вы также можете выбрать Git-тег или ввести хеш конкретного коммита.
Оператор — выберите операторский канал или оставьте поле пустым.
Публикация — выберите, будет ли проект публиковаться в канал автоматически после каждого сохранения внесенных в проект изменений или вручную при помощи кнопки Опубликовать в строке с описанием канала.

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

Нажмите Создать. Дождитесь всплывающего окна с результатом деплоя.

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

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

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

В секции Webhooks нажмите Добавить URL обратного вызова. В модальном окне в поле URL обратного вызова вставьте скопированный вебхук.
В поле Маркер подтверждения вставьте justai_verify_token. Нажмите Подтвердить и сохранить.
В той же секции Webhooks нажмите Редактировать подписки. Активируйте поля messages и messaging_postbacks, а затем нажмите Сохранить.
Обновите страницу. В меню слева перейдите на вкладку Webhooks и в выпадающем списке, где по умолчанию выбран Instagram, выберите Permissions.
Нажмите Subscribe to this object и заполните поля как было описано в пунктах 1 и 2, после чего нажмите Подтвердить и сохранить.
Найдите в списке разрешения instagram_basic, instagram_manage_messages и pages_manage_metadata. Нажмите Subscribe напротив каждого из этих параметров.

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

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

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

Для этого:

Перейдите на страницу Роли из меню слева и в секции Тестировщики нажмите Добавить тестировщика.
В модальном окне укажите идентификатор аккаунта тестировщика на Facebook или его имя и нажмите Отправить. Аккаунт будет добавлен в секцию с пометкой На рассмотрении.
Авторизуйтесь на Facebook с аккаунта, который вы добавили в качестве тестировщика, и подтвердите запрос на добавление в список тестировщиков.
Авторизуйтесь в Instagram через аккаунт, привязанный к аккаунту Facebook, который вы добавили в качестве тестировщика.
Перейдите на страницу аккаунта, который вы добавили при настройке приложения, и отправьте сообщение в Direct данного аккаунта.

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

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

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

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

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

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

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

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

В меню на странице приложения перейдите на вкладку Проверка приложения > Запросы и нажмите кнопку Запросить разрешения или функции.
Напротив каждого из параметров instagram_basic, instagram_manage_messages и Human Agent в столбце Действие нажмите Запросить расширенный доступ.
Перейдите на вкладку Запросы и нажмите Редактировать напротив черновика запроса с данными параметрами.
Заполните заявку в соответствии с требованиями. К заявке необходимо будет прикрепить видеоролики с записью экрана, которые будут подтвеждать необходимость подключения каждого запрашиваемого разрешения, демонстрировать процесс настройки и использования приложения.
После того как вы заполнили все поля, нажмите Отправить на проверку.

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