Описание API, интеграция мессенджеров MAX, Telegram, WhatsApp

Сегодня для бизнеса важна не только скорость общения с клиентами, но и возможность автоматизировать процессы. Используя API, компании могут централизовать коммуникацию, снизить нагрузку на операторов и повысить конверсию. Сервис WAMM.chat предлагает единый API для подключенных к сервису мессенджеров WhatsApp, Telegram, MAX, что открывает широкие возможности интеграции с CRM, сайтами и корпоративными системами.

Наше API для интеграции мессенджеров в SaaS продукт разработано специально для того, чтобы разработчики могли быстро внедрять функции общения в свои платформы. Ключевым преимуществом является возможность организовать прямое получение и отправку сообщений с личного аккаунта (MAX, WhatsApp или Telegram Personal), так и Bot. Это позволяет бизнесу сохранять «человеческое лицо» в переписке, избегая строгих ограничений официальных ботов и повышая лояльность клиентов за счет привычного формата общения.

API для мессенджеров от WAMM.chat — это единый унифицированный интерфейс, позволяющий работать сразу с несколькими каналами: WhatsApp, Telegram и MAX. Через API можно: отправлять и получать сообщения, статусы доставки и прочтения; управлять контактами и чатами; прикреплять файлы и изображения и многое другое. Пример: интернет-магазин через API отправляет клиенту подтверждение заказа в WhatsApp, напоминает о доставке через Telegram и делает рекламную рассылку в MAX. Всё это — в одной системе.

Для каждого канала связи, поддерживающего API, в разделе Настройки > Управление > API можно создать Token API, который используется для отправки запросов. Также можно указать публичный URL вашей системы — Webhook URL, который будет принимать и обрабатывать сообщения из мессенджеров, статусы без дополнительных запросов к API. Все входящие сообщения будут отправляться на ваш сервер в реальном времени.

API для мессенджеров

API доступен для следующих мессенджеров: WhatsApp, MAX, Telegram.

Данная документация представляет собой доступный справочник, в котором собраны все необходимые инструменты для работы со всеми мессенджерами через единый интерфейс. Это подробное руководство поможет вам быстро настроить методы автоматизации: от простой отправки текста до управления сложными цепочками диалогов, обеспечивая стабильную связь вашего сервиса с внешним миром.

Адресация запросов

Все запросы к API следует направлять на базовый URL:

https://wamm.chat/api2/

Результаты запросов и сообщения на WebHook URL возвращаются в формате JSON.

{"err":0,"msg_id":1хххххх}

Аутентификация

Для работы с API используется токен — уникальный ключ, который передаётся в запросе.

Пример URL с токеном:

https://wamm.chat/api2/msg_to/ВАШ_ТОКЕН/?phone=79001234567&text=Текст сообщения

Если токен недействителен или отсутствует, API вернет ошибку:

{"err":"token fail"}

Если канал не авторизован и не готов к отправке сообщений, API вернет ошибку:

{"err":"acc not authorized"}

В ином случае, если токен действителен и канал авторизован, запрос вернет запрашиваемые данные.

{"err":0, "msg_data":"..."}

Возможности, доступные методы API

Отправка

Каналы, пользователи, проверка номера

Получение сообщений и статусов

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

Рассылки

Контакты и управление чатами

Теги чатов

Справочно

Смайлы

Если вам необходимы дополнительные методы API и данные для более полной интеграции — напишите нам в Поддержку, и мы добавим их!

Важно: API обслуживается группой серверов с IP-адресами: 91.240.84.65, 188.127.243.197, 31.135.9.55, 82.146.53.215, 45.130.42.197. Вы можете настроить фильтрацию по этим IP-адресам для обеспечения дополнительной безопасности.

Интеграция API с мессенджерами