Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lfautomatiza.com/llms.txt

Use this file to discover all available pages before exploring further.

Pra agir sobre dezenas ou centenas de cards de uma vez, use os endpoints de ações em massa em vez de fazer N chamadas individuais — é mais rápido e respeita o rate limit.

​
Ações em massa

MétodoEndpointDescrição
POST/kanban_items/bulk_move_itemsMove múltiplos cards de etapa
POST/kanban_items/bulk_assign_agentAtribui agente em lote
POST/kanban_items/bulk_set_priorityAtualiza prioridade em lote

​
Mover em massa

curl -X POST https://chat.lfautomatiza.com/api/v1/accounts/1/kanban_items/bulk_move_items \
  -H "api_access_token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "item_ids": [101, 102, 103, 104],
    "new_stage": "proposal",
    "funnel_id": 10
  }'

​
Atribuir agente em lote

curl -X POST https://chat.lfautomatiza.com/api/v1/accounts/1/kanban_items/bulk_assign_agent \
  -H "api_access_token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "item_ids": [101, 102, 103],
    "agent_id": 7,
    "mode": "replace"
  }'
modeComportamento
replaceSubstitui agentes atuais pelo agent_id
addAdiciona o agent_id aos agentes já atribuídos

​
Mudar prioridade em lote

curl -X POST https://chat.lfautomatiza.com/api/v1/accounts/1/kanban_items/bulk_set_priority \
  -H "api_access_token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "item_ids": [101, 102, 103], "priority": "high" }'

​
Busca e filtros avançados

MétodoEndpointDescrição
GET/kanban_items/searchBusca textual em título/descrição/notas
GET/kanban_items/filterFiltros avançados (valor, datas, prioridade)
GET/kanban_items/reportsMétricas agregadas
GET/kanban_items/debugDados técnicos (debug, suporte)

​
Filtro avançado

curl "https://chat.lfautomatiza.com/api/v1/accounts/1/kanban_items/filter?funnel_id=10&priorities[]=high&priorities[]=urgent&value_min=1000&value_max=50000&agent_id=7&from=2026-05-01&to=2026-05-31" \
  -H "api_access_token: $TOKEN"
Parâmetros suportados:
ParâmetroTipoDescrição
funnel_idintegerFiltra por funil
priorities[]arrayMúltiplas prioridades simultâneas
value_minnumberValor mínimo do card
value_maxnumberValor máximo
agent_idintegerAtribuído a este agente
from / todateIntervalo de criação

​
Relatórios

curl "https://chat.lfautomatiza.com/api/v1/accounts/1/kanban_items/reports?funnel_id=10&from=2026-05-01&to=2026-05-31&user_ids[]=7&user_ids[]=11&inbox_id=1" \
  -H "api_access_token: $TOKEN"
Retorna: total por etapa, conversion rate entre etapas, tempo médio por etapa, valor total ganho/perdido no período.

​
Importação e exportação CSV

MétodoEndpointDescrição
GET/kanban_items/exportExporta CSV
POST/kanban_items/import_previewPré-visualiza CSV antes de importar
POST/kanban_items/importImporta CSV definitivamente

​
Exportar

curl "https://chat.lfautomatiza.com/api/v1/accounts/1/kanban_items/export?funnel_id=10" \
  -H "api_access_token: $TOKEN" \
  -o cards.csv
CSV vem em UTF-8 com BOM e separador ; — abre direto no Excel BR sem quebrar acentuação.

​
Preview de importação

curl -X POST https://chat.lfautomatiza.com/api/v1/accounts/1/kanban_items/import_preview \
  -H "api_access_token: $TOKEN" \
  -F "file=@leads.csv"
Retorna as primeiras 10 linhas detectadas + colunas identificadas, pra você mapear no próximo passo.

​
Importar definitivamente

curl -X POST https://chat.lfautomatiza.com/api/v1/accounts/1/kanban_items/import \
  -H "api_access_token: $TOKEN" \
  -F "file=@leads.csv" \
  -F "funnel_id=10" \
  -F "default_stage_id=lead" \
  -F 'mappings={"Nome":"title","Empresa":"description","Valor":"value"}'
Pra importação em produção, sempre rode import_preview antes pra confirmar o mapeamento de colunas. Importação em massa não tem desfazer fácil.