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

Variação de POST /ticket que tenta encontrar o cliente CRM pelo contato
(crm.contact_search) e, se não achar, cria um customer + contact novo no CRM
usando crm.contact + crm.customer.

Regras do `crm`

Campo crm é opcional (sem ele, ticket fica sem cliente — funciona).

crm.contact_search é opcional — quando preenchido, busca registro existente.

crm.contact + crm.customer: se um for preenchido, AMBOS são obrigatórios.

Telefones: formato DDI + DDD + número (ex.: 5511988884444). E-mails: padrão.

Campos sistêmicos em `crm.contact`

Campo	Valores aceitos
`tipo_contato`	`email` ou `phone`
`canal_contato` (int)	2=WhatsApp, 3=SMS, 4=E-mail, 6=Telefone, 9=Telegram, 12=RCS
`contato` (string)	Valor do contato (telefone formatado ou email)

Campos obrigatórios em `crm.customer`

Além do que o template do CRM exigir, dois campos são obrigatórios e a criação falha com 400 sem eles:

Campo	Falha se ausente
`ativo` (boolean)	`o campo 'Ativo' é obrigatório e deve ser preenchido`
`cpf_cnpj` (string, só dígitos)	400 informando que CPF/CNPJ é obrigatório

Os dois identificadores do ticket

A resposta traz id e id_seq, e eles não são intercambiáveis:

Identificador	Formato	Onde se usa
`id`	UUID	`/ticket/message`, `/ticket/finish`, `/ticket/link_customer`, `/ticket/info/{id}`
`id_seq`	inteiro	Coluna `id_ticket` das tabelas do CRM (`negociacao` e afins)

Gravar o UUID onde se espera o id_seq não devolve erro, mas o registro fica invisível para a plataforma.

Requisição

Parâmetros Header

Parâmetros Bodyapplication/jsonObrigatório

Examples

Busca cliente pelo e-mail; se não achar, cria customer + contactBusca por telefone (WhatsApp) — formato DDI+DDD+número

{
    "name": "Nome do ticket",
    "description": "Descrição",
    "id_phase": "bbcdb84f-1647-44f5-9499-18c2168a3136",
    "crm": {
        "contact_search": "joao@digitalk.com.br",
        "contact": {
            "contato": "joao@digitalk.com.br",
            "tipo_contato": "email",
            "canal_contato": 4,
            "cpc": false,
            "nome": "Contato de email"
        },
        "customer": {
            "nome": "João",
            "sobrenome": "Da silva",
            "cpf_cnpj": "12829070771",
            "ativo": true
        }
    }
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Respostas

🟢200OK

application/json

Ticket criado. O corpo é o objeto do ticket na raiz, sem o envelope {ok, data}.

Bodyapplication/json

Exemplo

{
    "id": "84cefe00-761e-467c-9f77-fbb05ecb7af9",
    "id_seq": 484898,
    "name": "Ligação receptiva 5511988884444",
    "customer": {
        "id_crm": "42",
        "table": "cliente"
    },
    "negotiation": {
        "id": 104
    }
}

🟠400Pedido Inválido

🟠401Não Autorizado

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

Regras do crm#

Campos sistêmicos em crm.contact#

Campos obrigatórios em crm.customer#