Viaggi
Corri il viaggio
Avvia un'esecuzione esplicita per un contatto o una conversazione autorizzata.
POST
/journeys/{id}/executejourneys:writeCOMPORTAMENTO
La richiesta convalida l'input, rende persistente il comando e restituisce lo stato iniziale. L'esecuzione può continuare nella coda dedicata.
EFFETTO
È possibile creare eventi di lavoro asincrono e webhook dopo la conferma nel database.
RIPETIZIONE
In caso di errore di rete, verificare lo stato della risorsa prima di riprovare. Ripristina automaticamente solo 429 e 5xx con backoff e jitter.
Richiesta
idstring · pathIdentificatore della risorsa.minLength 2 · maxLength 100obbligatoriocontact_idstring · bodyContatto di destinazione.facoltativoconversation_idstring · bodyDiscorsi sull'obiettivo.facoltativocontextobject · bodyEsecuzione non sensibile al contesto.facoltativoAuthorization
Bearer ach_live_...Accept
application/jsonAmbito
journeys:writeEsempio eseguibile
curl
curl -X POST 'https://achadu.com/api/v1/journeys/resource_id/execute' \
-H 'Authorization: Bearer ach_live_...' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
--data '{
"contact_id": "string",
"conversation_id": "string",
"context": "string"
}'Risposta ed errori
Ogni risposta include request_id. Gli elenchi aggiungono l'impaginazione; le risorse mutabili restituiscono lo stato persistente dopo l'operazione.
200 application/json
{
"data": {
"id": "jrn_01J...",
"name": "Recover interest",
"trigger": "conversation.updated",
"blocks": [],
"active": 1,
"executions": 42
},
"request_id": "req_01J..."
}200Operazione completata.400Parametro, corpo o transizione non validi.401Chiave mancante, non valida, scaduta o revocata.402Il piano dell'account non rilascia questa interfaccia.403A chave precisa do escopo journeys:write.404La funzionalità non esiste in questo account.409Lo stato attuale impedisce questa operazione.413Il corpo JSON supera i 128 KB.429La finestra di 120 richieste al minuto è stata superata.