Instagram*

• Как создать прямую ссылку на Директ

• Как подключить мессенджер (видеоинструкция)

• Как подготовить аккаунт

• Как подключить чат-бота

• Как работать с кнопками

• Как работать с вложениями

• Как создать карусель

• Как задать вводные фразы

• Как проверить подписку на аккаунт

• Как работать с комментариями в Instagram*

• Как использовать прямые ссылки на посты Инстаграм* в работе с комментариями

• Как использовать коллбэки в работе с комментариями

• Как настраивать ответы в Директ: Реакции в сторис

• Как настраивать ответы в Директ: Упоминание в сторис

• Как работать с упоминаниями аккаунта

• Как поставить лайк на последнее сообщение от пользователя

• Какие есть ограничения

• Как узнать больше про своих клиентов: верификация и количество подписчиков

Памятка по работе социальной сети

Ознакомиться с правилами работы в мессенджере можно в документации самого Instagram*.

Как правило, в мессенджере сообщения отправляются если:

- пользователи подписаны друг на друга;

- ранее был диалог с пользователем;

- работа с запросами включена в двух аккаунтах и в принимающем и в получающем сообщения;

- запрос на переписку принят, если он был направлен;

- в сообщениях нет ссылок, которые могут быть определены внутренними алгоритмами мессенджера, как вредоносный контент;

- существующие ссылки не ведут в другие мессенджеры;

- приложение на стороне пользователя имеет актуальную версию;

- интернет-соединение стабильно;

- акаунты, как принимающий, так и отправляющий сообщения, открыты.

- учитываются лимиты на отправку сообщений и новые переписки (информацию об актуальных лимитах можно получить в открытых источниках).

Как создать прямую ссылку на Директ

Ссылка записывается в формате https://ig.me/m/salebotpro , то есть для формирования ссылки после последнего слэша вставьте логин от вашего аккаунта Инстаграм*.

Как подготовить свой аккаунт Instagram*

Перейти в настройки в меню слева (если вы работаете с ПК) или в настройки в правом верхнем углу (если с телефона)

Перевести свой аккаунт в профессиональный статус

Выбрать нужную категорию и нажать “Готово”

Настройки Instagram* аккаунта завершены. Профиль готов к работе

Как подключить аккаунт к Salebot

Чтобы подключить аккаунт Instagram* к Salebot, вам необходимо сначала подготовить свой аккаунт, переключив его на профессиональный (как это сделать, рассказали выше).

Далее перейдите в раздел "Каналы" в Salebot:

После чего найдите плашку Instagram для подключения к Salebot:

Вам откроется модальное окно следующего вида:

Далее вам остается кликнуть по кнопке "Вход", чтобы перейти непосредственно на официальный сайт социальной сети и ввести свой логин и пароль:

Далее вам остается разрешение на подключение Аккаунта к Salebot:

При успешном подключении будет уведомление:

Если вы всё настроили по инструкции, но бот не работает, проверьте подключение в самом аккаунте Инстаграм*. Настройки - Конфиденциальность - Сообщения.

Там в самом низу нужно включить ползунок "Разрешить доступ к сообщениям".

Пошаговый разбор бота для Instagram* можно посмотреть в теме 2 проекта Репетитор. Перейти к описанию

Как работать с кнопками

Клавиатурные (reply)

В тексте (inline)

Кнопки могут вести на сторонние ресурсы. Визуально эти кнопки ничем не отличаются.

Как настраивать кнопки, смотрите в разделе Кнопки

Как работать с вложениями

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

Требования к вложениям:

Как создать карусель

Как сделать такую карусель в 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, '')

То есть сначала записываем массив с title, description, image, buttons в переменную p (вы можете назвать переменную иначе), а далее используем ее в методе send_carousel(p, '')

Вы можете воспользоваться табличкой и просто вставить нужные значения заголовков, ссылок и тд, а потом просто скопировать в ваш блок

В поле "Ответ" оставляет #{None}

Чтобы вставить ссылку в кнопку на карточке, запишите в массив:

p = [{"title":"заголовок", "description": "ОПИСАНИЕ КАРТОЧКИ 1", "image": "ССЫЛКА НА КАРТИНКУ 1", "buttons":[{"text":"ТЕКСТ КНОПКИ 1", "url":"ССЫЛКА ДЛЯ КНОПКИ" }]}]

Поскольку часто требуется размещение карточек карусели с одинаковым текстом кнопки, то был добавлен еще один параметр 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*, в разделе "Каналы"

При нажатии на этот бегунок появляется всплывающее окно, где можно задать нужные вводные фразы

После этого в вашей воронке настраиваете реакцию на фразы — нужные блоки переводите в состояние "Первостепенная проверка условия" и в условие записываете текст вводной фразы.

Настроить ответ по ключевым словам в Директ

Чтобы настроить автоответы по ключевым словам в Директ используйте блоки Первостепенная проверка условия (рекомендованный вариант). Также будут работать и другие блоки с условием. Выбор соответствия - По наличию ключевых слов или Полное совпадение (рекомендованные варианты).

В поле Условие укажите одно или несколько (через точку с запятой) условий для запуска бота. В поле "Текст сообщения" пропишите ответ бота, который получит пользователь. Можно добавлять вложения, кнопки и ссылки.

Как проверить подписку на аккаунт

Есть два варианта проверки подписки:

Проверка подписки через калькулятор

result = check_insta_subscription()

result - название переменной, в которую запишется результат проверки, вы можете задать другое имя данной переменной, если это необходимо. Получает значение: True если подписан, False если не подписан.

Проверку необходимо делать в поле "Переменная для сравнения". Как в стрелке, так и в блоке. result == True - выражение в поле "Переменная для сравнения" если клиент подписан на аккаунт. result == False - выражение, если клиент не подписан. Вы можете использовать и другие выражения сравнения, например, result != False (result не равен False, значит пользователь подписан на аккаунт)

Проверка через данные из карточки клиента

Когда пользователь взаимодействует с ботом, в карточке клиента (подраздел Переменные клиента) отображаются переменные follow, verified и followers.

Переменная follow — это и есть проверка подписки. Она принимает значение True, если клиент подписан на аккаунт, False — если не подписан и None, если аккаунт клиента закрыт.

verified обозначает есть ли у пользователя верификация (галочка у аккаунта).

Принимает значение True, если верификация есть, и False, если ее нет

followers обозначает количество подписчиков у клиента

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

Настройка в блоке:

В Условие прописываем любое слово, которое запустит вашу воронку.

1. В переменную для сравнения прописываем: follow (пробел) == (два равно) (пробел) True

ИЛИ

1. В переменную для сравнения прописываем: follow (пробел) ! (восклицательный знак) = (равно) (пробел) False

В первом случае будет проверка на факт подписки человека на ваш аккаунт, во втором случае на факт отсутствия подписки на ваш аккаунт.

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

Условие в стрелке:

В стрелке из блока в строке “Переменная для сравнения” прописываем условие

follow == True или follow != False

В случае соответствия условию мы переводим клиента дальше по воронке.

Если клиент не подписался, то он переходит в блок, где условия проверки не совпадают (follow == False или follow != True)

Если вы хотите, чтобы проверка осуществлялась динамично, то рекомендуем поставить кнопку. Например “Я подписался” и т д. Чтобы проверка была осуществлена и человек прошел далее.

Как работать с комментариями в Instagram* (client_wall_reply_new)

Для того, чтобы ваш бот реагировал на комментарии, нужно переключить бегунок в подключенном Instagram* в разделе “Каналы”

Если под вашим подключением Official Instagram* вы видите надпись "Переподключите Instagram* работы с комментариями", вам нужно переподключить Instagram*, чтобы обновить необходимые разрешения. Для этого нажимаете на значок корзины в нижнем правом углу (удалить бот)

И подключаете аккаунт Instagram* заново. Как подключить Instagram*смотрите здесь

✅ Настройка завершена

Пошаговый разбор бота для Instagram можно посмотреть в теме 2 проекта Репетитор. Перейти к описанию

Когда пользователь оставляет комментарий под постом, то в бот приходит 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 - если комментарии только под прямыми эфирами

Как настроить автоответ на комментарии в Direct

Копируем 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 * с ссылкой на публикацию.

Можно использовать переменную instagram_media_url *, чтобы настроить реакции на комментарии под определенными постами в Instagram*.

Рассмотрим пример.

Настройка разных ответов в зависимости от того, какую публикацию прокомментировали

Задача: В аккаунте несколько постов, три поста с товарами разными по стоимости. На эти три поста настроить реакцию с точной суммой, на остальные "По договоренности". Ответ присылать в Директ и в комментарий под постом.

Решение:

Реакцию настраиваем по ключевым словам в комментарии под постами. Т.е. реакция будет для всех постов, если в тексте комментария есть ключевое слово.

Мы будем присылать пользователю разную стоимость в комментарии и в директ одновременно. Для этого в поле Текст сообщения будет ответ и в Калькуляторе используем функцию insta_create_comment для отправки комментария под постом. Если комментарий с нужными ключевыми словами придет под другой пост, пользователю придет сообщение с текстом "по договоренности".

Шаг 1. В поле Условие стартового блока пишем client_wall_reply_new и перечисляем слова, на которые будем отвечать. Выбор соответствия - "По наличию ключевых слов"

Пример для копирования:

client_wall_reply_new_comment (цен|сколько|стоимость|узнать)

Шаг 2. В поле "Калькулятор" мы объявим переменную text. Значение переменной определим с помощью проверки условия IF, в зависимости от значения переменной instagram_media_url

Пример для копирования. Не забудьте заменить ссылки на ваши актуальные. Скопировать можно в переменной instagram_media_url в диалоге с клиентом (раздел Клиенты) после комментирования нужного поста :

text = if(instagram_media_url == "https://www.instagram.com/reel/Cagzkx", "1000 руб", if(instagram_media_url == "https://www.instagram.com/p/CqvCq4", "20000 руб", if(instagram_media_url == "https://www.instagram.com/p/CocLhN", "45000 руб", "По договоренности")))

Шаг 3. Затем используем метод insta_create_comment, чтобы отправить комментарий.

Пример для копирования:

insta_create_comment("#{text}")

где #{text} — наш текст, который мы присылаем пользователю.

Шаг 4. в поле Текст сообщения пишем переменную с текстом ответа в Директ.

В данном примере - переменная #{text}

Ответ приходит одинаковый в ответном комментарии и дублируется в Директ. Вы можете настроить разные ответы.

В видеоинструкции рассмотрели один из возможных вариантов как использовать значение переменной instagram_media_url *; как оставить комментарий под постом в ответ на комментарий; настройку случайного текста комментария и ответа в Директ в зависимости от поста, на который получен комментарий

Как написать комментарий в ответ на сообщение под постом или прямым эфиром

Шаг 1. В разделе Клиенты копируем коллбэк (уведомление) о том, что оставлен комментарий под постом и переходим в раздел Конструктор воронок.

Шаг 2. Создаём блок типа "Первостепенная проверка условия" или "Не состояние с условием" и вставляем скопированный коллбэк в поле Условие.

Существуют разные варианты настройки условия срабатывания бота. Они рассмотрены ниже в данной статье.

В примере бот отвечает на комментарии под всеми постами на сообщение "ответь в комментарии". Для этого в поле условие указываем основную часть колбэка и ключевую фразу:

client_wall_reply_new_comment ответь в комментариях

Важно! Выбор соответствия указываем "По наличию ключевых слов

Шаг 3. В поле для ответа оставляем #{none}.

Шаг 4. В поле "Калькулятор" пишем:

insta_create_comment("ваш текст комментария в ответ"),

где в скобках указывается текст вашего комментария.

Далее нажимаем "Готово".

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

Пример ответа бота на комментарий в комментариях:

Варианты настройки Условия реагирования на комментарий под постом:

Ответ бота на ЛЮБОЙ комментарий под КОНКРЕТНЫМ постом.

Чтобы бот отвечал на все комментарии под конкретной записью, в поле "Условие" вставляем коллбэк с номером публикации БЕЗ текста комментария:

Тогда конкретно под этой записью будет приходить автоматический ответ на любой комментарий:

Ответ бота на ЛЮБОЙ комментарий под ЛЮБЫМ постом.

Если в поле "Условие" оставите только общую часть колбэка client_wall_reply_new, то ваш комментарий будет приходить в ответ на комментарии под всеми записями (и не важно, какой текст пользователь написал)

Ответ бота на КОНКРЕТНУЮ ФРАЗУ под ЛЮБЫМ постом.

Если в поле "Условие" оставите client_wall_reply_new и ключевое слово, то ваш комментарий будет приходить в ответ на комментарии с ключевым словом под всеми записями.

Ответ бота на КОНКРЕТНУЮ ФРАЗУ под КОНКРЕТНЫМ постом.

Скопируйте полный колбэк из раздела клиенты и поставьте его в поле Условие блока:

Как сохранить текст комментария в переменную

Для того, чтобы сохранить текст комментария пользователя, воспользуемся методом comment_text()

В поле Условие вставим коллбек client_wall_reply_new, а в поле "Калькулятор" назначим переменную comm (вы можете взять любое другое название)

comm = comment_text()

Пример:

Как удалить комментарий

Функция insta_delete_comment(comment_id - необязательный)

Если comment_id не передан, функция использует переменную клиента instagram_last_comment_id.

При успешном выполнеини возвращает {"success":true} или {"An unexpected error has occurred. Please retry your request later."} — если передан несуществующий comment_id.

Как настраивать ответы в Директ: Реакции в сторис

Когда кто-то отправляет реакцию или комментарий в ответ на вашу сторис, в разделе Клиенты появляется сообщение вида

Сначала идет сообщение, которое прислали (или эмодзи), затем ссылка на сторис.

Если вы хотите настроить ответ на любую реакцию конкретно этой сторис, вам нужно скопировать часть ссылки до символа &

Далее переходите в раздел Воронки и создаете блок Первостепенная проверка условия или Не состояние с условием. В поле "Условие" вставляете скопированное, а в поле для ответа вставляете текст, который будет приходить в директ.

Если нужно настроить ответ на определенное слово, перед скопированной ссылкой указываете это слово. В поле для ответа пишете нужный текст.

Если нужно настроить одинаковые реакции для любых ваших сторис, то нужно скопировать вот эту часть ссылки:

и далее настраиваете блок так же, как описано выше

Какой колбек будет получен, если реакция выполнена с использованием аватара

Не так давно в 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_in_comment)

Когда кто-то из пользователей отметит ваш аккаунт в комментариях, в диалог придет коллбэк вида:

Также в карточке клиента появятся переменные:

mention_like_count — количество лайков

mention_media_id — id поста

Настроим реакцию для ответа на упоминание в комментарии.

Для этого создаете блок "Первостепенная проверка условия" или "Не состояние с условием". В поле "Условие" прописываете mention_in_comment и ставите тип соответствия "По наличию ключевых слов"

В поле "Калькулятор" прописываете следующий метод:

reply_to_mention(text)

где text - текст комментария, который появится в ответ на комментарий.. Вы можете задать переменную (вставлять в скобки без кавычек) или сразу текст (взять в кавычки).

Пример:

Результат:

Упоминание чужих профилей в комментариях под вашими постами

Если под вашим аккаунтом отмечают человека , в карточке клиента создается переменная mentioned_in_comment . в нее записывается логин того, кого отметили. если отмечено больше 2 человек, то логины записываются в массив:

Если вам нужно сегментировать тех, кто упомянул 2 и более друзей, вы можете присвоить переменную типа len = arr_len(mentioned_in_comment) и дальше сравнивать переменную с нужным значением. Подробнее о работе с массивами тут

Как поставить лайк на последнее сообщение от пользователя

Чтобы лайкнуть последнее сообщение пользователя, в поле "Калькулятор" впишите следующую функцию:

like_client_message()

Тогда при переходе в этот блок пользователь получит лайк на последнее отправленное им сообщение.

Какие есть ограничения

Если вы видите это сообщение, то клиент вам отправил чью-то запись из ленты или отправил чей-то сторис.

Окно 24 часа

Когда человек отправляет на вашу страницу сообщение, у вашего приложения есть до 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 обозначает количество подписчиков у клиента