Vincular / trocar a empresa do ticket

PUT

/api/v2/ticket/{id}/empresa

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

Vincula uma empresa do CRM ao ticket. Se já havia outra empresa vinculada,
inativa o vínculo anterior (não deleta) e cria o novo — o histórico de
empresas que passaram pelo ticket é preservado pra auditoria.

Pré-requisitos

Ticket precisa ter cliente (ticket.customer.id_crm não-null) — sem cliente, vínculo é proibido.

Empresa-alvo precisa existir, estar ativo=true e não soft-deletada.

Empresa-alvo precisa estar na lista de GET /api/v2/ticket/{id}/empresas (cliente direto + relacionados).

Body

Campo	Tipo	Obrigatório	O que faz
`id_empresa_crm`	integer ou string-de-int	sim	`empresa.id` no CRM (descubra via `data/filter` ou no `GET /empresas` acima).

Campos table_name, column_name e template são aceitos pra retrocompatibilidade
mas opcionais — o backend resolve sozinho a partir do id_empresa_crm.

Requisição

Parâmetros de Caminho

Parâmetros Header

Parâmetros Bodyapplication/jsonObrigatório

Examples

Vincular empresa 2 (só com `id_empresa_crm`)Com campos legados (retrocompat — opcional)

{
    "id_empresa_crm": 2
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Vincular empresa 2 (só com `id_empresa_crm`)Com campos legados (retrocompat — opcional)

curl --location --request PUT '/api/v2/ticket//empresa' \
--header 'api-key: {{api-key}}' \
--header 'Content-Type: application/json' \
--data '{
    "id_empresa_crm": 2
}'

Respostas

🟢200OK

application/json

Envelope {ok, data} confirmando o vínculo.

Bodyapplication/json

Exemplo

{
    "ok": true,
    "data": {
        "id_ticket": "00000000-0000-0000-0000-000000000abc",
        "id_empresa_crm": 2,
        "previousLinkInactivated": true
    }
}

🟠400Pedido Inválido

🟠401Não Autorizado

🟠404Registo Não Encontrado

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

Página anterior

Empresas elegíveis para o ticket

Próxima página

CRM - Templates