Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Cria um novo funil de venda com etapas.
POST /v1/pipelines
write:pipelines
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Sim | Nome do funil (máx. 100 chars) |
description | string | Não | Descrição (máx. 500 chars) |
stages | array | Sim | Mínimo 1 etapa |
is_default | boolean | Não | Define como funil padrão |
after_won | object | Não | Ação após ganhar |
after_lost | object | Não | Ação após perder |
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | Não | ID de uma etapa existente. Só faz sentido em Atualizar, para preservar a etapa |
name | string | Sim | Nome da etapa. Até 100 caracteres |
order | integer | Não | Posição (0 = primeira) |
color | string | Não | Cor hexadecimal |
win_probability | integer | Não | 0–100 |
stalling_enabled | boolean | Não | Alerta de estagnação |
stalling_days | integer | Não | Dias para alertar |
| Campo | Tipo | Descrição |
|---|---|---|
enabled | boolean | Ativar ação automática |
action | string|null | Ação: move_to_stage |
target_pipeline | string|null | ID do funil de destino |
target_stage | string|null | Nome da etapa destino |
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}
]
}'
HTTP 201 com o objeto funil criado, já com os IDs das etapas gerados.
| Código | Status | Descrição |
|---|---|---|
VALIDATION_ERROR | 400 | Corpo inválido. details[] aponta o campo |
NAME_REQUIRED | 400 | Nome do funil ausente |
STAGES_REQUIRED | 400 | É preciso ao menos uma etapa |