Интеграция WhatsApp с любой CRM через API TehProf Dialogs

Кратко

TehProf Dialogs подключается не только к Битрикс24 и amoCRM. Любая CRM, своя программа учёта или бот получает переписку WhatsApp через открытый API: входящие сообщения приходят на адрес вашей системы, ответы уходят одним запросом. Звонки, записи и расшифровки звонков через API сегодня отдаются по запросу — через менеджера TehProf.kz.

Для кого

• Компании, у которой своя CRM или CRM, для которой нет готового приложения (не Битрикс24 и не amoCRM).
• Разработчику CRM, который хочет дать своим клиентам WhatsApp внутри своей системы. Для него есть отдельная статья — Разработчикам CRM и интеграторам.
• Тем, кто строит бота или сценарий (например, в n8n) поверх WhatsApp.

Что передаётся через API сегодня

Важно про звонки: в Битрикс24 и amoCRM звонки уже приходят в карточку клиента — с записью, расшифровкой и кратким пересказом. Для другой CRM это делается отдельно, по запросу: опишите задачу менеджеру, и он скажет, что и в какой срок возможно.

Как подключить — пять шагов

1. Заведите аккаунт Dialogs и подключите номер. Регистрация — на главной странице Dialogs, кнопка «Создать аккаунт». Как подключить номер — в статье Dialogs: как подключить номер WhatsApp.
2. Создайте ключ. Владелец или администратор открывает в Dialogs Настройки → API, задаёт название, выбирает линии и права. Ключ вида gw_… показывается один раз — сразу сохраните его в своей системе. Отозвать ключ можно там же.
3. Узнайте свои линии. GET /channels/ вернёт номера и их channel_id.
4. Укажите адрес для событий. PUT /webhook/ с адресом вашей системы (https). В ответ придёт секрет для проверки подписи — каждое событие подписано заголовком X-Wahub-Signature-V2.
5. Отвечайте. POST /messages/ — текст, файл или шаблон.

Адрес API: https://dialogs.tehprof.kz/api/v1/gw/. Каждый запрос — с заголовком Authorization: Bearer gw_….

Права ключа

• channels:read — список линий;
• messages:read — история и итог отправки;
• messages:send — отправка сообщений и загрузка файлов;
• templates:read, templates:write — шаблоны;
• webhooks:manage — адрес событий, подписки, добор и повтор доставок.

Ключ видит только выбранные при создании линии. Для системы «только читать» выдайте ключ без прав на отправку.

События, которые приходят в вашу систему

• messages — новые сообщения: message.created, правка или готовый файл — message.updated, удаление у всех — message.deleted. Поле direction говорит, входящее оно или исходящее, source — откуда (клиент, Dialogs, телефон, CRM). Фильтруйте по ним, чтобы бот не отвечал сам себе.
• statuses — доставка ваших сообщений.
• templates — решения Meta по шаблонам (включается отдельно).

Если ваша система не ответила за 10 секунд, событие повторяется ещё 9 раз примерно за 27 часов. Пропущенное можно добрать по подписке. Подробности, примеры запросов и проверка подписи — в справке Dialogs, раздел про API, и в описании OpenAPI: его можно импортировать в Postman или генератор клиента.

Если своего программиста нет

Есть второй путь: TehProf.kz сам подключает WhatsApp через интерфейс для разработчиков вашей CRM. Нужна ли доработка и сколько она стоит, скажем на бесплатной проверке номера и вашей программы — до начала работ.

Что делает менеджер, а что — вы сами

• Сами: регистрация, ключ, адрес событий, отправка и приём сообщений — всё в кабинете Dialogs и по документации.
• Через менеджера: звонки, записи и расшифровки в вашей CRM; нестандартные сценарии; подбор способа подключения номера; счёт. Написать менеджеру — WhatsApp +7 705 382 91 47.

Цены

Подписка на линию зависит от способа подключения и состава (переписка, группы, звонки). Актуальные суммы — в разделе «Цена» на странице Dialogs. Вопросы о стоимости для особых объёмов и сценариев — к менеджеру.

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

Вы работаете с нашей CRM? У нас не Битрикс24 и не amoCRM

Да. Любая CRM подключается через API: сообщения, файлы и статусы приходят в неё событиями, ответы уходят из неё запросом. Звонки — по запросу через менеджера.

Нужен ли программист?

Для своей CRM — да: кто-то должен принять события и отправлять запросы. Для Битрикс24 и amoCRM программист не нужен — там готовые приложения: Dialogs в Битрикс24, amoCRM и 1С.

Где документация?

Открытое описание OpenAPI — https://dialogs.tehprof.kz/api/v1/gw/schema/ (для JSON добавьте ?format=json). Пошаговые примеры — в справке Dialogs, раздел про API.

Можно ли получать записи звонков в свою CRM?

Сейчас — по запросу через менеджера. Готовой открытой выдачи звонков для чужой CRM пока нет; в Битрикс24 и amoCRM звонки с записью уже приходят в карточку.

Может ли наш разработчик предлагать это своим клиентам?

Да, и на этом можно зарабатывать — см. Разработчикам CRM и интеграторам.

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

• TehProf Dialogs: звонки и переписка WhatsApp в CRM
• Разработчикам CRM и интеграторам
• API и MCP всех продуктов TehProf
• Dialogs в Битрикс24, amoCRM и 1С