API: Hatırlatma Tetikleme Endpoint'i

Bir sözleşmeyi gönderdiniz, bir veya daha fazla imzacı imzalamadı. Onları el ile aramak yerine API’den tetikleyebilirsiniz.

Endpoint

POST /api/v1/demands/:id/reminders
X-API-Key: imz_...
Content-Type: application/json

{
  "channels": ["sms", "email"],
  "extra_message": "Lütfen bugün içinde imzalayın, teşekkürler",
  "force": false
}

Parametreler

Alan	Tip	Açıklama
channels	string[]	["sms"], ["email"], veya ["sms", "email"] — ikisi birden
extra_message	string?	Standart hatırlatma metninin sonuna eklenir
force	boolean?	true ise 5 dakikalık anti-spam kuralını atlar

Anti-Spam: Otomatik Hız Limiti

Aynı sözleşme için 5 dakika içinde ikinci kez hatırlatma çağrısı yapılamaz — yanıt 429 döner. force: true ile bu pencereyi atlayabilirsiniz, ama:

Sert kural: Kişi başına 3 SMS + 3 e-posta hatırlatma limiti vardır. force bunu override etmez. Limite ulaşan imzacı için hatırlatma bypass edilir, yanıtta skipped_reasons[] ile bilgilendirir.

Workspace ve API Anahtarı

Hatırlatma yetkisi, API anahtarınızın bağlı olduğu çalışma alanına göre belirlenir:

• API key bir kişisel alana bağlıysa, sadece kişisel sözleşmelere hatırlatma gönderebilirsiniz
• Kuruluş alanına bağlıysa, kuruluştaki tüm sözleşmelere

X-Workspace-Id header’ı gönderebilir, sözleşme aramayı belirli bir kuruluşa daraltabilirsiniz.

SMS ve E-posta Şablonları

Hatırlatma metni, kuruluş ayarlarınızda veya şablon-bazlı tanımlanan hatırlatma şablonu kullanır. Şablon değişkenleri ({{first_name}}, {{link}} vb.) otomatik dolar. Sözleşme bazlı bir şablon override etmek için hâlâ dashboard’dan ya da extra_message parametresiyle ek bilgi gönderebilirsiniz.

Eski Endpoint’in Durumu

Dashboard’ın kullandığı POST /api/send-reminder/:id JWT korumasıyla çalışmaya devam ediyor — sadece dashboard kullanıcıları için. External API çağrılarınızı yeni /api/v1/... endpoint’i üzerinden yapın.