API WhatsApp по QR: отправить текст или медиа из своей системы

Своя CRM уже знает, кому писать. Ей не нужен человек, который копирует текст в WhatsApp. В Waziper для этого есть API ключ и четыре действия вокруг одного WA-аккаунта. Базовый адрес: https://waziper.ru/api/v1/whatsapp-unofficial. Авторизация — заголовок Authorization: Bearer с ключом из раздела «API и вебхуки».

Четыре запроса

1. GET /devices/{id} — статус и профиль номера. Имеет смысл звать перед отправкой: если сессия не онлайн, сообщение некуда класть.
2. POST /devices/{id}/connect — запуск или повторный вход. Если нужен QR, он вернётся в ответе.
3. POST /devices/{id}/messages — текст или медиа.
4. DELETE /devices/{id} — выйти и убрать сессию со шлюза.

Как выглядит отправка

Номер получателя передают в международном виде, без плюса. Текст — поле text. Медиа — публичная ссылка media_url не тяжелее 10 МБ, тип image, video, audio или document. Для документа есть имя файла. В ответе приходят идентификатор сообщения и статус доставки, обычно sent, если шлюз принял его.

POST /api/v1/whatsapp-unofficial/devices/INSTANCE_ID/messages
Authorization: Bearer ВАШ_КЛЮЧ
{"recipient":"79990001122","text":"Заказ собран, можно забирать."}

Чем это не является

Это не WhatsApp Business Cloud API. Шаблоны Meta здесь не согласуют, отдельного «зелёного» бизнес-аккаунта API не создаёт. Сообщение уходит с номера, который вы сами подключили по QR. Если телефон закрыл сессию, connect снова попросит код, и пока его не сканируют, отправка бессмысленна.

Ключ, который больше не нужен, отзывают в том же разделе и выпускают новый. Старый после отзыва в запросы не годится. Про рассылку пачкой из кабинета, без своего кода, читайте отдельную инструкцию.