Задать вопрос

Напишите вопрос и оставьте контакты для ответа.

Задать вопрос
Возможность Chat2Desk

Открытое API: интеграции, свои сценарии, свой BI

REST API с полным доступом к сообщениям, диалогам, контактам, тегам, шаблонам и рассылкам. Webhooks на события. Готовые SDK для PHP, Python, Node.js. Разработчикам не нужно ждать доработок вендора.

Задать вопрос
Основные эндпоинты

Что доступно из коробки

Восемь основных ресурсов. Полная спецификация в OpenAPI, доступ к Swagger UI с песочницей.

POST
/v1/messages
Отправить сообщение клиенту в любой подключённый канал
GET
/v1/messages
Получить историю сообщений с фильтрами по клиенту и каналу
GET
/v1/dialogs
Список диалогов, статусы, ответственные, теги
GET
/v1/clients
База контактов с полями и историей
PUT
/v1/clients/{id}/tags
Проставить или снять теги для сегментации
POST
/v1/broadcasts
Создать рассылку по сегменту с HSM-шаблоном
GET
/v1/reports/sla
Метрики SLA за период, детализация по операторам
POST
/v1/webhooks
Подписка на события: входящее, ответ оператора, изменение статуса
Что можно собрать

Четыре типовых сценария интеграции

Каждый решаем через API без доработок на стороне Chat2Desk.

Свой виджет чата

Свой дизайн, свой UX, собственная логика. Данные и очередь идут через Chat2Desk API.

RESTWebSocket

Отчёты в вашу BI

Данные Chat2Desk в вашей Power BI или Yandex DataLens вместе с другими источниками.

RESTWebhooks

Свой бот на своей платформе

Логика бота у вас, Chat2Desk используется только как канал доставки в мессенджер.

RESTWebhooks

Синхронизация базы клиентов

Единая база в вашей CRM, теги и сегменты автоматически приезжают в Chat2Desk.

RESTBatch
Технические детали

Авторизация, лимиты, документация

Инженерная гигиена: понятная авторизация, честные лимиты, живая документация.

Авторизация и безопасность

  • Token-based. Выдаётся в личном кабинете, ротируется по запросу.
  • Права по scope. Разные токены для чтения, отправки, админки.
  • Все запросы через HTTPS, TLS 1.2+
  • IP whitelist опционально. Токен работает только с указанных адресов.
  • Аудит-лог всех вызовов API за 90 дней в личном кабинете.

Лимиты и документация

  • Rate limits по тарифу. Стандартно 60 rpm на токен, поднимается по запросу.
  • OpenAPI 3.0 спецификация, актуальная на прод.
  • Swagger UI с песочницей на тестовом окружении.
  • SDK для PHP, Python, Node.js в открытом репо.
  • Отдельный sandbox без списания за сообщения.
Частые вопросы

Вопросы, которые обычно задают

Доступ к API включён по умолчанию?
На большинстве тарифов — да. На минимальном есть базовый доступ на чтение. Полный доступ с webhooks и рассылками включается на бизнес-тарифах. Уточним под ваш случай на консультации.
Есть ли песочница для разработки?
Да. Тестовое окружение с эмуляцией отправки сообщений, без списаний. Своя учётка, свои токены. Отдельный домен API.
Что с обратной совместимостью при обновлениях?
API версионируется в URL: /v1/, /v2/. Ломающие изменения выходят только в новых версиях. Старая версия поддерживается минимум 12 месяцев после релиза новой.
Какие форматы ответов?
JSON по умолчанию. Пагинация по стандарту cursor-based или offset-based на выбор. Ошибки в стандартном формате с кодом и описанием.
Webhooks куда и как приходят?
На ваш HTTPS-эндпоинт POST-запросом с JSON-нагрузкой и подписью. Подпись проверяете HMAC-SHA256 с секретом из личного кабинета. Retry с backoff, если ваш эндпоинт не отвечает.
Готовые SDK на каких языках есть?
Открытые SDK для PHP, Python, Node.js в GitHub. C# и Go — на стадии сообщества. Для остальных языков — прямое обращение к REST, спецификация есть.

Обсудить интеграцию через API

Оставьте контакты. Свяжем с техническим менеджером, дадим доступ к песочнице, обсудим ваш сценарий.

  • Доступ к sandbox и документации
  • Консультация технического менеджера
  • Помощь с проектированием интеграции
Blank Form (#3)