Працює, коли Instagram увімкнено

Налаштування відповіді на зворотний виклик Instagram

Вам потрібно увімкнути перемикач у підключеному обліковому записі Instagram у розділі Messengers, щоб ваш бот міг відповідати на коментарі.

Якщо Instagram показує "Reconnect to work with comments" під вашим офіційним підключенням Instagram, вам потрібно перепідключити Instagram, щоб оновити необхідні дозволи. Для цього натисніть значок сміттєвого бака в нижньому правому куті (видалити бота).

Підключіть обліковий запис Instagram знову. Як підключити Instagram, дивіться тут.

Під час публікації дописів як співавтор, усі сповіщення про коментарі надсилатимуться до облікового запису, з якого ви створюєте допис.

Працює з коментарями під Reels, а також під дописами.

Коли користувач коментує допис, боту надсилається зворотний виклик (ви можете переглянути його в розділі "Клієнти" у діалозі користувача).

Формат зворотного виклику: client_wall_reply_new link id: text

де:

  • link — посилання на допис
  • id — ідентифікатор запису
  • text — текст коментаря

Ми можемо працювати з коментарями двома способами: відповісти своїм коментарем або написати одне повідомлення в Direct.

client_wall_reply_new — це загальна частина зворотного виклику.

client_wall_reply_new_comment — якщо нас цікавлять коментарі лише під дописом

client_wall_reply_new_live — якщо коментарі лише під час прямого ефіру

Як налаштувати автоматичну відповідь на коментарі в Direct

Автоматична відповідь на коментар НЕ відкриває 24-годинне вікно.

Скопіюйте зворотний виклик і перейдіть до розділу Конструктор воронок. Створіть блок типу "Перевірка основної умови" або "Нестандартна умова" та вставте скопійований зворотний виклик в умову. Ми налаштовуємо перевірку "На наявність ключових слів"

УВАГА! Не рекомендується використовувати цифри як тригер для запуску бота.

Ідентифікатор допису може містити ці цифри. Бот може відповісти на будь-який зворотний виклик, що містить ці цифри, якщо він вибере збіг на основі наявності ключових слів.

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

Під час вибору збігу встановлюється "Keyword match".

Важлива примітка:

Ми рекомендуємо використовувати тип пошуку "Keyword match" під час налаштування відповіді на зворотний виклик.

Пам'ятайте, що логіку збігу для умови блоку слід вибирати відповідно до налаштувань і вимог вашого проекту. Тому обов'язково ретельно протестуйте потік вашого чат-бота!

Про вибір збігу в умові блоку читайте в статті "Тригер і тип збігу".

Якщо ви плануєте налаштувати реакцію на конкретний допис, включіть client_wall_reply_new_comment разом з ідентифікатором допису в поле тригера.

УВАГА!

Не рекомендується використовувати цифри як тригери для запуску вашого бота.

Ідентифікатор допису часто складається з цифр. Якщо ваш бот використовує зіставлення на основі ключових слів, він може неправильно відповісти на будь-який зворотний виклик, що містить ці цифри.

Якщо ви плануєте налаштувати реакцію на конкретний допис, включіть client_wall_reply_new_comment разом з ідентифікатором допису в поле тригера.

УВАГА!

Не рекомендується використовувати цифри як тригери для запуску вашого бота.

Ідентифікатор допису часто складається з цифр. Якщо ваш бот використовує зіставлення на основі ключових слів, він може неправильно відповісти на будь-який зворотний виклик, що містить ці цифри.

У полі відповіді введіть текст, який ви хочете надіслати як відповідь на цей коментар.

Над повідомленням вказується, що воно було надіслано у відповідь на коментар. Якщо натиснути "View post", ви перейдете до допису, який прокоментували.

Якщо користувач залишає коментар, на який ви не налаштували відповідь (або якщо ви не налаштували жодних відповідей), ви можете відповісти йому одним повідомленням Direct у розділі "Клієнти".

Однак, якщо ви спробуєте надіслати користувачеві ще одне повідомлення Direct, друге повідомлення не буде доставлено, оскільки відповідь на коментар не відкриває 24-годинне вікно обміну повідомленнями.

Як використовувати прямі посилання на дописи Instagram під час роботи з коментарями

Для роботи з коментарями потрібно ввімкнути перемикач "Respond to comments" у розділі Instagram Channels.

Коли користувач коментує допис, у чаті в розділі Клієнти з'являється сповіщення, що містить текст коментаря, і генерується змінна instagram_media_url з посиланням на публікацію.

Ви можете використовувати змінну instagram_media_url для налаштування реакцій на коментарі до конкретних дописів Instagram.

Розглянемо приклад.

Налаштування різних відповідей залежно від того, який допис було прокоментовано

Завдання: В обліковому записі є кілька дописів, у тому числі три з продуктами за різними цінами. Налаштуйте відповіді на коментарі до цих трьох дописів, щоб відповідати точною ціною. Для всіх інших дописів відповідайте "За домовленістю." Відповідь має надсилатися як повідомлення Direct, так і як коментар під дописом.

Рішення:

  1. Налаштуйте реакції на основі ключових слів для коментарів до дописів. Це означає, що бот реагуватиме на будь-який допис, де коментар містить вказані ключові слова.
  2. Використовуйте функцію insta_create_comment у Калькуляторі, щоб опублікувати коментар під відповідним дописом, одночасно встановивши текст відповіді в полі Message text для надсилання повідомлення Direct. Це дозволяє користувачеві отримувати ціну одночасно і в коментарях, і в Direct.
  3. Якщо коментар, що містить ключові слова, з'являється під будь-яким іншим дописом, користувач отримає повідомлення "by agreement."

Крок 1. У полі тригера Start block введіть client_wall_reply_new разом із ключовими словами, які мають викликати реакцію. Встановіть тип збігу "Keyword match".

Приклад для копіювання:

client_wall_reply_new_comment (price|how many|cost|find out)

Якщо ви хочете відповідати лише на коментарі під дописами, використовуйте client_wall_reply_new_comment. Якщо ви хочете відповідати лише на коментарі під час прямого ефіру, використовуйте client_wall_reply_new_live.

Коментарі під Reels працюють так само, як і під звичайними дописами.

Крок 2. У полі "Calculator" оголосіть змінну text. Її значення визначається умовою IF, яка перевіряє змінну instagram_media_url.

Приклад для копіювання (не забудьте замінити посилання на ваші фактичні URL-адреси дописів). Ви можете скопіювати URL-адресу зі змінної instagram_media_url у чаті клієнта (розділ Клієнти) після того, як він прокоментує відповідний допис:

text = if(instagram_media_url == "https://www.instagram.com/reel/Cagzkx", "$10", if(instagram_media_url == "https://www.instagram.com/p/CqvCq4", "$29", if(instagram_media_url == "https://www.instagram.com/p/CocLhN", "$35", "Other")))

Крок 3. Використовуйте метод insta_create_comment, щоб опублікувати коментар.

Приклад для копіювання:

insta_create_comment("#{text}")

де #{text} — текст відповіді, який ми надсилаємо користувачеві.

Крок 4. У полі Message text введіть змінну, що містить відповідь для повідомлення Direct.

У цьому прикладі змінна — #{text}. Та сама відповідь публікується як коментар і дублюється в повідомленні Direct. За потреби ви можете налаштувати різні відповіді для кожного.

client_wall_reply_new — це загальний префікс зворотного виклику. Щоб націлитися лише на коментарі під дописами, використовуйте client_wall_reply_new_comment. Щоб націлитися лише на коментарі під час прямого ефіру, використовуйте client_wall_reply_new_live.

Як опублікувати коментар у відповідь на повідомлення під дописом або під час прямого ефіру

Під час роботи з коментарями та налаштування відповідей під дописом використовуйте випадкову функцію та надсилайте змінний текст. Якщо бот багаторазово надсилає однаковий текст, ви можете зіткнутися з помилкою: "This API call does not support the requested response format." Докладніше про роботу з випадковою функцією читайте тут.

Крок 1. У розділі Клієнти скопіюйте зворотний виклик (сповіщення), що вказує на те, що коментар було опубліковано, потім перейдіть до Builder.

Крок 2. Створіть блок "Start" або "Trigger" і вставте скопійований зворотний виклик у поле Trigger.

Існує кілька способів налаштувати умову тригера бота.

У цьому прикладі бот відповідає на коментарі під усіма дописами повідомленням "reply in comments." Щоб налаштувати це, введіть основний префікс зворотного виклику та ключове слово в полі умови:

client_wall_reply_new_comment reply in comments

Важливо: встановіть тип збігу "Keyword match".

УВАГА!

Не рекомендується використовувати цифри як тригери для запуску вашого бота.

Ідентифікатор допису часто складається з цифр. Якщо ваш бот використовує зіставлення на основі ключових слів, він може неправильно відповісти на будь-який зворотний виклик, що містить ці цифри.

client_wall_reply_new — це загальний префікс зворотного виклику, який спрацьовує як для дописів, так і для прямих ефірів.

Щоб відповідати лише на коментарі під дописами, використовуйте:
client_wall_reply_new_comment

Щоб відповідати лише на коментарі під час прямого ефіру, використовуйте:
client_wall_reply_new_live

Існує одна особлива поведінка для зворотних викликів прямого ефіру (client_wall_reply_new_live): бот реагуватиме лише під час прямого ефіру. Після завершення прямого ефіру бот більше не виявлятиме коментарі під ним і не зможе відповісти.

Крок 3. У полі response введіть #{none}.

Крок 4. У полі "Calculator" напишіть:

insta_create_comment("your comment text response")

Текст вашого коментаря потрібно помістити в дужки.

Потім натисніть "Done".

За такої конфігурації, як у прикладі, згенерований ботом коментар буде опубліковано у відповідь на будь-який коментар під дописом, що містить ключові слова "reply in the comments".

Приклад відповіді бота на коментар у коментарях.

Відповідь бота на БУДЬ-ЯКИЙ коментар під БУДЬ-ЯКИМ дописом.

Якщо ви введете лише загальний префікс зворотного виклику client_wall_reply_new у полі "Trigger", ваш коментар буде опубліковано у відповідь на коментарі під усіма дописами (незалежно від тексту, який написав користувач).

Відповідь бота на КОНКРЕТНУ ФРАЗУ під БУДЬ-ЯКИМ дописом.

Якщо ви залишите в полі "Trigger" client_wall_reply_new ``та ключове слово, то ваш коментар буде надіслано у відповідь на коментарі з ключовим словом під усіма дописами.

Відповідь бота на КОНКРЕТНУ ФРАЗУ під КОНКРЕТНИМ дописом.

Скопіюйте повний зворотний виклик із розділу клієнтів і помістіть його в поле блоку Start:

Ви можете відповідати на коментарі, які користувачі залишають під час прямого ефіру (для цього є окремий ключ client_wall_reply_new_live).

Для прямих ефірів є одна особливість: бот реагуватиме лише під час трансляції. Якщо трансляція закінчилася, бот не бачитиме коментарі під цією трансляцією і не зможе відповісти.

Як зберегти текст коментаря у змінну

Щоб зберегти текст коментаря користувача, використовуйте функцію comment_text().

Вставте зворотний виклик client_wall_reply_new у поле Trigger. Потім у полі "Calculator" призначте текст змінній, наприклад, comm (ви можете використовувати будь-яке інше ім'я):

comm = comment_text()

Далі натисніть "Add condition" у калькуляторі та вкажіть:

comm = comment_text()

Як видалити коментар

Функція insta_delete_comment(comment_id) видаляє коментар.

Якщо comment_id не вказано, функція використовує змінну клієнта instagram_last_comment_id.

У разі успіху повертає {"success":true}. Якщо вказано неіснуючий comment_id, повертає {"An unexpected error has occurred. Please retry your request later."}.

Робота зі згадками облікового запису

Як згадати в медіа

Коли користувач позначає ваш профіль у своєму дописі, ваш бот отримує наступний зворотний виклик:

З'являються такі змінні:

mention_caption — підпис до допису

post_url — посилання на допис

mention_comments_count — кількість коментарів

mention_like_count — кількість вподобань

mention_media_id — ідентифікатор допису

Давайте налаштуємо реакцію на відповідь на згадку.

Для цього створіть блок "Primary Condition Check" або "State with Condition". У полі "Condition" введіть mention_in_media і встановіть тип збігу "Keyword match".

У полі "Calculator" введіть наступний метод:

reply_to_mention(text)

де text — це коментар, який з'явиться під згаданим дописом. Ви можете вказати змінну (вставляється без лапок у дужках) або ввести текст безпосередньо (в лапках).

Приклад:

Крок 1. Перейдіть до builder і створіть блок з тригером (блок Start або блок Trigger). Потім у полі Trigger вкажіть зворотний виклик mention_in_media.

Виберіть "Mention in post" у списку тригерів, а як метод калькулятора виберіть "Reply comment to a post". Потім введіть текст для коментаря-відповіді.

Крок 2. Натисніть "Add trigger". Тригер разом із методом буде введено в блок:

Як згадати в коментарі

Коли користувач позначає ваш обліковий запис у коментарях, чат отримає зворотний виклик, як:

Якщо ваш обліковий запис позначено в приватному профілі, зворотний виклик не буде отримано.

У картці клієнта також з'являться такі змінні:

  • mention_like_count — кількість вподобань
  • mention_media_id — ідентифікатор допису

Давайте налаштуємо реакцію на відповідь на згадку в коментарі.

Для цього створіть блок "Start" або "Trigger". У полі "Condition" введіть mention_in_comment і встановіть тип збігу "Keyword match".

У полі "Calculator" введіть наступний метод:

reply_to_mention(text)

де text — це коментар, який буде опубліковано у відповідь на згадку. Ви можете вказати змінну (вставляється без лапок у дужках) або ввести текст безпосередньо (в лапках).

Приклад:

Крок 1. Перейдіть до builder, створіть блок з тригером (блок Start або блок Trigger) і введіть наступний зворотний виклик у полі "Trigger":

Далі виберіть умову "Mention in comment".

Крок 3. Натисніть на Calculator і в полі, що з'явиться, введіть метод:

reply_to_mention("Response text for mention in comment")

Якщо 24-годинне вікно не відкрито в чаті з користувачем, ви не можете надіслати пряме повідомлення у відповідь на згадку. Ви можете відповісти лише коментарем.

Якщо 24-годинне вікно відкрито, ви можете ввести текст у полі Response, який користувач отримає як пряме повідомлення після того, як ваш обліковий запис буде згадано.

Як згадувати інші профілі в коментарях під вашими дописами

Якщо когось позначено в коментарях під вашим обліковим записом, у картці клієнта створюється змінна mentioned_in_comment.

Вона зберігає ім'я користувача, якого було позначено.
Якщо позначено більше двох осіб, імена користувачів зберігаються в масиві.

Якщо вам потрібно сегментувати користувачів, які позначили двох або більше друзів, ви можете призначити змінну, наприклад, len = arr_len(mentioned_in_comment), а потім порівняти цю змінну з потрібним значенням.

Якщо 24-годинне вікно обміну повідомленнями не відкрито в чаті з користувачем, ви не можете надіслати пряме повідомлення у відповідь на згадку. Ви можете відповісти лише коментарем.