Як налаштувати сценарій для подій Instagram у Scenario Builder?

Сценарії для Instagram можуть по-різному обробляти листи в Direct, коментарі до постів, відмітки в сторіс та згадки. Ця інструкція допоможе налаштувати Router та дії, щоб розподіляти події по потрібних гілках сценарію.

Коли знадобиться

  • Потрібно налаштувати різну логіку для листів у Direct та коментарів до постів.
  • Треба автоматично відповідати на коментарі публічно.
  • Потрібно направляти події (відмітки в сторіс, згадки в коментарях) в окремі гілки сценарію.
  • Потрібно обробити окремий коментар (публічна відповідь → лист у Direct → підключення до оператора).

Що важливо знати

  • Router — нода, що направляє виконання в різні гілки за умовами.
  • Типи подій Instagram: Direct (листи), коментар до поста, відмітка в сторіс, згадка в коментарі.
  • Дія Public Reply — публічна відповідь на коментар Instagram (до 2200 символів).
  • Функція доступна після налаштування платформи адміністратором.
  • Режим румів під коментарі: Щоб створювати руми під коментарі лише при явному підключенні оператора зі сценарію (а не автоматично для кожного коментаря), потрібно увімкнути відповідний режим. Для активації зверніться до команди підтримки. Детальна інструкція: Як налаштувати підключення оператора до коментарів Instagram.

Перед початком

  • Ви увійшли в систему з правами інтегратора або адміністратора.
  • Instagram-сторінка підключена до бота.
  • У вас є відкритий сценарій в Scenario Builder з каналом Instagram у стартовій ноді.

Покрокова інструкція

1. Додати ноду Router

  1. На полотні натисніть «+».
  2. Виберіть Router (Роутер) у категорії Основні.
  3. З'єднайте стартову ноду (Channel Trigger з Instagram) з Router.
  4. З'єднайте Router з гілками сценарію через кнопки гілок.

2. Налаштувати умови за типом події Instagram

  1. Клацніть на Router ноду — справа відкриється Node Inspector.
  2. Додайте правила. У полі Поле виберіть Instagram Event Type (тип події Instagram).
  3. Для кожної гілки вкажіть значення:
    • direct_message — листи в Direct (повідомлення не зі сторіс)
    • story_mention — відмітка в сторіс (детальна інструкція: Як налаштувати обробку відміток у сторіс)
    • post_comment — коментар до поста (включно з промо/рекламними постами)
    • mentions — згадка в коментарі до поста
  4. Збережіть зміни.

Зверніть увагу: Коментарі під промо (просунутими) постами обробляються так само, як і звичайні коментарі — тип події post_comment застосовується до обох. Якщо сценарію потрібно розрізняти промо та органічні пости, використовуйте змінні {{instagram_ad_id}} та {{instagram_ad_title}} (для органічних постів вони порожні).

Змінна «посилання на пост» — {{instagram_post_url}}

У полях дій, даних Call Node та констант сценарію можна використовувати {{instagram_post_url}} — посилання на публікацію в Instagram (пост, до якого стосується подія). Зазвичай воно заповнене для коментарів і згадок під постами, щоб передати оператору або зберегти прямий перехід до поста.

Якщо для події посилання недоступне або йдеться переважно про сторіс, поле може бути порожнім — тоді для прев’ю та посилання на сторіс використовуйте {{instagram_story_url}} (детальніше: відмітки в сторіс).

3. Додати публічну відповідь на коментар (опційно)

Якщо в гілці post_comment потрібно автоматично відповісти на коментар:

  1. Після Router додайте ноду Action (Дія).
  2. Виберіть шаблон Instagram Public Reply.
  3. У полі Comment ID вкажіть {{instagram_comment_id}} (змінна підставляється автоматично).
  4. У полі Message введіть текст відповіді (до 2200 символів).
  5. Збережіть зміни.

4. Направити клієнта в особисті повідомлення (опційно)

Після публічної відповіді можна надіслати клієнту лист у Direct. Для цього додайте дію Instagram Send Direct Message з параметром Comment ID — система надішле приватне повідомлення клієнту в особисті повідомлення.

5. Обробити коментар і підключити клієнта до оператора

Якщо потрібно не лише відповісти на коментар, а й продовжити діалог з клієнтом і передати його оператору — зберіть у гілці post_comment таку послідовність дій.

Чому це корисно: Кожен коментар обробляється окремо. Система отримує текст цього коментаря й ID саме цього коментаря — ви можете надіслати публічну відповідь, лист у Direct і передати оператору контекст («що написав клієнт»).

Послідовність дій у гілці post_comment

  1. Instagram Public Reply — публічна відповідь під коментарем (наприклад: «Відписали у дірект»). У Comment ID вкажіть {{instagram_comment_id}}, у Message — текст відповіді.

  2. Instagram Send Direct Message — надіслати клієнту лист у Direct. У Comment ID вкажіть {{instagram_comment_id}}, у Message — {{instagram_comment_text}} (текст коментаря) або власний текст.

  3. Call Node — запустити інший flow сценарію (наприклад, вітальний або підключення до оператора). У Alias вкажіть alias потрібного Entry Point. У Data додайте:

    • comment_text: {{instagram_comment_text}}
    • instagram_comment_id: {{instagram_comment_id}}
    • за потреби посилання на пост: instagram_post_url: {{instagram_post_url}}

  4. У тому flow, на який посилається Call Node, додайте дію Підключення до оператора — тоді клієнт потрапить до оператора з контекстом коментаря.

Важливо: При дії «Підключення до оператора» в гілці коментарів (post_comment) система автоматично створює чат-рум під цей коментар, якщо його ще немає. Таким чином можна керувати підключенням оператора через Scenario Builder — руми створюються лише коли сценарій явно викликає підключення (потребує активації режиму, див. Як налаштувати підключення оператора до коментарів Instagram).

Розділення Direct vs коментар: У дії «Підключення до оператора» є параметр Instagram: тип руму (працює для post_comment і mentions):

  • Коментар або Авто — чат-рум під коментар (оператор бачить контекст поста/коментаря)
  • Direct — звичайний Direct-чат (1:1 з користувачем, без прив'язки до коментаря)

Детальна інструкція: Як налаштувати підключення оператора до коментарів Instagram.

Що відбувається в результаті

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

Що відбувається після

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

Пов'язані матеріали