Skip to main content

Endpoint

POST /v1/pipelines
Escopo necessário: write:pipelines

Corpo da requisição

CampoTipoObrigatórioDescrição
namestringSimNome do funil (máx. 100 chars)
descriptionstringNãoDescrição (máx. 500 chars)
stagesarraySimMínimo 1 etapa
is_defaultbooleanNãoDefine como funil padrão
after_wonobjectNãoAção após ganhar
after_lostobjectNãoAção após perder

Objeto stage

CampoTipoObrigatórioDescrição
namestringSimNome da etapa
orderintegerNãoPosição (0 = primeira)
colorstringNãoCor hexadecimal
win_probabilityintegerNão0–100
stalling_enabledbooleanNãoAlerta de estagnação
stalling_daysintegerNãoDias para alertar

Objeto after_won / after_lost

CampoTipoDescrição
enabledbooleanAtivar ação automática
actionstring|nullAção: move_to_stage
target_pipelinestring|nullID do funil de destino
target_stagestring|nullNome da etapa destino

Exemplo de requisição

curl -X POST https://api.socialsell.ai/v1/pipelines \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Funil SDR",
    "description": "Funil de qualificação inicial",
    "stages": [
      {"name": "Prospecção", "order": 0, "win_probability": 5},
      {"name": "Primeiro contato", "order": 1, "win_probability": 15},
      {"name": "Interesse confirmado", "order": 2, "win_probability": 40, "stalling_enabled": true, "stalling_days": 5},
      {"name": "Reunião agendada", "order": 3, "win_probability": 70}
    ]
  }'

Resposta

Retorna HTTP 201 com o objeto funil de venda criado (com IDs de etapas gerados).