Официальный Instagram
Создание чат-бота в Instagram. Вы можете автоматизировать общение в Direct при помощи Salebot
Максимальная длина текстового сообщения 900 символов
Чат-боты в официальном Инстаграм доступны всем бизнес-аккаунтам!!!
Ссылка записывается в формате https://ig.me/m/salebotpro , то есть для формирования ссылки после последнего слэша вставьте логин от вашего аккаунта Инстаграм.
Прямая ссылка работает ТОЛЬКО при открытии через приложение на мобильном устройстве. С браузера не работает!
Перейдите в свой аккаунт Facebook и создайте бизнес-страницу (или воспользуйтесь существующей, если она есть).
В меню слева выбираем раздел "Все"
В открывшемся меню нажимаем на раздел "Страницы"
Заполняете обязательные разделы "Название", "Категория" и нажимаете Создать страницу
После заполнения информации и создания страницы вас автоматически переключит на управление этой страницей
Перейти в настройки в меню слева (если вы работаете с ПК) или в настройки в правом верхнем углу (если с телефона)
Перевести свой аккаунт в профессиональный статус
Тип аккаунта нужно поменять на БИЗНЕС. Если у вас "Аккаунт автора", то интеграция работать НЕ будет. Нужен именно "Бизнес"
Выбрать нужную категорию и нажать “Готово”
Настройки Instagram аккаунта завершены. Профиль готов к работе
В меню слева перейти в раздел "Страницы"
Выбрать нужную страницу и перейти в настройки
В настройках выбрать раздел "Связанные аккаунты"
Далее выбираете подключение к Instagram
Нажимаем "Подключить" и подтверждаем разрешение на доступ к сообщениям
Далее открывается окно авторизации, вводите логин и пароль от Instagram аккаунта.
При успешном подключении будет так:
При привязке аккаунта Instagram к странице Facebook может появиться такие ошибки:
При повторном переподключении эта ситуация не решается. Для того, чтобы решить эту проблему нужно перейти в раздел "Качество аккаунта" и проверить аккаунт на ограничения
Единственное что вы можете сделать, это отправить фото своих документов, для этого нужно нажать на кнопку “Запросить проверку” и ждать проверки
Это стандартная процедура и проходит без проблем, но если ваши документы отклонят, то вы больше ничего сможете сделать.
Если проверка ваших документов или рассмотрение апелляции после бана длится больше суток, то не стоит переживать, ведь это означает только лишь одно, ваш запрос пошел человеку, а не боту и это увеличивает ваши шансы на положительный ответ;
Рекомендация!
Если у вас запросили документы, то очень важно сделать селфи на свой телефон, потом его подключить к компьютеру и при выборе файла выбрать фото со своего телефона т.е. оригинальный файл, который не копировался и не изменялся, это кратно увеличит ваши шансы пройти проверку и это самая частая ошибка, когда у людей не получается отправить свои документы или приходит отрицательный ответ.
При подключении выдает такое уведомление "Сбой подключения. Во время обработки запроса возникла ошибка. Пожалуйста, попробуйте еще раз позже."
Решение:
- 1.Проверить обновления Приложения Instargam
- 2.Перейти в аккаунт Instagram и переключиться на "Личный аккаунт"
- 3.Вернуть обратно "Профессиональный статус"
- 4.Перейти в Facebook и повторно попробовать привязать страницу
Данным способом нельзя злоупотреблять (делать более 2-х раз), так как страница Facebook может попасть в бан
Чтобы подключить чат-бота в Instagram, Вы должны авторизоваться в Salebot через Facebook и дать соответствующие разрешения.
Для этого переходим в раздел “Каналы” и выбираем “Official Instagram”
Идет переадресация на авторизацию в Facebook
Обязательно выбирать “Изменить настройки”, иначе вам просто не будет предоставлен список нужных страниц
Выбираем нужный аккаунт и нажимаем “Далее”
Выбираем нужную Бизнес страницу и нажимаем “Далее”
Следующие настройки оставляем без и зменений и нажимаем “Готово”
После привязки идет возврат обратно в раздел "Каналы". Нужно выбрать подключенный бот и нажать "Готово"
При успешном подключении будет уведомление:
У API нет доступа к аккаунтам Instagram, не являющимся бизнес-аккаунтами.
Перед тем, как подключить чат-бота к Instagram, вы должны перевести аккаунт в тип бизнес и привязать к бизнес странице facebook.
Аккаунт должен быть именно бизнес аккаунтом, а не аккаунтом автора!
Если вы всё настроили по инструкции, но бот не работает, проверьте подключение в самом аккаунте Инстаграм. Настройки - Конфиденциальность - Сообщения.
Там в самом низу нужно включить ползунок "Разрешить доступ к сообщениям".
Instagram не поддерживает одновременную отправку inline и reply кнопок
Instagram поддерживает до 11 кнопок reply
Кнопки могут располагаться только в линию
Instagram поддерживает не более 3 кнопок inline
Кнопки могут вести на сторонние ресурсы. Визуально эти кнопки ничем не отличаются.
В сообщении можно отправлять вложения. Подробно о том, какие вложения и как доб авлять описано в разделе документации Отправка вложений. Отслеживание перехода по ссылкам
В блок можно загружать вложения файлом или используя ссылку на файл.
Загружаемый видео файл должен быть не больше 20 MB, аудио и изображение до 5 МВ.
Требования к вложениям со стороны Instagram:
Требования со стороны Instagram к вложениям
Для аудио вложений НЕ рекомендуется использовать формат mp4, а в формате mp3 аудио не будет отправлено вообще.
Как сделать такую карусель в Direct:
Рассмотрим на примере карусели из 3 карточек. Для создания карточек вам нужно в поле "Калькулятор" написать следующее:
p = [{"title":"ЗАГОЛОВОК", "description": "ОПИСАНИЕ КАРТОЧКИ 1", "image": "ССЫЛКА НА КАРТИНКУ 1", "buttons":[{"text":"ТЕКСТ КНОПКИ 1"}]},{"title":"ЗАГОЛОВОК", "description": "ОПИСАНИЕ КАРТОЧКИ 2", "image": "ССЫЛКА НА КАРТИНКУ 2", "buttons":[{"text":"ТЕКСТ КНОПКИ 2"}]}, {"title":"ЗАГОЛОВОК", "description": "ОПИСАНИЕ КАРТОЧКИ 3", "image": "ССЫЛКА НА КАРТИНКУ 3", "buttons":[{"text":"ТЕКСТ КНОПКИ 3"}]}]
r = send_carousel(p, '')
Обратите внимание: выражение r = send_carousel(p, '') - должно быть с новой строки в калькуляторе
То есть сначала записываем массив с title, description, image, buttons в переменную p (вы можете назвать переменную иначе), а далее используем ее в методе send_carousel(p, '')
Вы можете воспользоваться табличкой и просто вставить нужные значения заголовков, ссылок и тд, а потом просто скопировать в ваш блок
В поле "Ответ" оставляет #{None}
В кнопки карточек карусели вы можете вставлять ссылки, тогда при нажатии на кнопку пользователь перейдет по ссылке
Чтобы вставить ссылку в кнопку на карточке, запишите в массив:
p = [{"title":"заголовок", "description": "ОПИСАНИЕ КАРТОЧКИ 1", "image": "ССЫЛКА НА КАРТИНКУ 1", "buttons":[{"text":"ТЕКСТ КНОПКИ 1", "url":"ССЫЛКА ДЛЯ КНОПКИ" }]}]
В кнопки карточек карусели добавлен еще один необязательный параметр payload, который не будет отображаться клиенту, но позволит проанализировать сделанный клиентом выбор
Поскольку часто требуется размещение карточек карусели с одинаковым текстом кнопки, то был добавлен еще один параметр payload, который не будет отображаться клиенту, но позволит проанализировать сделанный им выбор:
Обратите внимание на правильность его применения:
p = [{"title":"заголовок", "description": "ОПИСАНИЕ КАРТОЧКИ 1", "image": "ССЫЛКА НА КАРТИНКУ 1", "buttons":[{"text":"ТЕКСТ КНОПКИ 1","payload":"1"}]},{"title":"заголовок", "description": "ОПИСАНИЕ КАРТОЧКИ 2", "image": "ССЫЛКА НА КАРТИНКУ 2", "buttons":[{"text":"ТЕКСТ КНОПКИ 1","payload":"2"}]}, {"title":"заголовок", "description": "ОПИСАНИЕ КАРТОЧКИ 3", "image": "ССЫЛКА НА КАРТИНКУ 3", "buttons":[{"text":"ТЕКСТ КНОПКИ 1"}]}]
Параметр payload - может быть опущен, как показано на рисунке в кнопке 3
Вводные фразы позволяют человеку начать беседу с компанией, используя список часто задаваемых запросов. Можно задать до четырех запросов.
Для настройки вводных фраз необходимо поставить бегунок в подключенном аккаунте Instagram, в разделе "Каналы"
При нажатии на этот бегунок появляется всплывающее окно, где можно задать нужные вводные фразы
После этого в вашей воронке настраиваете реакцию на фразы — нужные блоки переводите в состояние "Первостепенная проверка условия" и в условие записываете текст вводной фразы.
Внимание! Вводные фразы появляются у пользователей, которые ранее не контактировали с вашим аккаунтом Instagram (или в случае полного удаления предыдущего диалога)
Работает только на тарифе Премиум
Есть два варианта проверки подписки:
result = check_insta_subscription()
result - название переменной, в которую запишется результат проверки. Переменную можно назвать как угодно. Получает значение: True если подписан, False если не подписан.
Проверку необходимо делать в поле "Переменная для сравнения". Как в стрелке, так и в блоке
result == True ( или result != False)
Когда пользователь взаимодействует с ботом, в карточке клиента (подраздел Переменные клиента) отображаются переменные follow, verified и followers.
Переменная follow — это и есть проверка подписки. Она принимает значение True, если клиент подписан на аккаунт, False — если не подписан и None, если аккаунт клиента закрыт.
verified обозначает есть ли у пользователя верификация (галочка у аккаунта).
Принимает значение True, если верификация есть, и False, если ее нет
followers обозначает количество подписчиков у клиента
Для проверки подписки или ограничения прохождения по воронке можно использовать переменную follow в блоках с условиями или в стрелках, в поле "Переменная для сравнения".
Настройка в блоке:
В Условие прописываем любое слово, которое запустит вашу воронку.
- 1.В переменную для сравнения прописываем: follow (пробел) == (два равно) (пробел) True
ИЛИ
- 2.В переменную для сравнения прописываем: follow (пробел) ! (восклицательный знак) = (равно) (пробел) False
В первом случае будет проверка на факт подписки человека на ваш аккаунт, во втором случае на факт отсутствия подписки на ваш аккаунт.
Обратите внимание, что статусы True и False обязательно были написаны с большой буквы. В противном случае проверка не сработает корректно.
Для выдачи разных сообщений при подписке и ее отсутствии нужно будет создавать 2 блока с противоположными решениями. Если вы не любите громоздкие решения, то рекомендуем прописывать условия в стрелке.
Условие в стрелке:
В стрелке из блока в строке “Переменная для сравнения” прописываем условие
follow == True или follow != False
В случае соответствия условию мы переводим клиента дальше по воронке.
Если клиент не подписался, то он переходит в блок, где условия проверки не совпадают (follow == False или follow != True)
Если вы хотите, чтобы проверка осуществлялась динамично, то рекомендуем поставить кнопку. Например “Я подписался” и т д. Чтобы проверка была осуществлена и человек прошел далее.
В замкнутой стрелке НЕ рекомендуем ставить таймер без кнопки, так как человеку будут постоянно приходить сообщения и ваш лимит на сообщения быстро исчерпается.
Два способа проверки подписки на аккаунт Instagram
Работает только на тарифе Премиум и подключении Official Instagram
Для того, чтобы ваш бот реагировал на комментарии, нужно переключить бегунок в подключенном Instagram в разделе “Каналы”
Если под вашим подключением Official Instagram вы видите надпись "Переподключите Instagram для работы с комментариями", вам нужно переподключить Инстаграм, чтобы обновить необходимые разрешения. Для этого нажимаете на значок корзины в н ижнем правом углу (удалить бот)
Настройка завершена.
C комментариями под Reels работает также как и под постами
Когда пользователь оставляет комментарий под постом, то в бот приходит callback (смотреть нужно в разделе “Клиенты” в диалоге с пользователем)
Callback имеет вид:
client_wall_reply_new link id: text
где link - ссылка на пост, id — id записи, text — текст комментария
С комментариями мы можем работать в двух вариантах: отвечать своим комментарием или написать одно сообщение в Direct.
client_wall_reply_new - это общая часть колбека. Если нас интересуют комментарии только под постами, пишем client_wall_reply_new_comment, а если комментарии только под прямыми эфирами, пишем client_wall_reply_new_live
Автоматический ответ на комментарий НЕ открывает 24-часовое окно
Копируем callback и переходим в раздел Конструктор воронок. Создаём блок типа "Первостепенная проверка условия" или "Не состояние с условием" и вставляем скопированный callback в условие. Выставляем проверку "По наличию ключевых слов"
Если вы хотите настроить реакцию на комментарии под любым постом на любой комментарий, то в условиях вы указываете только client_wall_reply_new_comment, в выборе соответствия устанавливает “По наличию ключевых слов”
Если планируете настроить реакцию на конкретный пост, то в условиях прописываете client_wall_reply_new_comment + ID поста.
Если планируется настройка реакции так, чтобы бот реагировал на определенное слово под конкретным постом, то в условиях надо прописать client_wall_reply_new_comment+ID поста+нужный текст.
В поле для ответа пишете текст, который хотите рассылать в ответ на этот комментарий.
Над сообщением указывается, что оно пришло в ответ на комментарий. Если нажмете на "Посмотреть публикацию", то вас перекинет под ту запись, которую комментировали.
Если пользователь оставил ком ментарий, на который у вас не настроена реакция (или вы их вообще не настраивали), вы можете ему ответить одним сообщением в Direct через раздел "Клиенты"
При этом если мы повторно напишем пользователю в Direct, второе сообщение не отправится, т.к при реакции на комментарии не открывают 24-часовое окно
Ошибка, есл и в ответ на комментарий отправить больше одного сообщения
Чтобы настроить реакции на определенные посты в Инстаграм, вы можете использовать сравнение с переменной instagram_media_url
Например, настроим реакцию на три поста: в зависимости от того, какой пост комментируют, мы будем присылать пользователю разную стоимость в комментарии и в директ одновременно. Если комментарий с нужными ключевыми словами придет под другой пост, пользователю придет сообщение с текстом "по договоренности".
В условии мы пишем client_wall_reply_new и перечисляем слова, на которые будем отвечать. Выставляем проверку "по наличию ключевых слов"
Если нас интересуют комментарии только под постами, пишем client_wall_reply_new_comment, а если комментарии только под прямыми эфирами, пишем client_wall_reply_new_live
С комментариями под Reels работает также, как и под простыми постами
В поле "Калькулятор" мы выставляем условие для переменной text, используя IF.
И затем используем метод insta_create_comment, чтобы отправить комментарий.
insta_create_comment("#{text}")
где #{text} — наш текст, который мы присылаем пользователю.
На примере этот текст приходит в ответном комментарии и дублируется в Директ. Вы можете настроить разные ответы.
client_wall_reply_new - это общая часть колбека. Если нас интересуют комментарии только под постами, пишем client_wall_reply_new_comment, а если комментарии только под прямыми эфирами, пишем client_wall_reply_new_live
Пример работы с прямыми ссылками на посты в ответ на комментарии
В видеоинструкции рассмотрели один из возможных вариантов как использовать значение переменной instagram_media_url; как оставить комментарий под постом в ответ на комментарий; настройку случайного текста комментария и ответа в Директ в зависимости от поста, на который получен комментарий
Копируем коллбэк и переходим в раздел Воронки. Создаём блок типа "Первостепенная проверка условия" или "Не состояние с условием" и вставляем скопированный коллбэк в условие. Выставляем проверку "По наличию ключевых слов
client_wall_reply_new - это общая часть колбека, которая реагирует и на посты и на прямые эфиры.
Если нас интересуют комментарии только под постами, пишем client_wall_reply_new_comment, а если комментарии только под прямыми эфирами, пишем client_wall_reply_new_live
Для прямого эфира (client_wall_reply_new_live) есть одна особенность: бот отреагирует только во время эфира. Если эфир закончился, то комментарии под этим эфиром бот не увидит и ответить не сможет.
В поле для ответа оставляем #{none}. В поле "Калькулятор" пишем:
insta_create_comment('Не продаю. Но могу угостить!')
где в скобках указывается текст вашего комментария. Далее нажимаем "Готово".
При такой настройке ваш комментарий будет приходить в ответ на комментарий под конкретной записью и ключевыми словами "куплю одну".
Чтобы бот отвечал на все комментарии под конкретной записью, в поле "Условие" вставляем коллбэк без текста комментария:
Тогда конкретно под этой записью будет приходить автоматический ответ на любой комментарий.
Если вы в поле "Условие" оставите только , то ваш комментарий будет приходить в ответ на комментарии под всеми записями (и не важно, какой текст пользователь написал)
Если вы в поле "Условие" оставите client_wall_reply_new и ключевое слово, то ваш комментарий будет приходить в ответ на комментарии с ключевым словом под всеми записями.
Точно таким же способом вы можете реагировать на комментарии, которые оставляют пользователи во время прямого эфира (для него есть отдельный ключ client_wall_reply_new_live).
Для прямого эфира есть одна особенность: бот отреагирует только во время эфира. Если эфир закончил ся, то комментарии под этим эфиром бот не увидит и ответить не сможет.
Для того, чтобы сохранить текст комментария пользователя, воспользуемся методом comment_text()
В поле Условие вставим коллбек client_wall_reply_new, а в поле "Калькулятор" назначим переменную comm (вы можете взять любое другое название)
comm = comment_text()Пример:
Когда кто-то отправляет реакцию или комментарий в ответ на вашу сторис, в разделе Клиенты появляется сообщение вида
Сначала идет сообщение, которое прислали (или эмодзи), затем ссылка на сторис.
Если вы хотите настроить ответ на любую реакцию конкретно этой сторис, вам нужно скопировать часть ссылки до символа &
Далее переходите в раздел Воронки и создаете блок Первостепенная проверка условия или Не состояние с условием. В поле "Условие" вставляете скопированное, а в поле для ответа вставляете текст, который будет приходить в директ.
Если нужно настроить ответ на определенное слово, перед скопированной ссылкой указываете это слово. В поле для ответа пишете нужный текст.
Если нужно настроить одинаковые реакции для любых ваших сторис, то нужно скопировать вот эту часть ссылки:
и далее настраиваете блок так же, как описано выше
Не так давно в Instagram появилась возможность в качестве реакции на сторис ставить не только смайлы, но и аватар:
Аватар в реакции сторис
В этом случае будет получен колбек instagram_reaction_to_story
Если в каналах для Вашего бота Instagram была подключена возможность получения ссылок для ответов на сторис и комментарии:
Подключение возможности получения ссылок при ответе на сторис или комментарий
То колбек будет содержать ссылку:
Колбек на реакцию на сторис при помощи аватара
Когда вас упоминают в сторис, приходит коллбэк вида
где ссылка - это ссылка на историю, где вас упомянули.
Чтобы настроить ответы на упоминание в сторис, переходите в раздел Воронки и создаете блок Первостепенная проверка условия или Не состояние с условием. В поле "Условие" прописываете "Упоминание в истории", а в поле для ответа пишете текст, который будет приходить в директ.
Также вы можете присылать картинки или ссылки вместе с текстом (например, чтобы выдать бонус за упоминание вашего аккаунта)
И тогда при упоминании в сторис пользовател ь получит сообщение:
Когда пользователь отметит ваш профиль в своем посте, в вашего бота придет коллбэк:
И появляются переменные:
mention_caption — текст поста
post_url — ссылка на пост
mention_comments_count — количество комментариев
mention_like_count — количество лайков
mention_media_id — id поста
Настроим реакцию для ответа на упоминание.
Для этого создаем блок "Первостепенная проверка условия" или "Не состояние с условием". В поле "Условие" прописываете mention_in_media и ставите тип соответствия "По наличию ключевых слов"
В поле "Калькулятор" прописываете следующий метод:
reply_to_mention(text)
где text - текст комментария, который появится под данным постом. Вы можете задать переменную (вставлять в скобки без кавычек) или сразу текст (взять в кавычки).
Пример:
Результат
Когда кто-то из пользователей отметит ваш аккаунт в комментариях, в диалог придет коллбэк вида:
Если ваш аккаунт отметят в закрытом профиле, коллбэк не придет.
Также в карточке клиента появятся переменные:
mention_like_count — количество лайков
mention_media_id — id поста
Настроим реакцию для ответа на упоминание в комментарии.
Для этого создаете блок "Первостепенная проверка условия" или "Не состояние с условием". В поле "Условие" прописываете mention_in_comment и ставите тип соответствия "По наличию ключевых слов"
В поле "Калькулятор" прописываете следующий метод:
reply_to_mention(text)
где text - текст комментария, который появится в ответ на комментарий.. Вы можете задать переменную (вставлять в скобки без кавычек) или сразу текст (взять в кавычки).
Пример:
Результат:
Если в диалоге с пользователем не открыто 24 часовое окно, то написать в директ в ответ на упоминание ничего нельзя! Только ответным комментарием
Если окно 24 часа открыто, то в поле Ответ вы можете написать текст, который пользователи получит в директ после отметки вашего аккаунта.
Если под вашим аккаунтом отмечают человека , в карточке клиента создается переменная mentioned_in_comment . в нее записывается логин того, кого отметили. если отмечено больше 2 человек, то логины записываются в массив:
Если вам нужно сегментировать тех, кто упомянул 2 и более друзей, вы можете присвоить переменную типа len = arr_len(mentioned_in_comment) и дальше сравнивать переменную с нужным значением. Подробнее о работе с массивами тут
Если в диалоге с пользователем не открыто 24 часовое окно, то написать в директ в ответ на упоминание ничего нельзя! Только ответным комментарием
Чтобы лайкнуть последнее сообщение пользователя, в поле "Калькулятор" впишите следующую функцию:
like_client_message()
Тогда при переходе в этот блок пользователь получит лайк на последнее отправленное им сообщение.
Настройка автолайка
Если пользователь удалит сообщение, то оно пропадет и из интерфейса Salebot
Групповая переписка (беседы с более чем двумя участниками) не поддерживается.
Если вы видите это сообщение, то клиент вам отправил чью-то запись из ленты или отправил чей-то сторис.
Когда человек отправляет на вашу страницу сообщение, у вашего приложения есть до 24 часов для ответа.
Компаниям дается 24 часа, чтобы ответить на сообщение пользователя. Сообщения, отправленные в пределах 24-часового окна, могут содержать рекламу. Пользователи в любое время могут заблокировать чат или переключить его в немой режим.
Как узнать, прошло ли 24 часа с момента последнего сообщения?
Воспользуйтесь функцией
"days_from_last_message": функция возвращает количество дней с момента последней реплики клиента. Создана для проверки попадания в 24часовое окно.
d = days_from_last_message()Вы можете общаться с клиентом в течение недели после его последнего сообщения.
За пределами 24 сообщения отправляются без кнопок.
Для этого мы помечаем все сообщения, отправленные после окна в 24 часа тегом HUMAN_AGENT. Тег предоставляет операторам возможность отвечать на запросы пользователей. Сообщения можно отправить в течение семи дней после сообщения пользователя.
После 7 дней сообщения не будут доходить до адресата по причине следующей ошибки:
- Операторская поддержка по вопросам, которые невозможно решить в рамках стандартного окна переписки (например, если компания закрыта на выходные или для решения вопроса требуется более 24 часов)
- Автоматические сообщения.
- Контент, не связанный с запросом пользователя.
Когда пользователь пишет в бота, в карточке клиента отображаются переменные follow, verified и followers.
Переменная follow — это и есть проверка подписки. Она принимает значение True, если клиент подписан на аккаунт, False — если не подписан и None, если аккаунт клиента закрыт.
verified обозначает, есть ли у пользователя верификация (галочка у аккаунта). Принимает значение True, если верификация есть, и False, если ее нет
followers обозначает количество подписчиков у клиента
Last modified 1mo ago