Всё для работы и интеграции

{
  "name": "Горячий лид → квалификация",
  "enabled": true,
  "triggerType": "contact.updated",
  "conditionTree": {
    "match": "all",
    "conditions": [
      { "field": "attributes.lead_score", "operator": "gte", "value": 80 }
    ]
  },
  "actions": [
    { "type": "add_tag", "tag": "Горячий" },
    { "type": "move_deal", "stage": "qualification" },
    { "type": "create_task", "title": "Связаться в течение 15 минут", "dueMinutes": 15 }
  ],
  "maxDepth": 5
}

POST https://crm.example.ru/api/v1/events
Authorization: Bearer <service-token>
X-Service-Token: <service-token>
X-Workspace-Id: ws_demo
Idempotency-Key: telegram:482991204
Content-Type: application/json

{
  "event_id": "telegram:482991204",
  "schema_version": "1.0",
  "occurred_at": "2026-08-23T10:15:00.000Z",
  "workspace_id": "ws_demo",
  "bot_id": "sales_assistant",
  "channel": "telegram",
  "external_chat_id": "84120931",
  "external_user_id": "84120931",
  "type": "message.received",
  "message": {
    "external_id": "502",
    "text": "Хочу узнать стоимость"
  },
  "profile": {
    "name": "Анна",
    "city": "Москва",
    "avatar_file_id": "telegram-file-id"
  },
  "attributes": {
    "intent": "pricing",
    "lead_score": 70
  }
}

{
  "duplicate": false,
  "contactId": "a60d55b4-...",
  "conversationId": "55c3df22-...",
  "deliverToBot": true
}

POST /api/v1/messages/send
X-Workspace-Id: ws_demo
X-Service-Token: <service-token>
Idempotency-Key: reply:telegram:502
Content-Type: application/json

{
  "conversationId": "55c3df22-...",
  "actor": "bot",
  "text": "Тариф Pro стоит 4 900 ₽ в месяц"
}

# 1. Зарезервировать загрузку
POST /api/v1/media/uploads
{
  "filename": "proposal.pdf",
  "mimeType": "application/pdf",
  "size": 184230
}

# 2. Загрузить байты по выданному uploadUrl
PUT <uploadUrl>
Content-Type: application/pdf

<binary body>

# 3. Подтвердить загрузку
POST /api/v1/media/uploads/<uploadId>/complete

# 4. Передать uploadId при отправке
POST /api/v1/messages/send
{
  "conversationId": "...",
  "actor": "bot",
  "text": "Отправляю предложение",
  "attachmentIds": ["<uploadId>"]
}

GET /api/v1/conversations/{conversationId}/control

PATCH /api/v1/conversations/{conversationId}/control
Content-Type: application/json

{
  "mode": "HUMAN",
  "expectedVersion": 7,
  "reason": "operator_claim"
}

import { verifyBotCrmWebhook } from "@botcrm/sdk";

app.post("/botcrm-events", express.raw({ type: "application/json" }), (req, res) => {
  const signature = req.header("x-botcrm-signature");
  if (!verifyBotCrmWebhook(req.body, signature, process.env.BOTCRM_WEBHOOK_SECRET!)) {
    return res.status(401).send("invalid signature");
  }

  const event = JSON.parse(req.body.toString("utf8"));
  // Сначала быстро подтвердите приём, тяжёлую работу отправьте в очередь.
  res.status(202).json({ accepted: true, eventId: event.event_id });
});