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

Instagram не поддерживает одновременную отправку встроенных и ответных кнопок

Клавиатура (ответ)

Instagram поддерживает до 11 кнопок ответа. Кнопки можно располагать только в линию

Пример:

Результат:

В тексте (встроенные)

Instagram поддерживает не более 3 встроенных кнопок

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

Инструкции по настройке кнопок см. в разделе Кнопки.

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

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

Вы можете загружать вложения в блок как файл или указывая ссылку на файл.

Загружаемые видеофайлы не должны превышать 20 МБ, а аудио- и файлы изображений — не более 5 МБ.

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

Тип медиафайла Поддерживаемый формат Максимальный размер
Аудио M4A 5 МБ
Изображение JPEG, PNG 5 МБ
Видео MP4 20 МБ

НЕ рекомендуется использовать формат MP4 для аудиовложений. Кроме того, аудио в формате MP3 не будет отправлено вовсе.

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

Карусель может содержать от 2 до 10 карточек (слайдов).

Рассмотрим пример с каруселью из 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, '') должно начинаться с новой строки в Калькуляторе.

Это означает, что вам нужно присвоить переменной 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 можно опустить, как показано на рисунке выше.

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

Вступительные фразы позволяют человеку начать чат с компанией, используя список часто задаваемых запросов. Вы можете настроить до четырёх запросов.

Чтобы настроить вступительные фразы, необходимо включить ползунок в подключённой учётной записи Instagram, в разделе «Каналы».

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

Затем выполните следующие шаги:

  1. Настройте ответы на конкретные фразы в вашей воронке.
  2. Разместите необходимые блоки в состоянии «Старт».
  3. Введите текст вступительной фразы в триггер.

Обратите внимание!

Вступительные фразы появляются у пользователей, которые ранее не обращались к вашей учётной записи Instagram (или если вся предыдущая история чата была удалена).

Настройка ответа по ключевому слову в Direct

Чтобы отвечать клиентам в Direct Messages по ключевым словам, вы можете использовать блок с триггером (блоки Start и Trigger) и ввести слова, на которые ваш бот должен реагировать, в поле Trigger:

Выбор совпадения основан на наличии ключевых слов или полном совпадении (рекомендуемые варианты).

В поле «Текст сообщения» введите ответ бота, который получит пользователь. Вы также можете добавить вложения, кнопки и ссылки.

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

Существует два метода проверки статуса подписки:

1. Проверка подписки с помощью калькулятора

result = check_insta_subscription()

result — это имя переменной, в которой будет сохранён результат проверки (при необходимости его можно переименовать).

Функция возвращает:

  • True, если пользователь подписан.
  • False, если пользователь не подписан.

Проверку необходимо выполнять в поле «Переменная», как на стрелке, так и в блоке.

  • result == True — выражение в поле «Переменная», если клиент подписан на аккаунт.
  • result == False — выражение, если клиент не подписан.

Вы также можете использовать другие выражения сравнения, например:
result != False (результат не равен False, то есть пользователь подписан на аккаунт).

  1. Данные из проверки карточки клиента

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

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

verified — указывает, имеет ли пользователь верифицированный аккаунт (синяя галочка). True, если верифицирован, и False, если нет.

followers — показывает количество подписчиков/фолловеров у клиента.

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

Пример:

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

В переменной для сравнения напишите:
follow == True
ИЛИ
follow != False

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

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

Чтобы доставлять разные сообщения в зависимости от статуса подписки, необходимо создать два блока с противоположными условиями. Если вы предпочитаете менее загромождённый подход, рекомендуем определять условия на соединениях (стрелках).

Триггеры на соединениях:

Введите триггер в строку «Переменная» стрелки:
follow == True или follow != False

Если условие триггера выполнено, клиент переходит дальше по воронке.

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

Если вы хотите, чтобы проверка была динамической, рекомендуем добавить кнопку — например, «Я подписался», — чтобы можно было выполнить проверку и перевести человека на следующий этап.

Внимание

Мы НЕ рекомендуем устанавливать таймер без кнопки на закрытой стрелке, так как человек будет получать сообщения непрерывно, быстро исчерпывая ваш лимит сообщений.