Сегодня для бизнеса важна не только скорость общения с клиентами, но и возможность автоматизировать процессы. Используя API, компании могут централизовать коммуникацию, снизить нагрузку на операторов и повысить конверсию. Сервис WAMM.chat предлагает единый API для подключенных к сервису мессенджеров WhatsApp, Telegram Personal, MAX Personal, что открывает широкие возможности интеграции с CRM, сайтами и корпоративными системами.
API для мессенджеров от WAMM.chat — это единый унифицированный интерфейс, позволяющий работать сразу с несколькими каналами: WhatsApp, Telegram и MAX. Через API можно: отправлять и получать сообщения, статусы доставки и прочтения; управлять контактами и чатами; прикреплять файлы и изображения и многое другое. Пример: интернет-магазин через API отправляет клиенту подтверждение заказа в WhatsApp, напоминает о доставке через Telegram и делает рекламную рассылку в MAX. Всё это — в одной системе.
Для каждого канала связи, поддерживающего API, в разделе Настройки > Управление > API можно создать Token API, который используется для отправки запросов. Также можно указать публичный URL вашей системы - Webhook URL, который будет принимать и обрабатывать сообщения из мессенджеров, без дополнительных запросов к API. Все входящие сообщения будут отправляться на ваш сервер в реальном времени.
API для мессенджеров
API доступен для следующих мессенджеров: WhatsApp, MAX Personal, Telegram Personal, Telegram Bot.
Адресация запросов
Все запросы к 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
- Отправка сообщений
- Отправка файлов по URL (публичный файл)
- Отправка файлов в формате BASE64 (локальный файл)
- Редактирование сообщений
- Получение сообщений
- Получение сообщений по номеру телефона
- Получение сообщений через WebHook
- Получение списка каналов связи
- Получение списка пользователей
- Получение статуса сообщения
- Проверить наличие аккаунта в мессенджере
- Получение открытых чатов пользователя
- Добавление и обновление контактов
- Ответственный за чат, установка
- Получение инфо о контакте (чате)
- Удаление контактов
- Установка статуса чата - завершен
- Установка статуса чата - открыт
- Теги для чата - добавить
- Теги для чата - удалить
Если вам необходимы дополнительные методы API и данные для более полной интеграции - напишите нам в Поддержку и мы добавим их!
Документация API доступна также на портале ReadMe.io (https://wammchat.readme.io)
Важно: API обслуживается группой серверов с IP-адресами: 31.135.9.55, 91.240.84.65, 82.146.53.0, 82.146.53.215, 185.43.5.73, 45.130.42.197, 45.147.177.18. Вы можете настроить фильтрацию по этим IP-адресам для обеспечения дополнительной безопасности.