Skip to main content

Endpoint

GET /v1/pipelines
Escopo necessário: read:pipelines

Exemplo de requisição

curl "https://api.socialsell.ai/v1/pipelines" \
  -H "Authorization: Bearer sk_live_..."

Exemplo de resposta

{
  "data": [
    {
      "id": "664a1b2c3d4e5f6789012345",
      "name": "Funil Principal",
      "description": "Funil de vendas principal da equipe",
      "is_default": true,
      "is_active": true,
      "stages": [
        {
          "id": "664e1a2b3c4d5e6f78901230",
          "name": "Novo Lead",
          "order": 0,
          "color": "#6366F1",
          "win_probability": 10,
          "stalling_enabled": false,
          "stalling_days": null
        },
        {
          "id": "664e1a2b3c4d5e6f78901231",
          "name": "Qualificação",
          "order": 1,
          "color": "#8B5CF6",
          "win_probability": 30,
          "stalling_enabled": true,
          "stalling_days": 7
        },
        {
          "id": "664e1a2b3c4d5e6f78901232",
          "name": "Proposta enviada",
          "order": 2,
          "color": "#A78BFA",
          "win_probability": 60,
          "stalling_enabled": true,
          "stalling_days": 5
        },
        {
          "id": "664e1a2b3c4d5e6f78901233",
          "name": "Negociação",
          "order": 3,
          "color": "#7C3AED",
          "win_probability": 80,
          "stalling_enabled": true,
          "stalling_days": 3
        }
      ],
      "deals_count": 45,
      "won_count": 12,
      "after_won": null,
      "after_lost": null,
      "created_at": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-05-01T00:00:00.000Z"
    }
  ],
  "meta": {
    "total": 2,
    "has_more": false
  }
}

Objeto funil de venda

CampoTipoDescrição
idstringID do funil
namestringNome
descriptionstring|nullDescrição
is_defaultbooleanSe é o funil padrão
is_activebooleanSe está ativo
stagesarrayLista de etapas ordenadas
deals_countintegerTotal de negócios
won_countintegerNegócios ganhos
after_wonobject|nullAção após ganhar negócio
after_lostobject|nullAção após perder negócio

Objeto stage

CampoTipoDescrição
idstringID da etapa — use em stage_id nos endpoints de deals
namestringNome da etapa
orderintegerPosição na sequência (0 = primeira)
colorstringCor hexadecimal
win_probabilityintegerProbabilidade de fechamento (0–100)
stalling_enabledbooleanSe alerta de estagnação está ativo
stalling_daysinteger|nullDias sem movimentação para alertar