Узлы флоу

Узел — один шаг цепочки. Выбирайте его по действию: отправить, спросить, проверить, сохранить данные или дождаться события.

Триггер

С чего цепочка начинается. Триггер ничего не отправляет сам — он только ловит событие и передаёт ход первому сообщению. Видов пять: команда бота, ключевое слово в сообщении, кнопка на сайте, системное событие и кнопка владельца. Подробно — в статье «Триггеры».

сделай цепочку на команду /start: приветствие и две кнопки

Сообщение

Главный узел. Текст до 4096 знаков с форматированием и переменными, до десяти медиа (фото, видео, документ, голосовое), кнопки под сообщением.

Что важно знать.

• Альбом из двух и более медиа — только фото и видео, и кнопок под альбомом не бывает: так устроен Telegram.
• В тексте работают переменные: {first_name} из Telegram, {name} и {phone} из профиля пользователя, {flow.invite_link} после узла-приглашения, {order.amount} внутри цепочек оплаты.
• Сообщение может уйти не человеку, а в группу или тему группы — так делают карточки заявок для владельца.

добавь после приветствия сообщение с фото меню и кнопкой «Открыть каталог»

Ввод

Бот задаёт вопрос и ждёт ответ. Ответ записывается в поле коллекции — обычно в профиль пользователя: имя, телефон, e-mail, город.

Проверки. Ответ можно проверять как число, e-mail, телефон или адрес; неподходящий ответ получает сообщение об ошибке и вопрос повторяется.

Фото в ответе. Вместе с текстом узел умеет забрать вложения — фото или альбом — в отдельное поле. Так собирают вопрос в поддержку «с фото проблемы» и показывают его владельцу в теме группы.

спроси имя и телефон, сохрани в профиль, телефон проверяй

Условие

Проверяет утверждение и ведёт по одной из двух веток: «да» или «нет». Проверять можно поле профиля («есть e-mail»), тег, принадлежность к сегменту, значение из данных.

Самый частый случай — не спрашивать то, что уже известно: если e-mail есть, идём к оплате; если нет — сначала ввод.

перед оплатой проверь, есть ли e-mail, и спрашивай только если нет

Тег

Ставит и снимает теги за один шаг. Теги видно на карточке пользователя, по ним фильтруют список и собирают аудиторию рассылки.

после оплаты поставь тег «клиент» и сними «лид»

Запись в данные

Один узел на четыре действия с коллекцией: добавить запись, обновить, добавить-или-обновить, удалить. Умеет счётчики («визитов +1») и работает с несколькими записями на человека — каждая заявка отдельной строкой.

Если записи нет. У обновления и удаления есть выбор: молча остановиться или уйти в отдельную ветку «не найдено». Для заявок, одобрений и оплат правильно второе: человек должен услышать «активной заявки нет», а не тишину.

сохрани заявку в коллекцию «заявки» со статусом «новая» и датой

Ссылка-приглашение

Создаёт личную ссылку в закрытый канал или группу: на одного человека, с ограничением по числу использований и сроку. Ссылка кладётся в переменную, и следующее сообщение её отправляет.

после оплаты сделай ссылку в закрытый канал на один вход и отправь её

Ожидание

Ставит цепочку на паузу: до ответа человека, до отправки формы на сайте или просто на время. Пока цепочка ждёт, можно напоминать — раз, два, десять — и ожидание от этого не закрывается. Подробно — в статье «Ожидания и оплата».

если человек не ответил за час — напомни, через сутки — закрой вопрос

Жизненный цикл оффера

Особый узел: у него нет входа, его не ставят «после» чего-то. Он подписан на события оффера — заказ создан, оплачен, не оплачен, отменён, возвращён — и на каждое запускает свою ветку. Именно здесь живёт выдача купленного. Подробно — там же, в «Ожиданиях и оплате».