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

# Zamanlanmış Gönderimler

> Herhangi bir mesajı daha sonra, bir kez veya günlük, haftalık ya da aylık tekrarla gönderin ve zamanlamaları /send/schedules üzerinden yönetin.

![GOWA Mesaj Zamanlayıcısına Genel Bakış](https://mintcdn.com/gowa-docs/G0gUpNl3gUGyehVX/images/GOWA-Message-Scheduler-Overview.png?fit=max\&auto=format\&n=G0gUpNl3gUGyehVX\&q=85\&s=663bfdbb9e1c0bb451c0fa782380b139)

Her gönderim isteği, hemen gönderilmek yerine zamanlanabilir. `scheduled_at` ve `timezone` ekleyin; GOWA isteği saklar ve bir arka plan işçisi belirtilen zamanda gönderir. Zamanlamalar yeniden başlatmalarda korunur ve çevrimdışı cihazın bağlanmasını bekler.

Zamanlanabilen mesaj türleri: metin, görüntü, dosya, video, ses, çıkartma, kişi, bağlantı, konum, anket ve iletme (`/message/{id}/forward`). Çevrimiçi durum, yazıyor göstergeleri ve deneysel `/send/interactive` uç noktası zamanlanamaz.

## Zamanlama alanları

| Alan | Zorunlu | Açıklama |
| - | - | - |
| `scheduled_at` | evet | İlk gönderimin gelecekteki RFC 3339 zamanı, örneğin `2026-11-01T09:00:00+07:00`. İlk gönderim her zaman bu saatte gerçekleşir. |
| `timezone` | evet | Tekrarları hesaplamak için kullanılan IANA bölgesi (örneğin `Asia/Jakarta`); böylece "her gün 09:00", yaz saati değişikliklerinde de 09:00 olarak kalır. |
| `recurrence` | hayır | `once` (varsayılan), `daily`, `weekly` veya `monthly`. |
| `weekdays` | haftalık | Gönderim günleri, `0` = Pazar … `6` = Cumartesi, örneğin `[1, 3, 5]`. |
| `day_of_month` | aylık | `1`–`31`; daha kısa aylarda ayın son gününe sınırlandırılır. |
| `end_at` | hayır | Yalnızca tekrarlanan gönderimler. Bu saatten sonra gönderim yapılmaz. |
| `occurrence_limit` | hayır | Yalnızca tekrarlanan gönderimler. Bu sayıda gönderimden sonra durur. |

`scheduled_at` olmadan istek her zamanki gibi hemen gönderilir.

## Örnekler

```bash theme={null}
# once, tomorrow morning
curl -u admin:changeme -X POST http://localhost:3000/send/message \
  -H "Content-Type: application/json" -H "X-Device-Id: my-device" \
  -d '{
    "phone": "628123456789",
    "message": "Reminder: meeting at 10:00",
    "scheduled_at": "2026-11-01T09:00:00+07:00",
    "timezone": "Asia/Jakarta"
  }'
```

```json theme={null}
{
  "code": "SUCCESS",
  "message": "Success",
  "results": {
    "schedule_id": "0b5c3a8e-7f5d-4d6f-9d1e-2f8c1a7b9e10",
    "scheduled_at": "2026-11-01T02:00:00Z",
    "next_run_at": "2026-11-01T02:00:00Z"
  }
}
```

Zamanlanmış gönderim yanıtları `message_id` yerine `schedule_id` içerir.

```bash theme={null}
# every Monday, Wednesday and Friday at 08:30, 12 times
curl -u admin:changeme -X POST http://localhost:3000/send/message \
  -H "Content-Type: application/json" -H "X-Device-Id: my-device" \
  -d '{
    "phone": "120363025246125486@g.us",
    "message": "Standup in 30 minutes",
    "scheduled_at": "2026-11-02T08:30:00+07:00",
    "timezone": "Asia/Jakarta",
    "recurrence": "weekly",
    "weekdays": [1, 3, 5],
    "occurrence_limit": 12
  }'
```

```bash theme={null}
# monthly invoice on the 1st, with an uploaded file (multipart: repeat weekdays as separate fields if used)
curl -u admin:changeme -X POST http://localhost:3000/send/file \
  -H "X-Device-Id: my-device" \
  -F phone=628123456789 \
  -F file=@invoice.pdf \
  -F scheduled_at=2026-12-01T09:00:00+07:00 \
  -F timezone=Asia/Jakarta \
  -F recurrence=monthly \
  -F day_of_month=1 \
  -F end_at=2027-12-31T23:59:59+07:00
```

Yüklenen dosyalar, zamanlama tamamlanana kadar sunucuda tutulur. Multipart gövdelerde `weekdays` değerini yinelenen alanlar olarak gönderin (`-F weekdays=1 -F weekdays=3`).

## Zamanlamaları yönetme

Zamanlamalar bir cihaza aittir; aynı `X-Device-Id` değerini gönderin.

| İşlem | İstek |
| - | - |
| Listele | İsteğe bağlı `status`, `search` (alıcı veya metin), `message_type`, `limit`, `offset` ile `GET /send/schedules` |
| Birini getir | `GET /send/schedules/{schedule_id}` |
| Duraklat | `POST /send/schedules/{schedule_id}/pause` |
| Sürdür | `POST /send/schedules/{schedule_id}/resume` |
| İptal et | `POST /send/schedules/{schedule_id}/cancel` |

```bash theme={null}
curl -u admin:changeme -H "X-Device-Id: my-device" \
  "http://localhost:3000/send/schedules?status=active&limit=25"
```

Liste, `results.data` ve `results.pagination` (`limit`, varsayılan 25; `offset`; `total`) döndürür.

### Durumlar

| Durum | Anlamı |
| - | - |
| `active` | Bir sonraki çalıştırmayı bekliyor. |
| `running` | İşçi tarafından devralındı ve gönderiliyor. |
| `paused` | Sürdürülene kadar bekletiliyor. |
| `completed` | Kalan çalıştırma yok. |
| `failed` | Yeniden denemelerden sonra vazgeçildi veya saklanan istek geçersizdi. |
| `cancelled` | Sizin tarafınızdan iptal edildi. |

## Teslimat davranışı

* İşçi, zamanı gelen zamanlamaları her 5 saniyede bir kontrol eder.
* **Cihaz çevrimdışı veya oturum açılmamış:** çalıştırma bekler ve her 30 saniyede bir yeniden dener. Beklemek başarısız deneme sayılmaz; böylece zamanlama uzun kesintilerde korunur.
* **Gönderim hataları:** 15 saniyeden başlayıp 5 dakika ile sınırlanan artan bekleme süreleriyle, her gerçekleşme için en fazla 10 kez yeniden denenir. Ardından tekrarlanan zamanlama bir sonraki gerçekleşmeye geçer; tek seferlik zamanlama `failed` olur.
* **Geçersiz istek** (örneğin hatalı alıcı): yeniden denenmeden hemen başarısız olur.
* **Geciken çalıştırmalar:** `end_at` sonrasına geciken bir gerçekleşme gönderilmez.
* **Çökmeler ve yeniden başlatmalar:** kapanma, halihazırda devam eden bir gönderimi iptal etmez. İlk denemeden önce GOWA, ilgili gerçekleşme için bir WhatsApp mesaj kimliğini kalıcı olarak kaydeder. 2 dakikalık sahiplenme süresi dolduktan sonra kesintiye uğrayan gerçekleşme aynı kimlikle yeniden kuyruğa alınır ve deneme sınırına dahil edilir. Anketler de yeniden denemeler arasında şifreleme anahtarını korur. Bu, sonucu belirsiz bir alındı bildiriminden sonra mesaj kimliğini korur, ancak tam olarak bir kez teslimatı garanti etmez.
* **Eski kesintiye uğramış denemeler:** sonucu bilinmeyen eski denemelerde temkinli kurtarma uygulanmaya devam eder. İşçi, yeni bir mesaj kimliği atamak yerine tekrarlanan zamanlamada bu gerçekleşmeyi atlar veya tek seferlik zamanlamayı başarısız olarak işaretler.

## MCP üzerinden

MCP aracı `whatsapp_send` aynı zamanlama alanlarını kabul eder; `whatsapp_schedule` ise zamanlamaları listeler, getirir, duraklatır, sürdürür ve iptal eder. [MCP sunucusu](https://gowa-docs.mintlify.site/tr/integrations/mcp.md) bölümüne bakın.

> [!NOTE]
>
> `GET /app/info` sonucunu kontrol edin: sunucu zamanlama alanlarını kabul edip `/send/schedules` uç noktasını sunduğunda `results.scheduled_sends`, `true` olur.


## Related topics

- [Zamanlanmış gönderimleri listele](https://gowa-docs.mintlify.site/tr/api-reference/send/zamanlanmış-gönderimleri-listele.md)
- [Mesajı sil](https://gowa-docs.mintlify.site/tr/api-reference/message/mesajı-sil.md)
- [Mesajı okundu olarak işaretle](https://gowa-docs.mintlify.site/tr/api-reference/message/mesajı-okundu-olarak-işaretle.md)
- [Çevrimiçi durumunu gönder](https://gowa-docs.mintlify.site/tr/api-reference/send/çevrimiçi-durumunu-gönder.md)
- [Mesaja tepki gönder](https://gowa-docs.mintlify.site/tr/api-reference/message/mesaja-tepki-gönder.md)


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