Интеграции и внешние кабинеты

API, webhooks и разработка модулей

Персональные API-токены, scopes, публичный API, idempotency, optimistic locking, webhooks, MCP-коннектор для Claude и ChatGPT и marketplace-расширения.

Открыть раздел в Taska

Для чего нужен

  • Безопасно читать и изменять данные извне.
  • Получать события Taska в реальном времени.
  • Создавать частные и публичные продуктовые расширения.
Когда использовать: Для интеграции с сайтом, 1С, BI, телефонией, собственной системой или marketplace-приложением.

Кто работает

  • Администратор выпускает токен.
  • Разработчик интегрирует.
  • Владелец данных утверждает scopes.
  • Партнёр публикует приложение после проверки.

Порядок работы

  1. 1

    Определите сценарий

    Сущности, операции, частота и направление данных.

  2. 2

    Создайте токен

    «Настройки → Платформа → Для разработчиков → API-токены»: понятное имя, минимальные scopes и срок — 30 дней, 90 дней, год или бессрочно. Создание подтверждается паролем, при включённой 2FA — кодом.

  3. 3

    Используйте контекст

    Tenant определяется доменом или публичным tenant token; организация передаётся безопасным контекстом.

  4. 4

    Защитите записи

    Idempotency-Key для повторов, If-Match для конкурентных изменений.

  5. 5

    Подпишите webhooks

    Вкладка «Webhooks»: URL, события и secret для HMAC-подписи. Проверяйте secret/signature, timestamp и event id.

  6. 6

    Подключите ИИ-клиент

    В claude.ai или ChatGPT: Settings → Connectors → Add custom connector → адрес https://<домен компании>/api/mcp → «Подключить» → вход в Taska → отметить разделы → «Разрешить». Claude Code, Codex и Cursor подключаются с API-токеном.

  7. 7

    Наблюдайте

    Логи доставки, retry, dead-letter queue и аудит.

Возможности

  • Scoped tokens.
  • REST API.
  • Idempotency.
  • Optimistic locking.
  • Signed webhooks.
  • Rate limits.
  • MCP-коннектор для Claude, ChatGPT, Cursor и Codex.
  • Marketplace manifests.
  • Tenant isolation.

Связи с другими модулями

  • Все модули выставляют разрешённые сущности.
  • Domain events питают webhooks.
  • Audit фиксирует мутации.
  • Marketplace управляет установкой.

Что происходит дальше

  • Токен показывается один раз.
  • Webhook получает подписанные события.
  • Ошибки ретраятся и попадают в DLQ после лимита.

Пример: Форма сайта

Лендинг должен создавать заявки.

  1. Администратор создаёт отдельное подключение формы.
  2. Получает публичный ключ и endpoint.
  3. Маппит поля и воронку.
  4. Сайт отправляет idempotent запрос.
  5. Taska создаёт заявку с UTM и уведомляет ответственного.
Результат: Лиды поступают без общего административного токена и без дублей.

Проверка перед запуском

  • Scopes минимальны.
  • Секрет не попал в frontend.
  • Webhook fail-closed.
  • Повторы идемпотентны.
  • Tenant и organization scope проверены.
  • Технические ошибки преобразуются в понятные сообщения.

Частые вопросы

Можно использовать один токен для всех клиентов?

Нет. Токены и подключения изолируются по тенанту и назначению.

Как подключить Taska к Claude или ChatGPT?

Добавьте свой коннектор с адресом https://<домен компании>/api/mcp и нажмите «Подключить»: Taska попросит войти и отметить разделы, к которым ИИ получит доступ. Права ИИ не шире прав вашей роли. Подключение можно отозвать.

Следующие материалы

Интеграции и каналы связиРоли, права и безопасностьКлиентские кабинеты и витриныАналитика, отчёты и маркетинговая атрибуция