Триггеры запуска

Включение API триггера

1. Раскройте раздел "Триггеры запуска" в форме бота
2. Включите переключатель "API триггер"
3. Сохраните изменения

После включения API триггера бот становится доступен для вызова через API.

Использование API триггера

Для вызова бота через API используйте следующий endpoint:

Пример curl команды:

curl -X POST https://your-domain.com/api/v1/agents/YOUR_BOT_UUID/trigger \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message": "Привет! Как дела?"}'

Для работы с API вам нужен API токен. Создайте его в разделе API токены.

Полная документация API доступна в Swagger.

Настройка Cron триггера

1. Раскройте раздел "Триггеры запуска" в форме бота
2. В разделе "Cron триггеры" укажите расписание в формате cron
3. Введите сообщение, которое будет отправлено боту при запуске
4. Включите переключатель "Включен"
5. Сохраните изменения

Формат расписания Cron

Расписание указывается в формате: минута час день месяц день_недели

Примеры:

• 0 9 * * * — каждый день в 9:00
• 0 */6 * * * — каждые 6 часов
• 0 0 * * 1 — каждый понедельник в полночь
• 30 14 1 * * — 1-го числа каждого месяца в 14:30

Символы:

• * — любое значение
• */n — каждые n единиц времени
• n-m — диапазон значений
• n,m — конкретные значения

Сообщение для бота

При каждом запуске по расписанию бот получает указанное вами сообщение. Это сообщение может быть:

• Вопросом, на который бот должен ответить
• Задачей, которую бот должен выполнить
• Командой для запуска определенного действия

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

Несколько Cron триггеров

Вы можете настроить несколько Cron триггеров для одного бота, если нужно запускать его в разное время с разными сообщениями.

Пример 1: Ежедневный отчет

Настройте Cron триггер для ежедневной отправки отчета:

• Расписание: 0 9 * * * (каждый день в 9:00)
• Сообщение: "Сформируй ежедневный отчет по продажам и отправь в Telegram"

Бот будет автоматически формировать отчет и отправлять его через функцию Telegram.

Пример 2: Интеграция с внешней системой

Используйте API триггер для интеграции с внешней системой:

• Включите API триггер
• Настройте внешнюю систему на отправку запросов к API бота
• Бот будет автоматически обрабатывать запросы и выполнять действия

Пример 3: Периодическая проверка

Настройте Cron триггер для периодической проверки:

• Расписание: 0 */4 * * * (каждые 4 часа)
• Сообщение: "Проверь статус заказов и отправь уведомления о проблемах"