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):
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| title | string | Sim | Título ou nome da negociação (ex: "Compra Plano Pro"). |
| value | number | Não | Valor monetário em Reais (ex: 1500.00). Padrão: 0.00. |
| priority | string | Não | 'low' | 'normal' | 'high' | 'urgent'. Padrão: 'normal'. |
| pipelineId | UUID | Não | ID do funil. Se omitido, usa o primeiro funil ativo. |
| stageId | UUID | Não | ID da coluna/etapa do funil. Se omitido, entra na primeira coluna. |
| contactId | UUID | Não | ID 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=10Testar Endpoint no Playground
Playground Interativo Seguro
api.quantikahub.com