API и MCP всех продуктов TehProf: карта для разработчиков

Кратко

У каждого продукта TehProf.kz свой открытый интерфейс для разработчиков: Support — заявки, клиенты, контакты; Dialogs — сообщения WhatsApp; Booking — бронирования. Ключи создаёт администратор в кабинете своего продукта и видит один раз. Ниже — где что лежит.

Карта

ПродуктЧто даётАдрес APIКлючСобытия к вамДокументацияMCP
SupportЗаявки, сообщения, клиенты, контакты, справочник компанийhttps://support.tehprof.kz/api/mcp-internal.phpBearer-ключ: Настройки → Интеграции → REST API (с тарифа Starter)Исходящие вебхуки: ticket_created, status_changed, message_added (с тарифа Business)Интеграция с Support по API, OpenAPI https://support.tehprof.kz/api/openapi.jsonhttps://support.tehprof.kz/mcp
DialogsСообщения и файлы WhatsApp, статусы, шаблоны, линииhttps://dialogs.tehprof.kz/api/v1/gw/gw_…: Настройки → APImessage.created, message.updated, message.deleted, статусы доставки, шаблоныWhatsApp в любой CRM через API, OpenAPI https://dialogs.tehprof.kz/api/v1/gw/schema/Нет
BookingРесурсы, свободное время, брониhttps://booking.tehprof.kz/api/public/v1bk_live_…: Интеграции → Разработчик → Ключиreservation.created, reservation.updated, reservation.cancelledДокументация Booking API, OpenAPI https://booking.tehprof.kz/api/public/v1/openapi.jsonhttps://booking.tehprof.kz/mcp

События Dialogs и Booking подписаны HMAC; у Support подпись HMAC включается в настройках вебхука. Проверяйте подпись на своей стороне.

Что важно знать заранее

  • Звонки WhatsApp, записи и расшифровки в чужую CRM через API Dialogs сегодня отдаются по запросу — через менеджера TehProf.kz. В Битрикс24 и amoCRM они уже приходят в карточку.
  • Чтение каталога Booking (ресурсы, свободные слоты) работает без ключа по публичному адресу компании; создание брони без ключа требует согласия гостя на обработку данных.
  • Ключ — только на сервере. Не кладите его в браузер, в адрес страницы или в код сайта.
  • 1С. У Support есть готовое расширение для 1С — Интеграция с 1С. Подключение Dialogs к 1С идёт через программиста 1С и менеджера TehProf.kz.

Подключить ИИ-ассистента (MCP)

MCP — способ подключить Claude, ChatGPT и другие ИИ к сервису, чтобы работать с ним обычными словами.

  • Support: один адрес https://support.tehprof.kz/mcp, вход под своей учётной записью — Подключить своего ИИ (MCP). Справка, тарифы и помощник новичка — без входа по адресу https://support.tehprof.kz/mcp/public.
  • Booking: https://booking.tehprof.kz/mcp; без ключа — чтение каталога, с ключом bk_live_… — брони.

Для ботов и ИИ: как читать эту справку

Справка открыта. Поиск — GET https://support.tehprof.kz/api/help.php?action=search&q=<запрос>, статья целиком — ?action=article&slug=<раздел/статья>; краткий перечень для ИИ — https://support.tehprof.kz/llms.txt. Через MCP без входа (https://support.tehprof.kz/mcp/public) — инструменты knowledge_search и knowledge_read.

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

Какой API выбрать, чтобы получать WhatsApp в свою CRM?

API Dialogs — WhatsApp в любой CRM через API.

Мы хотим заводить заявки в Support из своей системы

Bearer-ключ Support и действия заявок — Интеграция с Support по API; входящий вебхук — Входящие вебхуки.

Можно ли встроить запись на сайт без программирования?

Да, у Booking есть готовый виджет и страница записи — TehProf Booking: запись и интеграции.

Связанные статьи

Нужна поддержка, которая так и работает?

TehProf.kz Support собирает обращения из WhatsApp, Telegram, почты и виджета в одну очередь, считает сроки по SLA и показывает, где служба проседает.