Черновики
Черновики
Подготовка и отложенная отправка сообщений для агентов.
Что такое черновик?
Draft — это ещё не отправленное Message. Ресурс, в котором агент готовит письмо: получатели, тема, тело и Attachments — без немедленной отправки.
Надёжность агентов сегодня на первом плане: с Drafts письма могут быть готовы к отправке, а уйти в мир только с вашего разрешения.
Drafts важны для продвинутых сценариев:
- Human-in-the-loop: агент создаёт
Draftдля чувствительного или важного письма; человек проверяет и одобряет перед отправкой. - Отправка по расписанию: агент создаёт
Draft, отдельный процесс отправляет его в нужное время (например в рабочие часы получателя). - Сложная сборка: если письмо собирается из нескольких шагов (данные из разных источников, генерация текста), черновик сохраняет промежуточное состояние.
Жизненный цикл Draft
От создания до отправки.
1. Создать Draft
Нужен Inbox, от имени которого потом пойдёт отправка.
2. Получить Draft
После создания — по ID.
3. Отправить Draft
Финальный шаг: черновик превращается в отправленное Message и удаляется.
Дальше к письму обращайтесь уже по message_id — это уже сообщение.
Отправка по расписанию
Черновик можно запланировать на будущее, передав поле send_at при создании или обновлении. Agent Inbox отправит его в указанное время — без cron и опроса.
Запланировать Draft
Передайте дату-время в формате ISO 8601 в send_at. Черновик автоматически получит метку scheduled, а send_status станет scheduled.
Отмена или перенос
Чтобы отменить запланированную отправку — удалите Draft. Чтобы перенести — обновите send_at.
Список запланированных Draft
Если при создании указан send_at, ставится метка scheduled. Фильтр по параметру labels.
Значения send_status
scheduled— в очереди, отправка в моментsend_at.sending— идёт отправка.failed— ошибка отправки. Повтор: обновитеsend_atна новое время.
Условные фоллоу-апы
Частый паттерн: «фоллоу-ап через 3 дня, если не ответили». Создайте запланированный черновик фоллоу-апа и отмените его через Webhook, если пришёл ответ.
1. Первое письмо и план фоллоу-апа:
2. Отмена при ответе (вебхук):
При входящем ответе ищите на треде метку follow-up:<draft_id> и удалите черновик.
Если лид ответил — фоллоу-ап отменяется. Если нет — уходит по расписанию.
Организация: все Draft по организации
Как и для Threads, можно получить все Draft по всей Organization — удобно для единой панели, где супервайзер видит, одобряет или удаляет черновики любых агентов.
