Despachar Atividade de Tarefa
Despachar manualmente uma atividade TASK para um provedor externo.
POST /api/activities/tasks/:id/dispatch
Despacha manualmente uma atividade TASK para um provedor externo. A atividade deve estar em status Atividade está completamente resolvida e pronta para ser acionada. Se o cliente tiver um provedor configurado para fazer o despacho das atividades, a próxima ação do sistema tenta despachá-la; caso contrário, a atividade permanece READY e poderá ser acionada na plataforma interna por algum operador. (veja Activity States para a state machine completa).
Auth: Obrigatório — permissão activity:dispatch
Parâmetros de Rota
| Parâmetro | Tipo | Descrição |
|---|---|---|
id | UUID | ID da atividade |
Exemplo
curl -X POST https://api.reten.ai/api/activities/tasks/ee0e8400-e29b-41d4-a716-446655440000/dispatch \
-H "Authorization: Bearer <token>" \
-H "x-tenant-id: <tenant-id>" \
-H "x-project-id: <project-id>"const taskId = "ee0e8400-e29b-41d4-a716-446655440000";
const response = await fetch(`https://api.reten.ai/api/activities/tasks/${taskId}/dispatch`, {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
"x-project-id": "<project-id>",
},
});
// 204 Sem Conteúdo em caso de sucessoimport requests
task_id = "ee0e8400-e29b-41d4-a716-446655440000"
response = requests.post(
f"https://api.reten.ai/api/activities/tasks/{task_id}/dispatch",
headers={
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
"x-project-id": "<project-id>",
},
)
# 204 Sem Conteúdo em caso de sucessoResposta 204 Sem Conteúdo
Sem corpo de resposta. O status da atividade passa para Atividade foi entregue ao provedor externo. Aplica-se apenas quando o cliente tem um provedor de despacho configurado para a atividade; clientes que operam exclusivamente na plataforma interna da Reten não passam por este status. Ter provedor de despacho não impede que o resultado seja registrado na plataforma interna: o outcome pode chegar tanto do provedor externo quanto da plataforma interna. em caso de sucesso.
Respostas de Erro
| Status | Descrição |
|---|---|
400 | A atividade não está em status READY ou não é do tipo TASK |
404 | Atividade não encontrada |
404 | Nenhuma configuração de despacho encontrada para o canal da atividade |
Notas
- Usa bloqueio otimista para evitar despachos concorrentes
- Em caso de falha, tenta novamente até 3 vezes antes de marcar como Atividade alcançou um status terminal de falha por uma de duas vias: (a) as tentativas de despacho se esgotaram sem sucesso; ou (b) um processo de fechamento de fim de dia detectou uma atividade que ficou tentando novamente e a marcou como FAILED com resultado NOT_EXECUTED. Embora seja terminal, uma atividade FAILED pode ser recuperada manualmente por um endpoint dedicado, que a tenta novamente uma vez; a tentativa pode terminar em DISPATCHED, RETRYING ou novamente FAILED.
- As credenciais são descriptografadas somente durante a execução do despacho