Instagram — одна из важных площадок ведения бизнеса: для многих небольших компаний это единственное место, где они предлагают свои услуги. Многие пользователи узнают о новинках именно из ленты Instagram.
Бота можно подключить к Instagram, чтобы он отвечал в автоматическом режиме:
- на сообщения в Direct;
- на комментарии к постам.
Подключить бота к обработке сообщений в Direct можно следующими способами: подключив Instagram напрямую к Aimylogic, через сервис Wazzup или через Jivo.
При подключении Instagram через Jivo бот также сможет обрабатывать ответы и упоминания в Instagram Stories.
Подключение бота к комментариям осуществляется через Открытые линии Битрикс24.
В данной статье описана интеграция Aimylogic с Instagram Direct напрямую.
Возможности интеграции
Канал поддерживает следующие функции:
- отправку изображений;
- отправку аудио- и видеофайлов;
- перевод диалога на оператора;
- интеграцию с CRM-системами;
- отправку email и SMS.
Подключение бота к Direct
Для использования интеграции с Instagram Direct:
- Создайте и настройте Страницу на Facebook.
- Создайте приложение на Facebook.
- Добавьте аккаунты Facebook и Instagram в приложение.
- Создайте канал Instagram в Aimylogic.
- Подключите вебхук.
- Протестируйте бота.
- Пройдите проверку приложения на Facebook.
- Опубликуйте приложение и Страницу.
Создание и настр ойка Страницы на Facebook
Создание Страницы
На Facebook общение происходит через страницы пользователей или групп. Поэтому в первую очередь необходимо создать Страницу, к которой будет привязан бот. Если у вас уже создана и настроена Страница, перейдите к следующему шагу.
- Авторизуйтесь в аккаунте Facebook и на главной странице в меню слева выберите раздел Страницы.
- На открывшейся странице в меню слева нажмите + Создать новую Страницу.
- Заполните информацию о Странице: обязательно укажите название страницы и ее категорию. После этого нажмите Создать Страницу.
- После создания Страницы вы можете установить фото профиля и обложки, а также заполнить опциональные поля.
Настройка Страницы
Сделайте Страницу неопубликованной:
- В меню Управление Страницей нажмите Настройки.
- В поле Статус Страницы установите Страница снята с публикации. В качестве причины укажите Страница еще не закончена → Снять с публикации. Теперь вашу страницу могут видеть только администраторы страницы.
Далее предоставим права администратора всем пользователям, которым нужно просматривать диалоги с ботом.
- В меню Настройки Страницы перейдите на вкладку Роли на Странице.
- Перейдите в раздел Назначить новую роль на Странице.
- Выберите пользователя и роль Администратор → Добавить.
Подключение Страницы к бизнес-аккаунту Instagram
Созданную Страницу необходимо привязать к бизнес-аккаунту Instagram, на котором будет общаться бот.
- На главной странице Facebook в меню слева выберите Страницы → (Имя вашей страницы) → Настройки → Instagram.
- Нажмите кнопку Подключить аккаунт.
- В модальном окне разрешите доступ к сообщениям из Instagram в разделе Входящие и нажмите Продолжить.
- В новом окне авторизуйтесь в аккаунте Instagram и выберите Страницу, которую хотите привязать.
Настройка приложения на Facebook
Создание нового приложения
- Перейдите на сайт Facebook for Developers.
- Нажмите Войти и авторизуйтесь в аккаунте Facebook. Вы будете перенаправлены на главную страницу Facebook for Developers.
- Нажмите Начать работу в шапке страницы.
- Пройдите все шаги создания аккаунта Facebook for Developers.
- После того как аккаунт будет создан, откройте страницу Мои приложения, нажмите Создать приложение, выберите тип приложения Компания и нажмите Продолжить.
- Дайте название приложению и укажите Вы или принадлежащая вам компания в качестве назначения приложения. Выберите ваш аккаунт в Business Manager и сохраните настройки.
После создания приложения вы будете перенаправлены на его страницу.
Добавление аккаунтов Facebook и Instagram
На странице приложения из меню слева перейдите на вкладку Панель. Найдите секцию Добавление продуктов в приложение и выберите Messenger, а затем перейдите на вкладку Настройки Instagram.
Чтобы добавить аккаунты, выполните следующие шаги:
- В секции Маркеры доступа нажмите кнопку Добавить или удалить Страницы.
- В открывшемся окне для авторизации через Facebook нажмите Продолжить как (имя вашего аккаунта).
- Выберите бизнес-аккаунт Instagram, который вы собираетесь использовать в интеграции, и нажмите Далее.
- Выберите Страницу на Facebook, связанную с выбранным бизнес-аккаунтом Instagram.
- Задайте разрешения создаваемому приложению. Для корректной работы интеграции все разрешения должны быть активны. Нажмите Готово, и приложение будет связано с Facebook, а Страница появится в секции Маркеры доступа на странице приложения.
Далее вам необходимо получить маркер доступа. Для этого нажмите Сгенерировать маркер напротив только что добавленной вами Страницы. В модальном окне активируйте опцию Я понимаю и скопируйте маркер. Он понадобится вам при настройке канала на стороне Aimylogic.
Создание канала
На странице бота перейдите на вкладку Каналы. В блоке каналов Мессенджеры, соцсети и API выберите канал Instagram.
Заполните поля:
- Токен — укажите маркер доступа, который вы скопировали на пре дыдущем шаге.
- Название канала — укажите название для канала или оставьте по умолчанию.
Нажмите Подключить.
Подключение вебхука
Под названием созданного канала нажмите Получить 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
Для того чтобы бот мог отвечать на сообщения, отправленные с любого аккаунта, а не только с аккаунтов тестировщиков, необходимо пройти процедуру проверки вашего приложения.
Прежде всего убедитесь, что ваше приложение не противоречит:
- Политике платформы Messenger;
- Условиям использования платформы Facebook;
- Правилам для разработчиков;
- Нормам сообщества Facebook.
Перед составлением и отправкой заявки на проверку приложения убедитесь, что приложение полностью настроено и работает корректно.
Чтобы оставить заявку на проверку приложения:
- В меню на странице приложения перейдите на вкладку Проверка приложения → Запросы и нажмите кнопку Запросить разрешения или функции.
- Напротив каждого из параметров instagram_basic, instagram_manage_messages и Human Agent в столбце Действие нажмите Запросить расширенный доступ.
- Перейдите на вкладку Запросы и нажмите Редактировать напротив черновика запроса с данными параметрами.
- Заполните заявку в соответствии с требованиями. К заявке необходимо будет прикрепить видеоролики с записью экрана, которые будут подтверждать необходимость подключения каждого запрашиваемого разрешения, демонстрировать процесс настройки и использования приложения.
- После того как вы заполнили все поля, нажмите Отправить на проверку.
Дождитесь решения со стороны Facebook. Если ваша заявка будет одобрена, вы можете начинать использование интеграции.
Публик ация приложения и Страницы
Если ваш бот прошел модерацию, перейдите к публикации вашей Страницы и приложения.
Для публикации Страницы откройте ее и перейдите на вкладку Настройки из меню Управление Страницей. В поле Статус Страницы установите Страница опубликована.
Для публикации приложения перейдите на его страницу и выберите Настройки → Основное. Укажите ссылку на вашу политику конфиденциальности и заполните необходимые поля. Загрузите здесь логотип вашего приложения и укажите его категорию.
Нажмите Сохранить изменения.
После публикации приложения вашему боту смогут писать все пользователи Facebook, которые заходят на вашу Страницу или находят вашего бота в приложении Messenger.