Digitalk Developers
  1. Genérico (data)
Raiz
  • Raiz
  • CRM
    • CRM — Overview
    • Genérico (data)
      • CRM - Genérico
      • Listar/filtrar registros (qualquer tabela do CRM)
        POST
      • Criar/atualizar registros (qualquer tabela do CRM)
        POST
      • Hard-delete (não permitido para tabelas company)
        POST
    • Empresas Relacionadas
      • CRM - Empresas relacionadas
      • Tipos de relacionamento disponíveis
      • Listar relacionamentos de uma empresa (ambas as direções)
      • Criar relacionamento entre duas empresas
      • Alterar o tipo do relacionamento
      • Inativar relacionamento (reversível)
      • Excluir relacionamento (hard-delete)
    • Ticket ↔ Empresa
      • CRM - Ticket <-> Empresa
      • Empresas elegíveis para o ticket
      • Vincular / trocar a empresa do ticket
    • Templates
      • CRM - Templates
      • Listar templates do tenant (apenas IDs, sem fields)
      • Detalhe completo do template (com fields)
      • Pesquisa formatada por scope (CRMSearchResult)
  • Workflow
    • Workflow - Overview
    • Tickets
      • Workflow - Tickets
      • Detalhe completo do ticket (mensagens, SLA, fases, customer, empresa, business)
      • Criar ticket (básico, com integração CRM opcional)
      • Criar ticket com auto-vínculo / criação de customer via contato
      • Movimentar ticket entre fases (ou finalizar)
      • Atualizar dados do ticket (nome, descrição)
      • Vincular cliente CRM a um ticket existente
      • Adicionar nota ou mensagem ao ticket
    • Workspaces & Workflows
      • Workflow - Workspaces & Workflows
      • Listar workspaces e workflows acessíveis ao usuário
      • Listar fases de um workflow
      • Listar tickets de uma ou mais fases (paginado)
  1. Genérico (data)

Criar/atualizar registros (qualquer tabela do CRM)

POST
/api/v2/crm/data/set
Última modificação:2026-05-28 20:05:32
Criação ou atualização de qualquer tabela do CRM.

Estrutura do payload#

CampoTipoObrigatórioO que faz
tablestringsimTabela alvo.
methodstringsim"post" (cria) ou "patch" (atualiza).
payloadobjectsim{coluna: valor} — só as colunas a definir/atualizar.
filterobject[]só pra patchDefine quais registros atualizar (mesma sintaxe de data/filter).

post vs patch#

post cria um registro novo. Não use filter. O payload vira a linha inserida (auto-incremento do id).
patch atualiza registros existentes que casarem com filter. Sem filter o patch é rejeitado (proteção contra update global acidental).

Inativar vs soft-delete em tabela company (WF-3636)#

data/delete em tabela do scope company retorna 400 (bloqueado). Pra "remover":
OperaçãopayloadEfeito
Inativar (reversível){"ativo": false}Some dos seletores; reversível com ativo: true.
Soft-delete (destrutivo, auditável){"ativo": false, "deleted_at": "<ISO-8601>"}Marca como deletado; reads filtram automaticamente. Setar os dois campos.

Auditoria (WF-3636)#

Toda mutação (post/patch) em tabela company grava trilha em crm_data_audit (registro antes/depois + id_usuario). Trilha interna — sem endpoint público de leitura.

Requisição

Parâmetros Header

Parâmetros Bodyapplication/jsonObrigatório

Examples
{
    "table": "empresa",
    "method": "post",
    "payload": {
        "razao_social": "ACME S.A.",
        "nome_fantasia": "ACME",
        "cnpj": "00000000000100",
        "ativo": true
    }
}

Códigos de solicitação

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/api/v2/crm/data/set' \
--header 'api-key: {{api-key}}' \
--header 'Content-Type: application/json' \
--data '{
    "table": "empresa",
    "method": "post",
    "payload": {
        "razao_social": "ACME S.A.",
        "nome_fantasia": "ACME",
        "cnpj": "00000000000100",
        "ativo": true
    }
}'

Respostas

🟢200OK
application/json
Array nu com o(s) registro(s) afetado(s) (mesmo formato do /data/filter).
Em post vem 1 item (a linha inserida, com id auto-incrementado e campos
sistêmicos preenchidos). Em patch vem N itens (todos os registros que casaram).
Bodyapplication/json

Examples
Tabela financeiro (company, WF-3636) com colunas sistêmicas (criado_em, alterado_em, deleted_at) preenchidas.
[
    {
        "id": 3,
        "id_empresa": 1,
        "juros": 99.99,
        "criado_em": "2026-05-28T15:58:33.461805Z",
        "alterado_em": null,
        "deleted_at": null
    }
]
🟠400Pedido Inválido
🟠401Não Autorizado
Modificado em 2026-05-28 20:05:32
Página anterior
Listar/filtrar registros (qualquer tabela do CRM)
Próxima página
Hard-delete (não permitido para tabelas company)
Built with