Podróże
Biegnij podróż
Rozpoczyna jawne wykonanie autoryzowanego kontaktu lub konwersacji.
POST
/journeys/{id}/executejourneys:writeZACHOWANIE
Żądanie sprawdza poprawność danych wejściowych, utrwala polecenie i zwraca stan początkowy. Wykonywanie może być kontynuowane w dedykowanej kolejce.
EFEKT
Możesz tworzyć asynchroniczne zdarzenia robocze i webhook po potwierdzeniu w bazie danych.
POWTÓRKA
W przypadku awarii sieci potwierdź stan zasobu przed ponowną próbą. Automatycznie ponawiaj tylko 429 i 5xx z cofaniem i jitterem.
Żądanie
idstring · pathIdentyfikator zasobu.minLength 2 · maxLength 100obowiązkowecontact_idstring · bodyDocelowy kontakt.opcjonalneconversation_idstring · bodyCelowa rozmowa.opcjonalnecontextobject · bodyWykonanie bez kontekstu.opcjonalneAuthorization
Bearer ach_live_...Accept
application/jsonZakres
journeys:writePrzykład wykonywalny
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"
}'Odpowiedź i błędy
Każda odpowiedź zawiera request_id. Listy dodają paginację; zasoby modyfikowalne zwracają utrwalony stan po operacji.
200 application/json
{
"data": {
"id": "jrn_01J...",
"name": "Recover interest",
"trigger": "conversation.updated",
"blocks": [],
"active": 1,
"executions": 42
},
"request_id": "req_01J..."
}200Operacja zakończona.400Nieprawidłowy parametr, treść lub przejście.401Brakujący, nieprawidłowy, wygasły lub unieważniony klucz.402Plan konta nie udostępnia tego interfejsu.403A chave precisa do escopo journeys:write.404Funkcja nie istnieje na tym koncie.409Obecny stan uniemożliwia tę operację.413Treść JSON przekracza 128 KB.429Przekroczono okno 120 żądań na minutę.