Черновики
Черновики
Подготовка и отложенная отправка сообщений для агентов.
Черновики
Подготовка и отложенная отправка сообщений для агентов.
Draft — это ещё не отправленное Message. Ресурс, в котором агент готовит письмо: получатели, тема, тело и Attachments — без немедленной отправки.
Надёжность агентов сегодня на первом плане: с Drafts письма могут быть готовы к отправке, а уйти в мир только с вашего разрешения.
Drafts важны для продвинутых сценариев:
Draft для чувствительного или важного письма; человек проверяет и одобряет перед отправкой.Draft, отдельный процесс отправляет его в нужное время (например в рабочие часы получателя).DraftОт создания до отправки.
DraftНужен Inbox, от имени которого потом пойдёт отправка.
DraftПосле создания — по ID.
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.
scheduled — в очереди, отправка в момент send_at.sending — идёт отправка.failed — ошибка отправки. Повтор: обновите send_at на новое время.Частый паттерн: «фоллоу-ап через 3 дня, если не ответили». Создайте запланированный черновик фоллоу-апа и отмените его через Webhook, если пришёл ответ.
1. Первое письмо и план фоллоу-апа:
2. Отмена при ответе (вебхук):
При входящем ответе ищите на треде метку follow-up:<draft_id> и удалите черновик.
Если лид ответил — фоллоу-ап отменяется. Если нет — уходит по расписанию.
Draft по организацииКак и для Threads, можно получить все Draft по всей Organization — удобно для единой панели, где супервайзер видит, одобряет или удаляет черновики любых агентов.