API WatsyApp
для сообщений в WhatsApp.

Получить канал своего аккаунта и его состояние. В текущей версии на аккаунт доступен один канал. Ответ — JSON-массив с channelId, name, transport и state.

curl 'https://watsyapp.com/v3/channels' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Отправить текст. channelId должен принадлежать вашему аккаунту, chatId — номер получателя, text — непустое сообщение. Канал должен быть подключён.

curl --request POST 'https://watsyapp.com/v3/message' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "channelId": "YOUR_CHANNEL_ID",
    "chatId": "RECIPIENT_DIGITS",
    "text": "Здравствуйте! Отправляем ответ из нашей системы."
  }'

Пример успешного ответа

{
  "messageId": "MESSAGE_ID",
  "chatId": "RECIPIENT_DIGITS"
}

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

Отправить один файл через multipart/form-data. Поля: chatId, file, необязательный text. Лимит одного вложения — 20 МБ. Канал определяется вашим API-ключом; отдельный channelId этому методу не нужен.

curl --request POST 'https://watsyapp.com/api/send' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --form 'chatId=RECIPIENT_DIGITS' \
  --form 'text=Документ по вашему запросу' \
  --form 'file=@./document.pdf;type=application/pdf'

Для голосового сообщения добавьте поле type=voice и загрузите аудиофайл. Сервер преобразует его в OGG/Opus. В остальных случаях тип отправки определяется MIME-типом файла.

Не задавайте заголовок Content-Type multipart вручную: curl сформирует его с boundary. Поле contentUri в /v3/message не поддерживается — передавайте файл через /api/send.