Quantika API Docs
v1.0 (Public API)

Negociações & Funis (CRM)

Crie e consulte oportunidades de vendas no Kanban do CRM, vincule a contatos e organize seus leads através de funis programáticos.

Criar Negociação (Card no Kanban)

Dispare um POST /api/v1/deals para inserir uma nova oportunidade no seu funil de vendas. Se pipelineId ou stageId não forem informados, o sistema atribuirá automaticamente ao funil principal e à primeira etapa.

POST /api/v1/deals
curl -X POST https://quantikahub.com/api/v1/deals \
  -H "Authorization: Bearer SEU_CLIENT_TOKEN" \
  -H "X-Client-Id: SEU_CLIENT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Negociação Consultoria Premium",
    "value": 1500.00,
    "priority": "high",
    "description": "Cliente interessado no plano corporativo",
    "pipelineId": "SEU_PIPELINE_ID",
    "stageId": "SEU_STAGE_ID",
    "contactId": "SEU_CONTACT_ID"
  }'

Campos do Payload (JSON):

CampoTipoObrigatórioDescrição
titlestringSimTítulo ou nome da negociação (ex: "Compra Plano Pro").
valuenumberNãoValor monetário em Reais (ex: 1500.00). Padrão: 0.00.
prioritystringNão'low' | 'normal' | 'high' | 'urgent'. Padrão: 'normal'.
pipelineIdUUIDNãoID do funil. Se omitido, usa o primeiro funil ativo.
stageIdUUIDNãoID da coluna/etapa do funil. Se omitido, entra na primeira coluna.
contactIdUUIDNãoID do contato associado à oportunidade.

Descobrir Funis e Etapas (Pipelines)

Para saber quais pipelineId e stageId estão configurados na sua conta, utilize o endpoint GET /api/v1/pipelines:

GET /api/v1/pipelines
curl -X GET https://quantikahub.com/api/v1/pipelines \
  -H "Authorization: Bearer SEU_CLIENT_TOKEN" \
  -H "X-Client-Id: SEU_CLIENT_ID"
Exemplo de Resposta (JSON)
{
  "success": true,
  "data": [
    {
      "id": "e0b82142-b06f-40e9-b541-6927a4e613b5",
      "name": "Funil Comercial Principal",
      "description": "Pipeline de novos leads",
      "stages": [
        {
          "id": "f5a7702e-c7cb-4ca9-a514-9b2f6fbf03b9",
          "name": "Novo Lead",
          "order": 0,
          "color": "#6366f1"
        },
        {
          "id": "7b889311-58d0-4cb6-bb75-b4618da1615d",
          "name": "Reunião Agendada",
          "order": 1,
          "color": "#10b981"
        }
      ]
    }
  ]
}

Listar Negociações Existentes

Recupere as oportunidades cadastradas com paginação e filtros por texto (?q=), funil ou etapa:

GET/api/v1/deals?q=Consultoria&limit=10

Testar Endpoint no Playground

Playground Interativo Seguro

Rate Limited
api.quantikahub.com