Руководство по интеграции API
Подключите свою CRM, систему бронирования или любое приложение для отправки сообщений WhatsApp через наш простой API.
Начните за 5 простых шагов
Скачайте настольное приложение
Скачайте и установите All-in-One Messenger Hub на свой компьютер с Windows.
Подключите свой WhatsApp
Добавьте свой аккаунт WhatsApp в приложение, отсканировав QR-код.
Создайте Session API
Перейдите на вкладку WhatsApp и создайте новый Session API. Привяжите его к своему каналу WhatsApp.
Скопируйте свой API ключ
Скопируйте сгенерированный API ключ. Храните его в безопасности - это ваша аутентификация.
Начните отправлять сообщения
Используйте API из своего приложения. Держите настольное приложение запущенным для доставки сообщений.
Аутентификация
Все конечные точки API требуют аутентификации через ваш API ключ. Вы можете передать ключ любым из этих способов:
| Метод | Пример |
|---|---|
| Заголовок X-API-Key (рекомендуется) | X-API-Key: your-api-key |
| Параметр запроса/тела | key=your-api-key |
| Альтернативный параметр | api_key=your-api-key |
Отправить сообщение
Отправьте сообщение 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"
}
}
Сохранить контакт
Сохраните или переименуйте контакт в своём 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"
}
}
Удалить контакт
Удалите контакт из своего 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 контактов
Получайте доступ к контактам своих мессенджеров и управляйте ими на разных платформах.
Веб-хуки
Получайте уведомления в реальном времени, когда сообщения получены или отправлены.
All-in-One Messenger Hub