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

POST

/api/v2/ticket

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

Cria um ticket numa fase específica do workflow. Aceita opcionalmente
vincular um cliente CRM existente (via crm.id + table_name + column_name)
e um motivo de abertura (id_reason).

Pra criação com auto-descoberta/criação do cliente via contato, use
POST /api/v2/ticket/custom.

Campos do body

Campo	Obrigatório	O que faz
`name`	sim	Título do ticket
`description`	sim	Descrição
`id_phase`	sim	UUID da fase inicial (vem de `GET /workflows/{id}/phases`)
`crm`	não	Vincula cliente CRM existente: `{ id, table_name, column_name }`
`id_reason`	não	Motivo de abertura (id numérico do motivo configurado no tenant)

Requisição

Parâmetros Header

Parâmetros Bodyapplication/jsonObrigatório

Examples

Sem cliente, sem motivoVinculando cliente CRM existente + motivo

{
    "name": "Título do ticket",
    "description": "Descrição do ticket",
    "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

Sem cliente, sem motivoVinculando cliente CRM existente + motivo

curl --location '/api/v2/ticket' \
--header 'api-key: {{api-key}}' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Título do ticket",
    "description": "Descrição do ticket",
    "id_phase": "b5d7f8ab-3c76-43db-838c-73c54cc1e0f7"
}'

Respostas

🟢200OK

application/json

Ticket criado.

Bodyapplication/json

Exemplo

{
    "ok": true,
    "data": {
        "id": "84cefe00-761e-467c-9f77-fbb05ecb7af9",
        "id_seq": 484898,
        "name": "Título do ticket",
        "id_phase": "b5d7f8ab-3c76-43db-838c-73c54cc1e0f7"
    },
    "message": "Ticket aberto com sucesso."
}

🟠400Pedido Inválido

🟠401Não Autorizado

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

Página anterior

Detalhe completo do ticket (mensagens, SLA, fases, customer, empresa, business)

Próxima página

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

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

Campos do body#

Requisição

Códigos de solicitação

Respostas

Campos do body