Skip to main content
POST
Ai Draft Requests Controller create

Authorizations

Authorization
string
header
required

Token de sesión Better Auth para rutas de backoffice; las rutas de portal usan su token propio.

Headers

Idempotency-Key
string
required

UUID v4 estable por intención

Body

application/json
target
object
required
format
enum<string>
required

Formato de redacción

Available options:
email,
whatsapp,
internal
instructions
string

Indicaciones propias del operador (contexto, tono)

Maximum string length: 4000
internalPurpose
enum<string>

Sólo con el formato internal: campo que llena el texto (nota, descripción, tarea, resultado de la tarea o motivo del cambio de etapa); sin él, una nota

Available options:
note,
description,
task,
task_result,
stage_reason
surface
enum<string>

Compositor o campo de la web que pide el borrador; sólo etiqueta la traza de IA (no cambia el texto ni la idempotencia). En una llamada delegada se ignora

Available options:
inbox_reply,
inbox_note,
email_composer,
whatsapp_composer,
quote_editor,
ticket_conversation,
activity_form,
meeting_form,
task_form,
record_field

Response

requestId
string<uuid>
required
state
enum<string>
required
Available options:
QUEUED,
PREPARING,
DECIDING,
COMPOSING,
REVIEWING,
DRAFT_READY,
NEEDS_OPERATOR,
FAILED,
CANCELLED,
STALE
version
number
required
deadlineAt
string<date-time>

Límite de la solicitud en segundo plano

target
object
format
enum<string>
Available options:
email,
whatsapp,
internal
failure
object
draft
object
metrics
object