Executar jornada

Inicia uma execução explícita para contato ou conversa autorizada.

POST/journeys/{id}/executejourneys:write

COMPORTAMENTO

A solicitação valida a entrada, persiste o comando e devolve o estado inicial. A execução pode continuar na fila dedicada.

EFEITO

Pode criar trabalho assíncrono e eventos de webhook depois da confirmação no banco.

REPETIÇÃO

Em falha de rede, confirme o estado do recurso antes de repetir. Refaça automaticamente apenas 429 e 5xx com backoff e jitter.

Solicitação

idstring · pathIdentificador do recurso.minLength 2 · maxLength 100obrigatório

contact_idstring · bodyContato de destino.opcional

conversation_idstring · bodyConversa de destino.opcional

contextobject · bodyContexto não sensível da execução.opcional

AuthorizationBearer ach_live_...

Acceptapplication/json

Escopojourneys:write

Exemplo executável

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"
}'

Resposta e erros

Toda resposta inclui request_id. Listas acrescentam pagination; recursos mutáveis retornam o estado persistido após a operação.

200 application/json

{
  "data": {
    "id": "jrn_01J...",
    "name": "Recover interest",
    "trigger": "conversation.updated",
    "blocks": [],
    "active": 1,
    "executions": 42
  },
  "request_id": "req_01J..."
}

200Operação concluída.

400Parâmetro, corpo ou transição inválida.

401Chave ausente, inválida, expirada ou revogada.

402O plano da conta não libera esta interface.

403A chave precisa do escopo journeys:write.

404Recurso inexistente nesta conta.

409O estado atual impede esta operação.

413O corpo JSON ultrapassa 128 KB.

429A janela de 120 solicitações por minuto foi excedida.

Executar jornada

Solicitação

Exemplo executável

Resposta e erros

Operações relacionadas