AISARAISAR
REST API

Воронки

Воронки продаж и их стадии — структура канбан-доски, по которой перемещаются сделки. Стадии создаются и обновляются вместе с воронкой одним запросом. Доска воронки (`/board`) отдаёт первую страницу сделок по каждой стадии; для дозагрузки конкретной колонки используйте постраничный эндпоинт стадии.

Эндпоинты

МетодПуть
GET/v1/funnels

Список воронок компании

POST/v1/funnels

Создание воронки (со стадиями)

POST/v1/funnels/{funnel}

Обновление воронки

DELETE/v1/funnels/{funnel}

Удаление воронки

GET/v1/funnels/{funnel}/board

Kanban-доска воронки со сделками по стадиям

GET/v1/funnels/{funnel}/stages/{stage}/deals

Постраничная загрузка сделок конкретной стадии

Примеры

Создание воронки со стадиями

Запрос

bash
curl -X POST https://api.aisar.app/v1/funnels \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sales",
    "description": "Primary sales pipeline",
    "status": "active",
    "stages": [
      { "name": "Lead", "type": "new", "color": "#3B82F6", "order": 1 },
      { "name": "Negotiation", "type": "in_progress", "color": "#F59E0B", "order": 2 },
      { "name": "Won", "type": "success", "color": "#22C55E", "order": 3 }
    ]
  }'

Ответ

json
{
  "data": {
    "message": "Funnel created.",
    "funnel": {
      "id": 1,
      "company_id": 1,
      "name": "Sales",
      "slug": "sales",
      "description": "Primary sales pipeline",
      "steps": 3,
      "updated_at": "2026-03-15T10:00:00.000000Z",
      "stages": [
        { "id": 1, "funnel_id": 1, "name": "Lead", "type": "new", "order": 1, "color": "#3B82F6", "stale_after_days": null, "wip_limit": null },
        { "id": 2, "funnel_id": 1, "name": "Negotiation", "type": "in_progress", "order": 2, "color": "#F59E0B", "stale_after_days": null, "wip_limit": null },
        { "id": 3, "funnel_id": 1, "name": "Won", "type": "success", "order": 3, "color": "#22C55E", "stale_after_days": null, "wip_limit": null }
      ]
    }
  }
}

Kanban-доска воронки

Запрос

bash
curl https://api.aisar.app/v1/funnels/1/board \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Ответ

json
{
  "data": {
    "funnel": { "id": 1, "name": "Sales" },
    "stages": [
      {
        "id": 1,
        "name": "Lead",
        "deals": [
          {
            "id": 501,
            "title": "Office renovation",
            "amount": "5000.00",
            "stage_changed_at": "2026-03-15T10:00:00.000000Z",
            "contact": { "id": 123, "display_name": "Aigerim Bekova" },
            "responsible_user": { "id": 5, "name": "Aidos" },
            "conversations_count": 2
          }
        ]
      }
    ]
  }
}