> ## 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.

# Mengirim Pesan

> Kirim teks, media, kontak, lokasi, tautan, polling, dan status kehadiran melalui endpoint /send.

Semua contoh menggunakan Basic Auth `admin:changeme`, slot bernama `my-device`, dan GOWA di `localhost:3000`.

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

## Penerima

`phone` menerima:

* Nomor dengan kode negara, tanpa `+`, spasi, atau tanda hubung: `628123456789` (tanda `+` di awal akan dihapus).
* JID pengguna: `628123456789@s.whatsapp.net`.
* JID grup: `120363025246125486@g.us`.
* `status@broadcast` untuk memposting pembaruan status.

Dengan `WHATSAPP_ACCOUNT_VALIDATION=true` (default), GOWA memeriksa apakah nomor terdaftar di WhatsApp sebelum mengirim. Anda dapat memeriksanya dengan `GET /user/check?phone=628123456789`.

## Teks

```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!"}'
```

Field opsional:

| Field | Deskripsi |
| - | - |
| `reply_message_id` | Kutip pesan sebelumnya. |
| `mentions` | Nomor telepon yang ingin disebut, misalnya `["628111111111"]`; `"@everyone"` menyebut semua anggota grup. Teks pesan tidak perlu memuat `@` untuk menyebut pengguna. |
| `is_forwarded` | Tampilkan label "Diteruskan". |
| `duration` | Pengatur waktu pesan sementara dalam detik: `0`, `86400` (24 jam), `604800` (7 hari), atau `7776000` (90 hari). |
| `allow_reshare` | Hanya untuk postingan status (`phone` = `status@broadcast`). |

Pengiriman yang berhasil mengembalikan ID pesan WhatsApp:

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

## Media

Endpoint media menerima `multipart/form-data`. Unggah file atau berikan URL yang akan diunduh oleh 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 | Field file / field URL | Field tambahan |
| - | - | - |
| `/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` (kirim sebagai pesan suara) |
| `/send/sticker` | `sticker` / `sticker_url` | JPG, PNG, WebP, atau GIF; dikonversi ke WebP |

Semua endpoint media juga menerima `reply_message_id`, `is_forwarded`, dan `duration`. Lihat [Penanganan media](https://gowa-docs.mintlify.site/id/examples/media-handling.md) untuk batas ukuran dan format.

## Kontak, lokasi, tautan, polling

```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}'
```

## Status kehadiran dan mengetik

```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"}'
```

Untuk tombol native-flow, permintaan lokasi, dan carousel gambar, lihat [Pesan interaktif eksperimental](https://gowa-docs.mintlify.site/id/examples/interactive-messages.md).

## Setelah mengirim

| Tindakan | Endpoint |
| - | - |
| Edit | `POST /message/{message_id}/update` dengan `phone`, `message` |
| Beri reaksi | `POST /message/{message_id}/reaction` dengan `phone`, `emoji` |
| Hapus untuk semua orang | `POST /message/{message_id}/revoke` dengan `phone` |
| Hapus untuk saya | `POST /message/{message_id}/delete` dengan `phone` |
| Teruskan | `POST /message/{message_id}/forward` dengan `phone` (tujuan). Pesan sumber harus ada di penyimpanan chat lokal GOWA. |
| Beri / hapus bintang | `POST /message/{message_id}/star`, `/unstar` dengan `phone` |

### Mengedit keterangan gambar atau dokumen

Pada branch `main` GOWA setelah v9.9.0, atur `media_type` ke `image` atau `document`. Nilainya harus sesuai dengan pesan asli. Isi `message` dengan keterangan pengganti dan jangan sertakan `link`. Ganti ID contoh dengan ID pesan yang telah Anda kirim.

```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"}'
```

## Mengirim nanti

Tambahkan `scheduled_at` dan `timezone` ke permintaan pengiriman yang didukung untuk menjadwalkannya. `/send/interactive` hanya mendukung pengiriman langsung. Lihat [Pengiriman terjadwal](https://gowa-docs.mintlify.site/id/examples/scheduled-sends.md).

## Mengirim ke banyak penerima

GOWA tidak memiliki endpoint broadcast. Lakukan perulangan atas daftar penerima dalam kode Anda, kirim permintaan satu per satu dengan jeda, dan hentikan saat terjadi error `WA_REACHOUT_TIMELOCK`. Baca [Batas pengiriman](https://gowa-docs.mintlify.site/id/advanced/rate-limiting.md) sebelum mengirim dalam jumlah besar.


## Related topics

- [Menerima pesan](https://gowa-docs.mintlify.site/id/examples/receiving-messages.md)
- [Pesan interaktif eksperimental](https://gowa-docs.mintlify.site/id/examples/interactive-messages.md)
- [Integrasi Chatwoot](https://gowa-docs.mintlify.site/id/integrations/chatwoot.md)
- [Atur mode pengumuman grup](https://gowa-docs.mintlify.site/id/api-reference/group/atur-mode-pengumuman-grup.md)
- [Pengelolaan Grup](https://gowa-docs.mintlify.site/id/examples/group-management.md)


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