Secuencias

Automatizaciones drip por pasos: envia y espera, con inscripcion de contactos y ciclo de vida propio.

Una secuencia es una automatizacion tipo drip: una lista ordenada de pasos (enviar un email, esperar un tiempo, enviar otro) por la que van pasando los contactos que inscribes. Requiere los scopes sequences:read y sequences:write.

Modelo

Entidad	Que es
Sequence	La automatizacion: nombre, estado, tipo de disparador y sus pasos
SequenceStep	Un paso ordenado (`position`): enviar email (`SEND_EMAIL`) o esperar (`WAIT`)
SequenceEnrollment	La inscripcion de un contacto: su posicion actual, estado y proximo envio

Un contacto solo puede estar inscrito una vez en la misma secuencia.

Estados de la secuencia

Estado	Significado
`DRAFT`	Borrador editable. Solo en este estado puedes anadir, editar o borrar pasos
`ACTIVE`	Activa: acepta inscripciones y ejecuta pasos
`PAUSED`	Pausada: las inscripciones en curso pasan a `PAUSED`
`ARCHIVED`	Archivada

Endpoints

Metodo	Ruta	Scope	Descripcion
`POST`	`/sequences`	`sequences:write`	Crear (nace en `DRAFT`)
`GET`	`/sequences`	`sequences:read`	Listar (paginado, filtro `status`)
`GET`	`/sequences/:id`	`sequences:read`	Detalle con pasos
`PATCH`	`/sequences/:id`	`sequences:write`	Editar (solo `DRAFT`)
`DELETE`	`/sequences/:id`	`sequences:write`	Borrar (solo `DRAFT`)
`POST`	`/sequences/:id/activate`	`sequences:write`	`DRAFT`/`PAUSED` → `ACTIVE`
`POST`	`/sequences/:id/pause`	`sequences:write`	`ACTIVE` → `PAUSED`

Los pasos y la inscripcion tienen sus propias paginas: Pasos de la secuencia e Inscripcion y disparadores.

Crear una secuencia

POST /sequences
Authorization: Bearer <apiKey o accessToken>
X-Tenant-Id: {tenantId}
Content-Type: application/json

{
  "name": "Onboarding",
  "description": "Bienvenida en 3 correos",
  "triggerType": "MANUAL"
}

Campo	Requerido	Notas
`name`	Si	Hasta 200 caracteres
`description`	No	Hasta 2000 caracteres
`projectId`	No	Asocia la secuencia a un proyecto
`triggerType`	No	`MANUAL` (por defecto), `CONTACT_CREATED`, `CONTACT_TAGGED`, `API_EVENT`
`triggerConfig`	No	Objeto libre con la config del disparador

Siguiente paso

Anade pasos SEND_EMAIL y WAIT — ver Pasos de la secuencia.
Activala e inscribe contactos — ver Inscripcion y disparadores.