Movimentar ticket entre fases (ou finalizar)

POST

/api/v2/ticket/finish

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

Respostas

🟢200OK

application/json

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

Bodyapplication/json

🟠400Pedido Inválido

🟠401Não Autorizado

🟠404Registo Não Encontrado

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Exemplo de Sucesso

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

Modificado em 2026-11-04 02:31:07

Página anterior

Criar ticket (básico, com integração CRM opcional)

Próxima página

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

Movimentar ticket entre fases (ou finalizar)

Body#

Requisição

Respostas

Body