Sequenze

Automazioni drip a step: invia e attendi, con iscrizione dei contatti e ciclo di vita proprio.

Una sequenza e un'automazione di tipo drip: un elenco ordinato di step (invia un'email, attendi un po', invia un'altra) attraverso cui passano i contatti che iscrivi. Richiede gli scope sequences:read e sequences:write.

Modello

Entita	Che cos'e
Sequence	L'automazione: nome, stato, tipo di trigger e i suoi step
SequenceStep	Uno step ordinato (`position`): invia email (`SEND_EMAIL`) o attendi (`WAIT`)
SequenceEnrollment	L'iscrizione di un contatto: posizione attuale, stato e prossimo invio

Un contatto puo essere iscritto alla stessa sequenza una sola volta.

Stati della sequenza

Stato	Significato
`DRAFT`	Bozza modificabile. Solo in questo stato puoi aggiungere, modificare o eliminare step
`ACTIVE`	Attiva: accetta iscrizioni ed esegue gli step
`PAUSED`	In pausa: le iscrizioni in corso passano a `PAUSED`
`ARCHIVED`	Archiviata

Endpoint

Metodo	Percorso	Scope	Descrizione
`POST`	`/sequences`	`sequences:write`	Crea (nasce in `DRAFT`)
`GET`	`/sequences`	`sequences:read`	Elenca (paginato, filtro `status`)
`GET`	`/sequences/:id`	`sequences:read`	Dettaglio con step
`PATCH`	`/sequences/:id`	`sequences:write`	Modifica (solo `DRAFT`)
`DELETE`	`/sequences/:id`	`sequences:write`	Elimina (solo `DRAFT`)
`POST`	`/sequences/:id/activate`	`sequences:write`	`DRAFT`/`PAUSED` → `ACTIVE`
`POST`	`/sequences/:id/pause`	`sequences:write`	`ACTIVE` → `PAUSED`

Step e iscrizione hanno pagine proprie: Step della sequenza e Iscrizione e trigger.

Creare una sequenza

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

{
  "name": "Onboarding",
  "description": "Benvenuto in 3 email",
  "triggerType": "MANUAL"
}

Campo	Obbligatorio	Note
`name`	Si	Fino a 200 caratteri
`description`	No	Fino a 2000 caratteri
`projectId`	No	Associa la sequenza a un progetto
`triggerType`	No	`MANUAL` (predefinito), `CONTACT_CREATED`, `CONTACT_TAGGED`, `API_EVENT`
`triggerConfig`	No	Oggetto libero con la config del trigger

Passo successivo

Aggiungi step SEND_EMAIL e WAIT — vedi Step della sequenza.
Attivala e iscrivi i contatti — vedi Iscrizione e trigger.