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.

Os endpoints de movimentação são separados do PATCH /kanban_items/:id porque disparam automações de etapa e atualizam o histórico de tempo por estágio. Use sempre eles em vez de PATCH quando for trocar etapa/funil.

​
Endpoints

MétodoEndpointDescrição
POST/kanban_items/:id/move_to_stageMove pra outra etapa (mesmo funil ou outro)
POST/kanban_items/:id/moveMove entre funil/etapa
POST/kanban_items/reorderReordena cards no quadro

​
Mover pra outra etapa

curl -X POST https://chat.lfautomatiza.com/api/v1/accounts/1/kanban_items/101/move_to_stage \
  -H "api_access_token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "funnel_stage": "proposal"
  }'
Se quiser mover pra etapa de outro funil: 
{
  "funnel_stage": "onboarding",
  "funnel_id": 22
}
Mover pra etapa cujo nome inclui won ou lost automaticamente atualiza item_details.status. Pra forçar manualmente, use change_status.

​
Reordenar cards na etapa

Quando um agente arrasta cards no Kanban, o front chama esse endpoint com todas as posições novas: 
curl -X POST https://chat.lfautomatiza.com/api/v1/accounts/1/kanban_items/reorder \
  -H "api_access_token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "positions": [
      { "id": 101, "position": 1, "funnel_stage": "lead" },
      { "id": 102, "position": 2, "funnel_stage": "lead" },
      { "id": 103, "position": 3, "funnel_stage": "lead" }
    ]
  }'

​
Quando usar move_to_stage vs move

CenárioEndpoint
Card sobe/desce no funil atualmove_to_stage
Card vai pra outro funil (ex: ganhou venda, agora vai pra Onboarding)move
Apenas reordena dentro da mesma etapa (drag-and-drop visual)reorder