Header: api_access_token: SEU_TOKEN_AQUI

GET /api/v1/accounts/{account_id}/funnels

curl -X GET \
  'https://chat.seudominio.com/api/v1/accounts/1/funnels' \
  -H 'api_access_token: SEU_TOKEN' \
  -H 'Content-Type: application/json'

[
  {
    "id": 1,
    "name": "Pipeline de Vendas B2B",
    "description": "Funil principal para vendas corporativas",
    "stages": [
      {
        "name": "Novo Lead",
        "order": 0,
        "color": "#3B82F6"
      },
      {
        "name": "Qualificação",
        "order": 1,
        "color": "#8B5CF6"
      },
      {
        "name": "Proposta",
        "order": 2,
        "color": "#F59E0B"
      },
      {
        "name": "Fechado",
        "order": 3,
        "color": "#10B981"
      }
    ],
    "conversations_count": 45,
    "total_value": 125000.00,
    "created_at": "2025-01-10T00:00:00Z"
  }
]

GET /api/v1/accounts/{account_id}/funnels/{funnel_id}

{
  "id": 1,
  "name": "Pipeline de Vendas B2B",
  "description": "Funil principal para vendas corporativas",
  "stages": [...],
  "conversations_count": 45,
  "total_value": 125000.00,
  "metrics": {
    "conversion_rate": 15.5,
    "average_time_per_stage": {
      "Novo Lead": 24,
      "Qualificação": 48,
      "Proposta": 120
    }
  }
}

POST /api/v1/accounts/{account_id}/funnels

curl -X POST \
  'https://chat.seudominio.com/api/v1/accounts/1/funnels' \
  -H 'api_access_token: SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Pipeline de Vendas B2C",
    "description": "Funil para vendas diretas ao consumidor",
    "stages": [
      {
        "name": "Novo Lead",
        "order": 0,
        "color": "#3B82F6"
      },
      {
        "name": "Contato",
        "order": 1,
        "color": "#8B5CF6"
      },
      {
        "name": "Proposta",
        "order": 2,
        "color": "#F59E0B"
      },
      {
        "name": "Fechado",
        "order": 3,
        "color": "#10B981"
      },
      {
        "name": "Perdido",
        "order": 4,
        "color": "#EF4444"
      }
    ]
  }'

PATCH /api/v1/accounts/{account_id}/funnels/{funnel_id}

curl -X PATCH \
  'https://chat.seudominio.com/api/v1/accounts/1/funnels/1' \
  -H 'api_access_token: SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Pipeline B2B Atualizado",
    "description": "Nova descrição"
  }'

DELETE /api/v1/accounts/{account_id}/funnels/{funnel_id}

GET /api/v1/accounts/{account_id}/funnels/templates

{
  "templates": [
    {
      "name": "Vendas B2B",
      "description": "Template para vendas corporativas",
      "stages": [...]
    },
    {
      "name": "Vendas B2C",
      "description": "Template para vendas diretas",
      "stages": [...]
    },
    {
      "name": "Suporte Técnico",
      "description": "Template para tickets de suporte",
      "stages": [...]
    }
  ]
}

POST /api/v1/accounts/{account_id}/funnels/from_template

{
  "template_name": "Vendas B2B",
  "name": "Meu Pipeline B2B"
}

GET /api/v1/accounts/{account_id}/funnels/{funnel_id}/kanban/conversations

curl -X GET \
  'https://chat.seudominio.com/api/v1/accounts/1/funnels/1/kanban/conversations' \
  -H 'api_access_token: SEU_TOKEN'

{
  "stages": {
    "Novo Lead": {
      "count": 12,
      "total_value": 45000.00,
      "conversations": [
        {
          "id": 123,
          "contact": {
            "id": 45,
            "name": "João Silva",
            "email": "joao@empresa.com"
          },
          "assignee": {
            "id": 1,
            "name": "Agente 1"
          },
          "stage_entered_at": "2025-01-16T10:00:00Z",
          "time_in_stage": 24,
          "products": [
            {
              "id": 1,
              "name": "Plano Premium",
              "value": 5000.00
            }
          ],
          "checklist": [
            {
              "item": "Validar CNPJ",
              "completed": true
            },
            {
              "item": "Enviar material",
              "completed": false
            }
          ],
          "labels": ["urgente", "enterprise"]
        }
      ]
    },
    "Qualificação": {
      "count": 8,
      "total_value": 32000.00,
      "conversations": [...]
    }
  },
  "total_conversations": 45,
  "total_value": 125000.00
}

GET /api/v1/accounts/{account_id}/funnels/{funnel_id}/kanban/stage_conversations

curl -X GET \
  'https://chat.seudominio.com/api/v1/accounts/1/funnels/1/kanban/stage_conversations?stage_name=Proposta&page=1' \
  -H 'api_access_token: SEU_TOKEN'

POST /api/v1/accounts/{account_id}/funnels/{funnel_id}/kanban/move_conversation

curl -X POST \
  'https://chat.seudominio.com/api/v1/accounts/1/funnels/1/kanban/move_conversation' \
  -H 'api_access_token: SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "conversation_id": 123,
    "stage_name": "Proposta",
    "notes": "Cliente solicitou proposta formal"
  }'

{
  "success": true,
  "conversation_id": 123,
  "previous_stage": "Qualificação",
  "current_stage": "Proposta",
  "time_in_previous_stage": 48,
  "moved_at": "2025-01-16T14:00:00Z"
}

POST /api/v1/accounts/{account_id}/conversations/{conversation_id}/funnel_mappings/{mapping_id}/add_checklist_item

{
  "item": "Enviar proposta comercial"
}

PATCH /api/v1/accounts/{account_id}/conversations/{conversation_id}/funnel_mappings/{mapping_id}/update_checklist_item

{
  "index": 0,
  "completed": true
}

DELETE /api/v1/accounts/{account_id}/conversations/{conversation_id}/funnel_mappings/{mapping_id}/remove_checklist_item

{
  "index": 0
}

POST /api/v1/accounts/{account_id}/conversations/{conversation_id}/funnel_mappings/{mapping_id}/assign_agent

{
  "agent_id": 2,
  "role": "collaborator"
}

POST /api/v1/accounts/{account_id}/conversations/{conversation_id}/funnel_mappings/{mapping_id}/remove_agent

{
  "agent_id": 2
}

POST /api/v1/accounts/{account_id}/conversations/{conversation_id}/funnel_mappings/{mapping_id}/start_timer

POST /api/v1/accounts/{account_id}/conversations/{conversation_id}/funnel_mappings/{mapping_id}/pause_timer

POST /api/v1/accounts/{account_id}/conversations/{conversation_id}/funnel_mappings/{mapping_id}/reset_timer

GET /api/v1/accounts/{account_id}/funnels/{funnel_id}/metrics

{
  "total_conversations": 45,
  "total_value": 125000.00,
  "average_ticket": 2777.78,
  "conversion_rate": 15.5,
  "stages_metrics": {
    "Novo Lead": {
      "count": 12,
      "value": 45000.00,
      "average_time": 24,
      "conversion_to_next": 66.7
    },
    "Qualificação": {
      "count": 8,
      "value": 32000.00,
      "average_time": 48,
      "conversion_to_next": 62.5
    },
    "Proposta": {
      "count": 5,
      "value": 28000.00,
      "average_time": 120,
      "conversion_to_next": 60.0
    },
    "Fechado": {
      "count": 3,
      "value": 20000.00,
      "average_time": 0
    }
  },
  "win_rate": 15.5,
  "loss_rate": 8.9,
  "average_deal_cycle": 192
}

// Node.js
const axios = require('axios');

const API_URL = 'https://chat.seudominio.com/api/v1';
const TOKEN = 'SEU_TOKEN';

async function createFunnelWithStages() {
  const response = await axios.post(
    `${API_URL}/accounts/1/funnels`,
    {
      name: 'Pipeline de Vendas 2025',
      description: 'Funil principal para vendas',
      stages: [
        {
          name: 'Novo Lead',
          order: 0,
          color: '#3B82F6'
        },
        {
          name: 'Qualificação',
          order: 1,
          color: '#8B5CF6'
        },
        {
          name: 'Demo',
          order: 2,
          color: '#EC4899'
        },
        {
          name: 'Proposta',
          order: 3,
          color: '#F59E0B'
        },
        {
          name: 'Negociação',
          order: 4,
          color: '#F97316'
        },
        {
          name: 'Fechado',
          order: 5,
          color: '#10B981'
        },
        {
          name: 'Perdido',
          order: 6,
          color: '#EF4444'
        }
      ]
    },
    {
      headers: {
        'api_access_token': TOKEN,
        'Content-Type': 'application/json'
      }
    }
  );
  
  return response.data;
}

# Python
import requests

API_URL = 'https://chat.seudominio.com/api/v1'
TOKEN = 'SEU_TOKEN'

def move_conversations_to_stage(funnel_id, conversation_ids, stage_name):
    headers = {
        'api_access_token': TOKEN,
        'Content-Type': 'application/json'
    }
    
    results = []
    for conv_id in conversation_ids:
        response = requests.post(
            f'{API_URL}/accounts/1/funnels/{funnel_id}/kanban/move_conversation',
            json={
                'conversation_id': conv_id,
                'stage_name': stage_name
            },
            headers=headers
        )
        results.append(response.json())
    
    return results

# Mover conversas 123, 124, 125 para "Proposta"
move_conversations_to_stage(1, [123, 124, 125], 'Proposta')

{
  "error": "Funnel not found"
}

{
  "error": "Stage 'XYZ' does not exist in this funnel"
}

{
  "error": "Conversation is already in a funnel"
}