Movimentar ticket entre fases (ou finalizar)

POST

/api/v2/ticket/finish

Última modificação:2026-05-28 20:05:32

Move o ticket pra outra fase do workflow. Se a fase de destino tem
finisher: true, o ticket é finalizado automaticamente (e os
protocolos associados também são fechados).

O tipo de finalização (sucesso/insucesso) vem do statusId da fase:

statusId=1 → continua em andamento

statusId=2 → finalização com insucesso

statusId=3 → finalização com sucesso

Body

Campo	Obrigatório	O que faz
`id_ticket`	sim	UUID do ticket
`id_phase`	sim	UUID da fase de destino
`id_tab`	depende	Tabulação — obrigatório quando a fase exige; ignorado caso contrário

Requisição

Parâmetros Header

Parâmetros Bodyapplication/jsonObrigatório

Examples

Mover pra próxima etapa (fase em andamento)Finalizar (fase finisher) com tabulação

{
    "id_ticket": "39de221c-2e3d-4006-9a87-79ffc5288a06",
    "id_phase": "b5d7f8ab-3c76-43db-838c-73c54cc1e0f7"
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Mover pra próxima etapa (fase em andamento)Finalizar (fase finisher) com tabulação

curl --location '/api/v2/ticket/finish' \
--header 'api-key: {{api-key}}' \
--header 'Content-Type: application/json' \
--data '{
    "id_ticket": "39de221c-2e3d-4006-9a87-79ffc5288a06",
    "id_phase": "b5d7f8ab-3c76-43db-838c-73c54cc1e0f7"
}'

Respostas

🟢200OK

application/json

Movimentação executada (e finalização se a fase era finisher).

Bodyapplication/json

Exemplo

{
    "ok": true,
    "message": "Ticket movimentado com sucesso."
}

🟠400Pedido Inválido

🟠401Não Autorizado

🟠404Registo Não Encontrado

Modificado em 2026-05-28 20:05:32

Página anterior

Criar ticket com auto-vínculo / criação de customer via contato

Próxima página

Atualizar dados do ticket (nome, descrição)

Movimentar ticket entre fases (ou finalizar)

Body#

Requisição

Códigos de solicitação

Respostas

Body