Руководство по интеграции API

Подключите свою CRM, систему бронирования или любое приложение для отправки сообщений WhatsApp через наш простой API.

Начните за 5 простых шагов

1

Скачайте настольное приложение

Скачайте и установите All-in-One Messenger Hub на свой компьютер с Windows.

2

Подключите свой WhatsApp

Добавьте свой аккаунт WhatsApp в приложение, отсканировав QR-код.

3

Создайте Session API

Перейдите на вкладку WhatsApp и создайте новый Session API. Привяжите его к своему каналу WhatsApp.

4

Скопируйте свой API ключ

Скопируйте сгенерированный API ключ. Храните его в безопасности - это ваша аутентификация.

5

Начните отправлять сообщения

Используйте API из своего приложения. Держите настольное приложение запущенным для доставки сообщений.

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

Все конечные точки API требуют аутентификации через ваш API ключ. Вы можете передать ключ любым из этих способов:

Метод Пример
Заголовок X-API-Key (рекомендуется) X-API-Key: your-api-key
Параметр запроса/тела key=your-api-key
Альтернативный параметр api_key=your-api-key
POST

Отправить сообщение

Отправьте сообщение WhatsApp на номер телефона или в группу. Сообщения ставятся в очередь и доставляются, когда настольное приложение запущено.

POST https://onemessengerhub.com/api/whatsapp-session/send

Параметры

Параметр Тип Обязательно Описание
key string Да Ваш API ключ из настольного приложения
mobile string Условно Номер телефона с кодом страны (обязательно без group_id)
group_id string Условно Идентификатор группы WhatsApp (обязательно без mobile). Суффикс @g.us добавляется автоматически.
message string Да Текст сообщения (макс. 4096 символов)

Пример запроса

curl -X POST https://onemessengerhub.com/api/whatsapp-session/send \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mobile": "1234567890", "message": "Hello!"}'

Простой GET-запрос (браузер или ссылка)

https://onemessengerhub.com/api/whatsapp-session/send?key=YOUR_API_KEY&mobile=1234567890&message=Hello!

Успешный ответ (201)

{
  "success": true,
  "message": "Message queued successfully",
  "data": {
    "message_id": 123,
    "recipient": "1234567890",
    "status": "pending"
  }
}
POST

Сохранить контакт

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

POST https://onemessengerhub.com/api/whatsapp-session/save-contact

Параметры

Параметр Тип Обязательно Описание
key string Да Ваш API ключ из настольного приложения
contact_id string Да Номер телефона контакта или WhatsApp ID (макс. 50 символов). Суффикс @c.us добавляется автоматически.
name string Да Отображаемое имя для контакта (макс. 255 символов)

Пример запроса

curl -X POST https://onemessengerhub.com/api/whatsapp-session/save-contact \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contact_id": "1234567890", "name": "John Doe"}'

Успешный ответ (201)

{
  "success": true,
  "message": "Contact save operation queued",
  "data": {
    "operation_id": 456,
    "contact_id": "[email protected]",
    "status": "pending"
  }
}
POST

Удалить контакт

Удалите контакт из своего WhatsApp. Операция ставится в очередь и обрабатывается настольным приложением.

POST https://onemessengerhub.com/api/whatsapp-session/remove-contact

Параметры

Параметр Тип Обязательно Описание
key string Да Ваш API ключ из настольного приложения
contact_id string Да Номер телефона контакта или WhatsApp ID (макс. 50 символов). Суффикс @c.us добавляется автоматически.

Пример запроса

curl -X POST https://onemessengerhub.com/api/whatsapp-session/remove-contact \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contact_id": "1234567890"}'

Успешный ответ (201)

{
  "success": true,
  "message": "Contact remove operation queued",
  "data": {
    "operation_id": 789,
    "contact_id": "[email protected]",
    "status": "pending"
  }
}

Обработка ошибок

API использует стандартные коды состояния HTTP. Вот распространённые ответы с ошибками:

Ошибка аутентификации (401)

{
  "success": false,
  "message": "Invalid or inactive API key"
}

Ошибка проверки (422)

{
  "success": false,
  "message": "Validation failed",
  "errors": {
    "mobile": ["The mobile field is required when group id is not present."],
    "message": ["The message field is required."]
  }
}

Что вы можете создать

Интеграция с CRM

Отправляйте последующие сообщения, напоминания и обновления прямо из своей CRM системы.

Подтверждения бронирования

Автоматически отправляйте клиентам подтверждения записи и напоминания.

Уведомления о заказах

Уведомляйте клиентов о статусе заказа, обновлениях доставки и информации о доставке.

Системы оповещений

Отправляйте важные оповещения и уведомления своей команде или клиентам.

Маркетинговые кампании

Отправляйте рекламные сообщения и обновления своему списку контактов.

Настраиваемые рабочие процессы

Интегрируйте с Zapier, Make, n8n или любой платформой автоматизации.

Скоро появятся новые API

Мы расширяем наши предложения API, чтобы охватить больше платформ и сценариев использования.

Скоро

API чат-бота

Запускайте ответы чат-бота и управляйте разговорами программно.

Скоро

API контактов

Получайте доступ к контактам своих мессенджеров и управляйте ими на разных платформах.

Скоро

Веб-хуки

Получайте уведомления в реальном времени, когда сообщения получены или отправлены.