Бесплатное WhatsApp API: подключитесь и начните общение сегодня!

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

Что такое WhatsApp API и зачем это нужно?

Автоматизация рассылок

Отправляйте массовые уведомления, акции и новости о заказах автоматически.

Организация поддержки

Создавайте чат-ботов и направляйте клиентов к свободным операторам для эффективной поддержки.

Персонализация общения

Отправляйте индивидуальные сообщения, основанные на данных о ваших клиентах.

Сбор обратной связи

Проводите опросы и анкетирования напрямую в WhatsApp для сбора ценных данных.

Как подключить WhatsApp API бесплатно?

Мы сделали процесс подключения максимально простым и прозрачным. Следуйте этим шагам:

1. Регистрация в сервисе

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

Зарегистрироваться
2. Получение API-ключа

В личном кабинете найдите ваш уникальный API-ключ (токен).

Получить ключ
3. Подключение номера WhatsApp

Сканируйте QR-код из личного кабинета, чтобы связать ваш номер.

Подключить номер

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

Все запросы к API требуют передачи ключа авторизации в заголовке:

Authorization: Bearer YOUR_API_KEY

Как получить API-ключ:

  1. Зайдите в Личный кабинет
  2. Перейдите в раздел "API Keys"
  3. Создайте новый ключ или используйте существующий
Получить API-ключ
Важно: Никому не передавайте ваш API-ключ. В случае утечки, немедленно отзовите его в личном кабинете.

Устройства

Получение списка устройств

Возвращает список всех подключенных WhatsApp устройств.

GET /api/v1/devices

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

$client = new \GuzzleHttp\Client();

$response = $client->get('https://api.portalmessage.com/api/v1/devices', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_KEY',
        'Accept' => 'application/json',
    ]
]);

$devices = json_decode($response->getBody(), true);
const response = await fetch('https://api.portalmessage.com/api/v1/devices', {
    method: 'GET',
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    }
});

const devices = await response.json();
curl -X GET \
  https://api.portalmessage.com/api/v1/devices \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'

Пример ответа:

{
    "success": true,
    "devices": [
        {
            "id": 123,
            "name": "Основной номер",
            "status": 1,
            "phone": "79123456789",
            "created_at": "2023-05-15T10:00:00Z"
        }
    ]
}

Сообщения

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

Отправляет сообщение через указанное WhatsApp устройство. Поддерживает несколько типов сообщений.

POST /api/v1/message/send

Параметры запроса:

Параметр Тип Обязательный Описание
device_id integer Да ID устройства из списка устройств
phone string Да Номер получателя в формате 79123456789
type string Да Тип сообщения: plain-text, text-with-media, text-with-button, audio
message string Нет Текст сообщения (для plain-text, text-with-media)
file_id integer Нет ID файла (для text-with-media, audio)
buttons array Нет Массив кнопок (для text-with-button)

Примеры запросов для разных типов:

{
    "device_id": 123,
    "phone": "79123456789",
    "type": "plain-text",
    "message": "Привет! Это тестовое сообщение."
}
{
    "device_id": 123,
    "phone": "79123456789",
    "type": "text-with-media",
    "file_id": 456,
    "message": "Посмотрите наше новое предложение!"
}
{
    "device_id": 123,
    "phone": "79123456789",
    "type": "text-with-button",
    "message": "Выберите действие:",
    "buttons": ["Заказать", "Узнать цену", "Отмена"]
}
{
    "device_id": 123,
    "phone": "79123456789",
    "type": "audio",
    "file_id": 789
}

Пример ответа:

{
    "success": true,
    "message": "Message sent successfully",
    "message_id": "wamid.XXXXXX"
}

Получение ответов

Возвращает входящие сообщения для указанного устройства.

GET /api/v1/replies?device_id=123

Параметры запроса:

device_id integer Да ID устройства

Пример ответа:

{
    "success": true,
    "messages": [
        {
            "id": "wamid.XXXXXX",
            "from": "79123456789",
            "text": "Привет, как дела?",
            "timestamp": "2023-05-20T14:30:00Z",
            "type": "text"
        }
    ]
}

Файлы

Получение списка файлов

Возвращает список всех загруженных файлов пользователя.

GET /api/v1/files

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

curl -X GET \
  https://api.portalmessage.com/api/v1/files \
  -H 'Authorization: Bearer YOUR_API_KEY'

Пример ответа:

{
    "success": true,
    "files": [
        {
            "id": 456,
            "name": "product.jpg",
            "type": "image/jpeg",
            "size": 245678,
            "url": "https://api.portalmessage.com/storage/user_files/1/product.jpg",
            "created_at": "2023-05-18T09:15:00Z"
        },
        {
            "id": 789,
            "name": "audio.mp3",
            "type": "audio/mpeg",
            "size": 3567890,
            "url": "https://api.portalmessage.com/storage/user_files/1/audio.mp3",
            "created_at": "2023-05-19T14:30:00Z"
        }
    ]
}

Загрузка файла

Загружает файл (изображение, аудио) для использования в сообщениях.

POST /api/v1/files

Параметры запроса:

file file Да Файл для загрузки (jpg, png, mp3)

Пример на JavaScript:

const formData = new FormData();
formData.append('file', fileInput.files[0]);

const response = await fetch('https://api.portalmessage.com/api/v1/files', {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
    },
    body: formData
});

const result = await response.json();

Пример ответа:

{
    "success": true,
    "file": {
        "id": 890,
        "name": "new_product.jpg",
        "type": "image/jpeg",
        "size": 345678,
        "url": "https://api.portalmessage.com/storage/user_files/1/new_product.jpg",
        "created_at": "2023-05-21T10:45:00Z"
    }
}

Ошибки API

Код Сообщение Решение
401 Unauthorized Проверьте API-ключ в заголовке Authorization
403 Device not available Устройство не активно или не принадлежит вам
404 File not found Указанный file_id не существует
429 Too many requests Превышен лимит запросов (60/минуту)

Готовы начать интеграцию?

Получите API-ключ прямо сейчас и подключите WhatsApp к вашей системе

Получить API-ключ