Digitalk Developers
  1. Templates
Raiz
  • Raiz
  • CRM
    • CRM — Overview
    • GenĂ©rico (data)
      • CRM - GenĂ©rico
      • Listar/filtrar registros (qualquer tabela do CRM)
      • Criar/atualizar registros (qualquer tabela do CRM)
      • Hard-delete (nĂŁo permitido para tabelas company)
    • 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)
        GET
      • Detalhe completo do template (com fields)
        GET
      • Pesquisa formatada por scope (CRMSearchResult)
        GET
  • 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. Templates

Pesquisa formatada por scope (CRMSearchResult)

GET
/api/v2/crm/data_imports/scope/{scope_type}/formatted
Última modificação:2026-05-28 20:05:32
Pesquisa em texto livre dentro de um scope (customer / contact / business / catalog)
retornando os dados no formato CRMSearchResult — já paginado, já mapeado pra colunas
com label + type + value pronto pra renderização.
Diferente de POST /api/v2/crm/data/filter (que retorna array nu de campos brutos),
este vem estruturado em torno do template — útil pra telas que precisam exibir
cada campo com seu label e tipo correto sem ter que cruzar com o template separadamente.

Path param#

{scope_type}: customer | contact | business | catalog

Query params#

search (opcional): termo de busca — pode ser nome, CPF, CNPJ
page: número da página (a partir de qual valor depende do tenant)
size: limite de resultados por página

Requisição

Parâmetros de Caminho

Parâmetros de Consulta

Parâmetros Header

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 --location '/api/v2/crm/data_imports/scope/customer/formatted?search=marcus&page=1&size=20' \
--header 'api-key: {{api-key}}'

Respostas

🟢200OK
application/json
Estrutura CRMSearchResult — dados já formatados pelo template.
Bodyapplication/json

Exemplo
{
    "scope": "customer",
    "principal_table": "cliente",
    "template": {
        "id": "26cd301a-5c82-468b-9c23-af3c915d9720",
        "name": "Cliente",
        "table_name": "cliente"
    },
    "data": [
        [
            {
                "column": "id",
                "label": "ID",
                "type": "auto_increment",
                "field_type": "simple",
                "icon": "",
                "key": true,
                "visible": true,
                "required": true,
                "foreign_key": false,
                "value": 1
            },
            {
                "column": "nome",
                "label": "Nome",
                "type": "customer_name",
                "field_type": "simple",
                "icon": "",
                "key": false,
                "visible": true,
                "required": false,
                "foreign_key": false,
                "value": "Marcus"
            },
            {
                "column": "cpf_cnpj",
                "label": "CPF/CNPJ",
                "type": "customer_cpfcnpj",
                "field_type": "simple",
                "icon": "",
                "key": false,
                "visible": true,
                "required": true,
                "foreign_key": false,
                "value": "35191550870"
            }
        ]
    ],
    "pagination": {
        "last_page": 3,
        "first_page": 1,
        "current_page": 1,
        "page_size": 20,
        "total_rows": 42
    }
}
đźź 401NĂŁo Autorizado
Modificado em 2026-05-28 20:05:32
Página anterior
Detalhe completo do template (com fields)
Próxima página
Workflow - Overview
Built with