> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Отправляйте текст, медиа, контакты, места, ссылки, опросы и присутствие с / отправить конечные пункты.

Все примеры предполагают Basic Auth `admin:changeme`, слот `my-device`, и GOWA на `localhost:3000`.

```bash theme={null}
export GOWA=http://localhost:3000
export AUTH=admin:changeme
export DEVICE=my-device
```

## Получатели

`phone` принимает:

* Номер с кодом страны, без `+`, пробелов и дефисов: `628123456789` (начальный `+` удаляется).
* Пользователь JID: `628123456789@s.whatsapp.net`.
* Группа JID: `120363025246125486@g.us`.
* `status@broadcast` чтобы опубликовать обновление статуса.

С помощью `WHATSAPP_ACCOUNT_VALIDATION=true` (по умолчанию) GOWA проверяет, что номер находится в WhatsApp перед отправкой. Проверьте один самостоятельно с помощью `GET /user/check?phone=628123456789`.

## Текст

```bash theme={null}
curl -u $AUTH -X POST $GOWA/send/message \
  -H "Content-Type: application/json" -H "X-Device-Id: $DEVICE" \
  -d '{"phone": "628123456789", "message": "Hello!"}'
```

Необязательные поля:

| Поле | Описание |
| - | - |
| `reply_message_id` | Цитировать более раннее сообщение. |
| `mentions` | Номера телефонов для упоминания, например, `["628111111111"]`; `"@everyone"` упоминает всех членов группы. Не нужно упоминать в тексте `@`. |
| `is_forwarded` | Показывать надпись «Переслать». |
| `duration` | Снятие таймера сообщений в секундах: `0`, `86400` (24 ч), `604800` (7 д) или `7776000` (90 д). |
| `allow_reshare` | Только сообщения статуса (`phone` = `status@broadcast`). |

Успешное послание возвращает ID сообщения WhatsApp:

```json theme={null}
{"code": "SUCCESS", "message": "Success", "results": {"message_id": "3EB0B430B6F8F1D0E053AC120E0A9E5C", "status": "Message sent to 628123456789 (server timestamp: ...)"}}
```

## Медиа

Конечные точки медиа получают `multipart/form-data`. Загрузите файл или передайте URL-адрес, который GOWA загружает (`*_url`).

```bash Image theme={null}
curl -u $AUTH -X POST $GOWA/send/image -H "X-Device-Id: $DEVICE" \
  -F phone=628123456789 \
  -F caption="Product photo" \
  -F image=@photo.jpg \
  -F compress=true
```

```bash Image from URL theme={null}
curl -u $AUTH -X POST $GOWA/send/image -H "X-Device-Id: $DEVICE" \
  -F phone=628123456789 \
  -F image_url=https://example.com/photo.jpg
```

```bash Document theme={null}
curl -u $AUTH -X POST $GOWA/send/file -H "X-Device-Id: $DEVICE" \
  -F phone=628123456789 \
  -F caption="Invoice" \
  -F file=@invoice.pdf
```

```bash Video theme={null}
curl -u $AUTH -X POST $GOWA/send/video -H "X-Device-Id: $DEVICE" \
  -F phone=628123456789 \
  -F caption="Demo" \
  -F video=@demo.mp4
```

```bash Voice note theme={null}
curl -u $AUTH -X POST $GOWA/send/audio -H "X-Device-Id: $DEVICE" \
  -F phone=628123456789 \
  -F audio=@note.ogg \
  -F ptt=true
```

```bash Sticker theme={null}
curl -u $AUTH -X POST $GOWA/send/sticker -H "X-Device-Id: $DEVICE" \
  -F phone=628123456789 \
  -F sticker=@cat.png
```

| Endpoint | Поле файла / URL | Дополнительные поля |
| - | - | - |
| `/send/image` | `image` / `image_url` | `caption`, `view_once`, `compress`, `hd`, `mentions` |
| `/send/video` | `video` / `video_url` | `caption`, `view_once`, `compress`, `hd`, `gif_playback`, `mentions` |
| `/send/file` | `file` / `file_url` | `caption`, `mentions` |
| `/send/audio` | `audio` / `audio_url` | `ptt` (отправить как голосовую заметку) |
| `/send/sticker` | `sticker` / `sticker_url` | JPG, PNG, WebP или GIF; преобразовано в WebP |

Все конечные точки мультимедиа также принимают `reply_message_id`, `is_forwarded` и `duration`. Смотрите [обработку мультимедиа](https://gowa-docs.mintlify.site/ru/examples/media-handling.md) для ограничения размера и форматов.

## Контакт, местоположение, ссылка, опрос

```bash Contact theme={null}
curl -u $AUTH -X POST $GOWA/send/contact \
  -H "Content-Type: application/json" -H "X-Device-Id: $DEVICE" \
  -d '{"phone": "628123456789", "contact_name": "Jane Doe", "contact_phone": "628987654321"}'
```

```bash Location theme={null}
curl -u $AUTH -X POST $GOWA/send/location \
  -H "Content-Type: application/json" -H "X-Device-Id: $DEVICE" \
  -d '{"phone": "628123456789", "latitude": "-6.200000", "longitude": "106.816666"}'
```

```bash Link theme={null}
curl -u $AUTH -X POST $GOWA/send/link \
  -H "Content-Type: application/json" -H "X-Device-Id: $DEVICE" \
  -d '{"phone": "628123456789", "link": "https://github.com", "caption": "Check this out"}'
```

```bash Poll theme={null}
curl -u $AUTH -X POST $GOWA/send/poll \
  -H "Content-Type: application/json" -H "X-Device-Id: $DEVICE" \
  -d '{"phone": "628123456789", "question": "Lunch?", "options": ["Pizza", "Sushi", "Salad"], "max_answer": 1}'
```

## Наличие и печатание

```bash theme={null}
# account-wide presence: available | unavailable
curl -u $AUTH -X POST $GOWA/send/presence \
  -H "Content-Type: application/json" -H "X-Device-Id: $DEVICE" \
  -d '{"type": "available"}'

# typing indicator in one chat: start | stop
curl -u $AUTH -X POST $GOWA/send/chat-presence \
  -H "Content-Type: application/json" -H "X-Device-Id: $DEVICE" \
  -d '{"phone": "628123456789", "action": "start"}'
```

[Экспериментальные интерактивные сообщения](https://gowa-docs.mintlify.site/ru/examples/interactive-messages.md).

## После отправки

| Задача | Endpoint |
| - | - |
| Редактирование | `POST /message/{message_id}/update` с помощью `phone`, `message` |
| Реакция | `POST /message/{message_id}/reaction` с помощью `phone`, `emoji` |
| Удалить для всех | `POST /message/{message_id}/revoke` с помощью `phone` |
| Удалить для меня | `POST /message/{message_id}/delete` с `phone` |
| Вперёд | `POST /message/{message_id}/forward` с помощью `phone` (назначение). Исходное сообщение должно быть в локальном хранилище сообщений GOWA. |
| Звезда / звезда | `POST /message/{message_id}/star`, `/unstar` с помощью `phone` |

### Редактировать подпись изображения или документа

На GOWA `main` после v9.9.0 установите `media_type` в `image` или `document`. Он должен соответствовать исходному сообщению. Установите заголовок `message` на замену и опустите `link`. Замените пример ID вашего отправленного сообщения.

```bash theme={null}
curl -u "$AUTH" -X POST "$GOWA/message/3EB0B430B6F8F1D0E053AC120E0A9E5C/update" \
  -H "Content-Type: application/json" -H "X-Device-Id: $DEVICE" \
  -d '{"phone":"628123456789","message":"Updated caption","media_type":"image"}'
```

## Отправить позже

Добавьте `scheduled_at` и `timezone` в поддерживаемый запрос на отправку в расписание вместо него. `/send/interactive` только. Смотрите [Scheduled sends](https://gowa-docs.mintlify.site/ru/examples/scheduled-sends.md).

## Отправка многим получателям

GOWA не имеет конечной точки вещания. Загляните на получателей в ваш код, отправьте один запрос с задержкой и остановитесь на ошибках `WA_REACHOUT_TIMELOCK`. Читать [Отправка ограничений](https://gowa-docs.mintlify.site/ru/advanced/rate-limiting.md) перед отправкой в громкости.


## Related topics

- [Экспериментальные интерактивные сообщения](https://gowa-docs.mintlify.site/ru/examples/interactive-messages.md)
- [Запланированная отправка](https://gowa-docs.mintlify.site/ru/api-reference/send/запланированная-отправка.md)
- [Отправка ограничений](https://gowa-docs.mintlify.site/ru/advanced/rate-limiting.md)
- [Получение сообщений](https://gowa-docs.mintlify.site/ru/examples/receiving-messages.md)
- [Получать счетчики сообщений](https://gowa-docs.mintlify.site/ru/api-reference/newsletter/получать-счетчики-сообщений.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.