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

POST

/api/v2/ticket/custom

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

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)

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

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

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

curl --location '/api/v2/ticket/custom' \
--header 'api-key: {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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"
        }
    }
}'

Respostas

🟢200OK

application/json

Ticket criado (e customer criado/vinculado se aplicável).

Bodyapplication/json

Exemplo

{
    "ok": true,
    "data": {
        "id": "84cefe00-761e-467c-9f77-fbb05ecb7af9",
        "id_seq": 484898,
        "customer": {
            "id_crm": "42",
            "table": "cliente"
        }
    },
    "message": "Ticket aberto com sucesso."
}

🟠400Pedido Inválido

🟠401Não Autorizado

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

Página anterior

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

Próxima página

Movimentar ticket entre fases (ou finalizar)