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

# Mesaj Gönderme

> /send uç noktalarıyla metin, medya, kişiler, konumlar, bağlantılar, anketler ve çevrimiçi durum bilgisi gönderin.

Tüm örneklerde Basic Auth `admin:changeme`, `my-device` adlı bir cihaz yuvası ve `localhost:3000` üzerinde çalışan GOWA varsayılır.

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

## Alıcılar

`phone` şu değerleri kabul eder:

* Ülke kodu içeren, `+`, boşluk veya tire içermeyen bir numara: `628123456789` (baştaki `+` kaldırılır).
* Kullanıcı JID'si: `628123456789@s.whatsapp.net`.
* Grup JID'si: `120363025246125486@g.us`.
* Durum güncellemesi paylaşmak için `status@broadcast`.

`WHATSAPP_ACCOUNT_VALIDATION=true` olduğunda (varsayılan), GOWA göndermeden önce numaranın WhatsApp'ta olup olmadığını kontrol eder. `GET /user/check?phone=628123456789` ile kendiniz de kontrol edebilirsiniz.

## Metin

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

İsteğe bağlı alanlar:

| Alan | Açıklama |
| - | - |
| `reply_message_id` | Önceki bir mesajı alıntılayın. |
| `mentions` | Bahsedilecek telefon numaraları, örneğin `["628111111111"]`; `"@everyone"` her grup üyesinden bahseder. Bahsetmeler için metinde `@` bulunması gerekmez. |
| `is_forwarded` | "İletildi" etiketini gösterin. |
| `duration` | Saniye cinsinden kaybolan mesaj süresi: `0`, `86400` (24 saat), `604800` (7 gün) veya `7776000` (90 gün). |
| `allow_reshare` | Yalnızca durum paylaşımları (`phone` = `status@broadcast`). |

Başarılı gönderimler WhatsApp mesaj kimliğini döndürür:

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

## Medya

Medya uç noktaları `multipart/form-data` kabul eder. Bir dosya yükleyin veya GOWA'nın indireceği bir URL (`*_url`) iletin.

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

| Uç nokta | Dosya alanı / URL alanı | Ek alanlar |
| - | - | - |
| `/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` (sesli mesaj olarak gönder) |
| `/send/sticker` | `sticker` / `sticker_url` | JPG, PNG, WebP veya GIF; WebP'ye dönüştürülür |

Tüm medya uç noktaları ayrıca `reply_message_id`, `is_forwarded` ve `duration` kabul eder. Boyut sınırları ve biçimler için [Medya işleme](https://gowa-docs.mintlify.site/tr/examples/media-handling.md) bölümüne bakın.

## Kişi, konum, bağlantı, anket

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

## Çevrimiçi durum ve yazıyor bilgisi

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

Native-flow düğmeleri, konum istekleri ve görüntü karuselleri için [Deneysel etkileşimli mesajlar](https://gowa-docs.mintlify.site/tr/examples/interactive-messages.md) bölümüne bakın.

## Gönderim sonrası

| İşlem | Uç nokta |
| - | - |
| Düzenle | `phone`, `message` ile `POST /message/{message_id}/update` |
| Tepki ver | `phone`, `emoji` ile `POST /message/{message_id}/reaction` |
| Herkesten sil | `phone` ile `POST /message/{message_id}/revoke` |
| Benden sil | `phone` ile `POST /message/{message_id}/delete` |
| İlet | `phone` (hedef) ile `POST /message/{message_id}/forward`. Kaynak mesaj GOWA'nın yerel sohbet deposunda bulunmalıdır. |
| Yıldız ekle / kaldır | `phone` ile `POST /message/{message_id}/star`, `/unstar` |

### Görüntü veya belge açıklamasını düzenleme

v9.9.0 sonrasındaki GOWA `main` dalında `media_type` değerini `image` veya `document` olarak ayarlayın. Özgün mesajla eşleşmelidir. `message` alanına yeni açıklamayı yazın ve `link` alanını göndermeyin. Örnek kimliği, gönderdiğiniz mesajın kimliğiyle değiştirin.

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

## Daha sonra gönderme

Desteklenen bir gönderim isteğini zamanlamak için `scheduled_at` ve `timezone` ekleyin. `/send/interactive` yalnızca anında gönderimi destekler. [Zamanlanmış gönderimler](https://gowa-docs.mintlify.site/tr/examples/scheduled-sends.md) bölümüne bakın.

## Çok sayıda alıcıya gönderme

GOWA'nın toplu yayın uç noktası yoktur. Kodunuzda alıcılar üzerinde döngü kurun, istekleri aralarında gecikme bırakarak birer birer gönderin ve `WA_REACHOUT_TIMELOCK` hatalarında durun. Yüksek hacimli gönderimden önce [Gönderim sınırları](https://gowa-docs.mintlify.site/tr/advanced/rate-limiting.md) bölümünü okuyun.


## Related topics

- [Grup Yönetimi](https://gowa-docs.mintlify.site/tr/examples/group-management.md)
- [Deneysel etkileşimli mesajlar](https://gowa-docs.mintlify.site/tr/examples/interactive-messages.md)
- [Mesaj gönder](https://gowa-docs.mintlify.site/tr/api-reference/send/mesaj-gönder.md)
- [Mesaj alma](https://gowa-docs.mintlify.site/tr/examples/receiving-messages.md)
- [Bülten mesaj sayaçlarını getir](https://gowa-docs.mintlify.site/tr/api-reference/newsletter/bülten-mesaj-sayaçlarını-getir.md)


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