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

POST

/api/v2/ticket

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

Respostas

🟢200OK

application/json

Ticket criado.

Bodyapplication/json

🟠400Pedido Inválido

🟠401Não Autorizado

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Exemplo de Sucesso

{
    "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."
}

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

Página anterior

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

Próxima página

Movimentar ticket entre fases (ou finalizar)

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

Campos do body#

Requisição

Respostas

Campos do body