Перейти к основному содержанию
Вкладка Триггеры включает и выключает входящие триггеры на этом Instance. Запустить / Остановить — на этой вкладке. Чату в приложении запуск не нужен. См. Приём сообщений. Настроить открывает боковую панель для Telegram, аккаунта Telegram, IMAP или webhook.

Приём сообщений

Запустить включает входящие Telegram, аккаунт Telegram, cron, webhook и IMAP. Остановить выключает их. Запуск может быть заблокирован: нет исполняемого графа, ошибки совместимости в закреплённом графе, или ничего не готово (добавьте Cron, Webhook или IMAP poll, либо триггер Telegram и токен бота).
Остановите приём, прежде чем нажимать Обновить до vN или Использовать черновик. Эти кнопки недоступны, пока приём включён.

Таблица триггеров

Таблица Триггеры — Cron, Webhook, IMAP, Telegram, аккаунт Telegram и Live на активном графе. Состояние — готов или нужна настройка (или бот занят другим Instance). Пустая таблица: На активном графе нет триггеров. Если на графе есть telegram.send или imap.fetch без входящего Telegram или IMAP, вторая таблица Для инструментов показывает эти адаптеры.

Активность

Активность — последняя проверка, пока приём включён. После запуска, до первого опроса: Ждём первый опрос…. Простой опроса: ожидание. Тире — показывать нечего.

Версия

Бейдж в шапке — Live · vN, если Instance закреплён, или Черновик. Новая опубликованная версия даёт баннер Доступна новая версия: vN с Обновить до vN. Использовать черновик (только у тех, кто видит граф) — на бейдже Live · vN. Снимает закрепление, чтобы чат и приём брали черновик графа.

Telegram

Настроить в строке Telegram. Токен Telegram-бота, Отвечать в Telegram результатом агента и Когда отвечать. Когда отвечать — те же варианты, что у аккаунта Telegram, только для Личный и Группа. Канала нет, и у чата нет тем. Ответ этому боту считается упоминанием. Добавить чат находит чаты, которые уже писали этому боту, после хотя бы двух символов. Личный чат, у которого в Запуск стоит Каждое сообщение, пускает этого человека и создаёт его в Участниках, в том числе когда Кто может писать — Только владелец. У бота нет действия, которое добавляет или убирает чат. При Чаты выбирает агент успешная отправка слушает весь этот чат на срок из Сколько слушать после последнего сообщения агента. Не отвечать также останавливает Отвечать в Telegram результатом агента, сообщение о сбое и ответ «занято» в этом чате. Пока политику не сохранили, личный чат начинает запуск, и агент может ответить. Группа начинает запуск, когда бота упоминают или отвечают ему. Личный чат человека, привязанного как Владелец, всегда начинает запуск, и агент может ответить туда. В группе этот человек следует правилу группы. Сообщение начинает запуск. В группе с режимом Только при упоминании остальные сообщения, которые пришли вместе с ним, остаются в этом запуске и сами запуск не начинают. Сообщения, которые приходят, пока запуск ещё идёт, ждут и стартуют вместе, когда он закончится. Если включено Отвечать в Telegram результатом агента, этот текст уходит в Telegram, когда запуск заканчивается, кроме чата, куда писать нельзя. Если в чате уже слишком много ожидающих сообщений, бот отправляет одно сообщение, пока снова не появится место. Бот не пишет, что запуск сорвался из‑за долгой работы. Набор текста — Выключен, При отправке или По длине текста. Индикатор появляется, когда сообщение уходит, а не пока агент работает. По длине текста ждёт пропорционально тексту, со Скоростью набора, и не дольше Максимальной паузы. 0 — лимит платформы. Пауза по умолчанию — 8 секунд. Сохранить Telegram. Секреты — {{secret:…}}. Людей привяжите на вкладке Участники — иначе непривязанные чаты не начнут запуск. У telegram.send свой токен может стоять на узле. Пустое поле берёт бота этого Instance.

Аккаунт Telegram

Настроить в строке Аккаунт Telegram.
  1. Откройте my.telegram.org и войдите.
  2. Откройте API development tools.
  3. Создайте приложение, если его ещё нет. Скопируйте App api_id и App api_hash.
  4. Вставьте их в API ID и API hash, затем Сохранить.
  5. Войти по QR. В Telegram откройте Настройки → Устройства → Подключить устройство и отсканируйте код. Или выберите Войти по номеру, затем код из Telegram и облачный пароль, если Telegram его спросит.
С одного номера можно создать одно приложение. Ту же пару API ID и API hash можно вставить в другой свой Instance. После Сохранить в поле API hash написано Сохранён. Оставьте его пустым, чтобы не менять значение. Новые API ID или API hash при выполненном входе отключают аккаунт. После входа сверху имя аккаунта и Отключить. Откройте Отправка, чтобы настроить Ответы, Набор текста и Суточные лимиты. Откройте Приложение, чтобы сменить API ID или API hash. Сохранить записывает это вместе.

Когда отвечать

Когда отвечать задаёт, где сообщение начинает запуск и куда агент может писать.
  • Личные чаты и упоминания. Личный чат начинает запуск, и агент может отвечать. Группа начинает запуск, когда упоминают этот аккаунт. Канал молчит, пока вы его не добавите. Агент может отвечать и туда. Агент не меняет список.
  • Слушать, не отвечать. Те же чаты начинают запуск. Агент там не отвечает.
  • Чаты выбирает агент. Чат начинает запуск после того, как агент туда напишет, или когда агент его добавит. Ваши чаты остаются как вы задали.
  • Только добавленные чаты. Запуск начинается только в чатах, которые вы добавите. В остальные агент писать не может.
  • Свои правила. У Личный, Группа и Канал свои Запуск и Ответы.
Когда Запуск — Только при упоминании, ответ на сообщение этого аккаунта тоже начинает запуск. По правилу показывает это правило в скобках. Если выбрать его и в Запуск, и в Ответы, строка убирается. Агент может — это Ничего не менять, Добавлять свои чаты или Добавлять и убирать свои чаты. Агент никогда не меняет чат, который задали вы. При двух последних вариантах агент может поставить чат в Чаты, чтобы сообщения оттуда запускали агента. Агент добавляет чат максимум на — сколько такой чат там пробудет, от 5 минут до 30 дней. Если агент не назвал время, берётся это. Потом чат пропадёт из Чатов и снова пойдёт по Когда отвечать. Агент может добавить чат навсегда разрешает агенту оставить чат там без срока. Слушать чат, в который написал агент ставит чат в Чаты с пометкой Агент, когда агент туда пишет, и ответы оттуда запускают агента. Сколько слушать после последнего сообщения агента — сколько он слушает. Если агент напишет туда снова, время считается от нового сообщения. Это не дольше, чем Агент добавляет чат максимум на. Чаты показывает строки, которые отличаются от этого правила. Добавить чат ищет в Telegram, когда введено хотя бы два символа и вы остановились. Выберите чат, задайте Запуск и Ответы и нажмите Сохранить. Личный чат, у которого вы поставили Запуск в Каждое сообщение, позволяет этому человеку писать и создаёт его в Участниках, в том числе когда Кто может писать — Только владелец. Сохранение относится ко всему чату и заменяет строки его тем. Строка темы важнее строки всего чата. В сохранённой строке — имя, а под ним тип, General или Тема, Вы или Агент, и До, если строка закончится сама. Запуск — Каждое сообщение, Только при упоминании, Не запускать или По правилу. Только при упоминании для личного чата не предлагается. Ответы — Может отвечать, Не отвечать или По правилу. Не отвечать останавливает и Отвечать сразу в этом чате. Если изменить строку агента, она станет вашей и срок пропадёт. Когда у агента есть строки, список можно показать как Все, Мои или Агента, а Убрать чаты агента убирает только их. Поиск по списку ищет по имени или id, когда список длинный. Избранное всегда начинает запуск, и агент может туда отвечать. Сообщение с аккаунта Telegram, привязанного как Владелец, начинает запуск в любом чате. Агент может отвечать в личном чате этого человека. Собственные отправки агента запуск не начинают. Чат помечается прочитанным до принятого сообщения, вместе с более старыми сообщениями этого чата. Отвечать сразу публикует текст запуска в этот чат, когда запуск заканчивается. Только когда агент отправит всё равно начинает запуск и помечает чат прочитанным, но в Telegram уходит только сообщение, которое отправил агент. Набор текста — те же Выключен / При отправке / По длине текста, что у бота, и появляется только в момент отправки этого текста. Следующий запуск этого чата видит сообщения людей и текст, который был доставлен. Неотправленный ответ в эту историю не входит. Более старые сообщения в Telegram по-прежнему читает Читать сообщения в чате. Сообщения, которые пришли вместе, читаются как один запуск. Пока запуск ещё идёт, следующие сообщения в этом чате ждут и стартуют вместе после его окончания.

Суточные лимиты

Сообщений в сутки и Вступлений в сутки — целое число или пустое поле без лимита. Сообщения: от 1 до 5000. Вступления: от 1 до 200. Строка под полем — сколько ушло сегодня. Счёт сбрасывается в 00:00 UTC. Время на панели показано в вашем часовом поясе. Текстовое сообщение считается одним. Каждый файл в альбоме считается одним. Стикер, inline-результат и опрос — каждый одним. Каждое пересланное сообщение считается одним. Если альбом или пересылка целиком не влезают в остаток на сегодня, не отправляется ничего. Реакции, правки, голоса, нажатия кнопок, закрепления, модерация, истории и изменения профиля не считаются. Избранное не считается. Ответ, который уходит, пока кто-то привязывает чат, не считается. Поле Вступлений в сутки считает вход в чат. Telegram-бот этого Instance отдельно и в эти лимиты не входит. Если Telegram просит аккаунт подождать больше 10 секунд, на панели написано, что отправка или вступления приостановлены до времени. Отправка или вход до этого времени не проходят. После ожидания в 10 секунд или меньше отправка повторяется. Войдите снова, чтобы снять паузу, оставшуюся от прошлого входа. Медленный режим в одном чате не ставит аккаунт на паузу. Такая отправка не проходит, в ошибке есть время ожидания, и она не считается. Отключить выходит из аккаунта и оставляет API ID, API hash и правила чатов. Вход другим аккаунтом Telegram эти правила удаляет. Один аккаунт Telegram подключается к одному Instance. Если он уже подключён в другом месте, сначала выйдите там. Инструменты: Аккаунт Telegram.

IMAP

Настроить в строке IMAP. Хост, Порт, TLS / SSL, Пользователь, Пароль и Папка. IMAP poll и необязательный IMAP fetch берут это, если поля на узле пустые. Сохранить IMAP.

Общий ящик

Если несколько Instance используют один IMAP-ящик, Общий ящик в панели IMAP:
  • Общий — Письма остаются непрочитанными, пока все шаблоны не завершат запуск успешно.
  • Только этот Instance — Письма помечаются прочитанными после успешного запуска этого шаблона.
Также слушают перечисляет другие копии. Если другие уже слушают этот ящик, диалог предлагает Параллельно (общий) или Только этот Instance. Если другой Instance уже в режиме «Только этот Instance», сначала остановите приём там.

Webhook

Настроить в строке Webhook. Запустить приём, чтобы выпустить URL и секрет подписи. URL эндпоинта — HTTPS-адрес для POST. Сменить секрет один раз показывает Секрет подписи. Сменить URL меняет путь. Последняя доставка или Доставок ещё не было. Как вызывать: Webhook.