Перейти к содержимому
WbizTool

Отправка сообщений WhatsApp через cURL

Попробуйте WhatsApp API от WbizTool в терминале, прежде чем писать код. Каждая команда ниже – это один POST на https://wbiztool.com/api/v1/, а сообщение уходит с вашего собственного номера, привязанного как WhatsApp Web.

Начать бесплатно

Бесплатный пробный период: 50 сообщений за любые 30 дней, без карты.

Как это работает

  1. Получите API-ключ и привяжите номер

    Зарегистрируйтесь, затем привяжите номер WhatsApp на странице «Номера WhatsApp» по QR-коду или коду привязки, как WhatsApp Web. В разделе «Настройки → API-ключи» создайте ключ и скопируйте свой Client ID (где их найти, показано в руководстве по API-ключам ниже). ID на карточке номера (например, ID 678) – это ваш whatsapp_client.

  2. Проверьте учётные данные

    Отправьте POST с client_id и api_key на /api/v1/me/. "status": 1 с "message": "Okay" означает, что они работают. Этот запрос ничего не отправляет и не расходует сообщения.

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

    Отправьте POST на /api/v1/send_msg/ с номером телефона и текстом. Ответ с "status": 1 и msg_id означает, что сообщение поставлено в очередь на вашем номере.

  4. Проверьте, что оно ушло

    Отправьте POST на /api/v1/message/status/<msg_id>/. Статус 1 означает Sent (отправлено); статус 2 – Failed (ошибка), причина – в error.

Примеры кода: cURL

Проверка учётных данных
curl -X POST https://wbiztool.com/api/v1/me/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678
  }'
Отправка текста
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 0,
    "country_code": "91",
    "phone": "9876543210",
    "msg": "Hi Aman, your order #4821 has shipped and will arrive on Thursday."
  }'
Ответ
{"status": 1, "message": "Created", "msg_id": 9817263}
Отправка изображения по URL
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 1,
    "country_code": "91",
    "phone": "9876543210",
    "img_url": "https://example.com/offers/diwali-sale.jpg",
    "msg": "Our Diwali sale starts today 🎉"
  }'
Отправка PDF по URL
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 2,
    "country_code": "91",
    "phone": "9876543210",
    "file_url": "https://example.com/invoices/invoice-4821.pdf",
    "file_name": "invoice-4821.pdf",
    "msg": "Your invoice for order #4821 is attached."
  }'
Загрузка файла с компьютера
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -F client_id=12345 \
  -F api_key=YOUR_API_KEY \
  -F whatsapp_client=678 \
  -F msg_type=2 \
  -F country_code=91 \
  -F phone=9876543210 \
  -F "msg=Your invoice for order #4821 is attached." \
  -F file_name=invoice-4821.pdf \
  -F file=@./invoice-4821.pdf
Планирование сообщения
curl -X POST https://wbiztool.com/api/v1/schedule_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 0,
    "country_code": "91",
    "phone": "9876543210",
    "msg": "Hi Aman, a reminder that your appointment is today at 11:30 AM.",
    "date": "24/12/2026",
    "time": "09:00",
    "timezone": "Asia/Kolkata"
  }'
Проверка статуса сообщения
curl -X POST https://wbiztool.com/api/v1/message/status/9817263/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY"
  }'

Что можно делать

  • JSON или поля формы

    Отправляйте тело как JSON, как поля формы или как multipart form data (-F), когда загружаете файл. Примеры работают как есть, когда вы подставите свои ID и ключ.

  • Изображения и файлы

    msg_type 1 отправляет изображение из img_url, msg_type 2 – файл из file_url. Файлы по ссылке – до 100 МБ, и ссылка должна быть публичной.

  • Планирование с часовым поясом

    schedule_msg принимает date (дд/мм/гггг), time (ЧЧ:ММ) и в timezone название часового пояса, например America/New_York, или сокращение, например IST или EST.

  • Вебхуки для каждого статуса

    Добавьте "webhook": "https://…", и WbizTool будет отправлять на него POST с msg_id и SENT, FAILED, CANCELLED или EXPIRED, когда статус сообщения меняется.

  • Те же запросы из любого инструмента

    Make, Pabbly Connect и другие инструменты автоматизации отправляют эти же запросы своим модулем HTTP. В документации также есть коллекция Postman.

Полезно знать

  • "status": 1 означает, что сообщение в очереди, а не доставлено. «Отправлено» – конечное успешное состояние; API не сообщает, доставлено ли сообщение и прочитано ли оно.
  • Внутри JSON пишите перенос строки в msg как \n. Настоящий перенос строки или лишняя запятая в конце делают JSON недопустимым.
  • Запланированное время в прошлом принимается, и сообщение уходит сразу. Дата пишется начиная с дня (24/12/2026), поэтому проверяйте её перед отправкой.
  • Ошибки отправки сообщения приходят с HTTP 400 (429 при дневном лимите); ошибки планирования обычно приходят с HTTP 200 и "status": 0, поэтому всегда декодируйте тело ответа и проверяйте status.
  • Отправка в группу WhatsApp через API (group_name вместо phone) работает на любом тарифе, включая пробный период.
  • В пробном периоде – 50 сообщений за любые 30 дней и 1 номер, без карты. На платных тарифах – от $25 в месяц в США (ваша цена – на странице «Цены») – сообщения безлимитные в рамках честного использования: до 1 000 в день с одного номера.
  • Сообщения уходят с вашего собственного номера WhatsApp, поэтому действуют правила самого WhatsApp: пишите тем, кто ждёт ваших сообщений.

Вопросы и ответы

Какой эндпоинт WhatsApp API отправляет сообщение?
POST https://wbiztool.com/api/v1/send_msg/ с client_id, api_key, whatsapp_client, phone (плюс country_code, если в номере его нет) и msg. Ответ содержит status и, при успехе, msg_id.
Как запланировать сообщение WhatsApp через cURL?
Отправьте POST на https://wbiztool.com/api/v1/schedule_msg/ с теми же полями плюс date (дд/мм/гггг), time (ЧЧ:ММ) и timezone. msg_id из ответа позволяет потом проверить или отменить сообщение.
Как узнать, что сообщение отправлено?
Ответ с "status": 1 и msg_id означает, что оно в очереди. Передайте URL в webhook, чтобы получить POST с SENT, FAILED, CANCELLED или EXPIRED, или вызовите эндпоинт статуса сообщения с msg_id. «Отправлено» – конечное состояние: API не сообщает о доставке или прочтении.
В каком формате указывать номер телефона?
Передайте номер с кодом страны (79161234567) или без него (9161234567) вместе с country_code (7). Пробелы, +, дефисы и скобки удаляются автоматически, поэтому +7 (916) 123-45-67 тоже подойдёт.
Нужны ли WhatsApp Business API или одобрение Meta?
Нет. WbizTool отправляет с вашего собственного номера WhatsApp или WhatsApp Business, привязанного как WhatsApp Web. Одобрение Meta не нужно, и согласовывать шаблоны сообщений тоже не надо.
Есть ли плата за каждое сообщение?
Нет. Пробный период включает 50 сообщений за любые 30 дней. На платных тарифах сообщения безлимитные в рамках честного использования, до 1 000 в день с одного номера: Lite – $25, Standard – $59 и Advanced – $149 в месяц в США; на странице «Цены» показана цена для вашей страны.

Читайте руководства

Смотрите также

Отправьте своё первое автоматическое сообщение в WhatsApp уже сегодня

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

Начать бесплатно

Платные тарифы – от $25 в месяц в США. Цены