3. Link kampanyası: tekil link üretimi
Dış sistem her ihtiyaç duyduğunda tek bir kişiye özel anket linki ister. Kampanya panelden oluşturulur; oluşturma anında bir anahtar üretilir ve yalnızca bir kez gösterilir: saklanmazsa yenilenmesi (rotate) gerekir.
- YönDış sistem → SARP CX
- Kimlik
Bearer <kampanya anahtarı> - Limit60 istek / dakika (kampanya başına)
- Modlar
link_only·email
POST/api/v1/external/surveys/link-campaigns/{campaignId}/link-sharings
POST /api/v1/external/surveys/link-campaigns/{campaignId}/link-sharingsAuthorization: Bearer <kampanya anahtarı>Content-Type: application/jsonIdempotency-Key: <benzersiz değer> # yalnızca email modunda
{ "customer": { "name": "Ayşe Yılmaz", "external_id": "CRM-88213", "phone_number": "+905xxxxxxxxx" }, "built_in_responses": { "ucus_no": "TK1986", "kabin": "business" }, "custom_attrs": { "kampanya": "lounge-2026" }, "options": { "single_use": true, "expires_at": "2026-10-01T00:00:00Z" }}Yanıt: link_only modu (201)
Bölüm başlığı “Yanıt: link_only modu (201)”{ "url": "https://s.air.tk/p/AbCdEfGhIjKlMnOpQrStUv", "token": "AbCdEfGhIjKlMnOpQrStUv", "expires_at": "2026-10-01T00:00:00.000Z", "campaign_id": "…"}Yanıt: email modu (202)
Bölüm başlığı “Yanıt: email modu (202)”{ "accepted": true, "run_id": "…", "campaign_id": "…" }E-posta modunda link yanıtta dönmez; gönderim platform tarafında yapılır ve run_id ile panelden izlenebilir. Bu modda customer.email zorunludur.
Alanlar
Bölüm başlığı “Alanlar”| Alan | Tip / sınır | Açıklama |
|---|---|---|
customer.email | e-posta, 254 | email modunda zorunlu |
customer.name | metin, 128 | link içi değişkenlerde kullanılabilir |
customer.external_id | metin, 128 | CRM kimliği |
customer.phone_number | metin, 32 | · |
built_in_responses | anahtar 64 / değer 1024 | Entegrasyon Anahtarı ile gizli sorulara yazılır |
custom_attrs | en fazla 40 anahtar | cevap değil, yalnızca metadata |
options.single_use | boolean | link tek kullanımlık olsun mu |
options.expires_at | ISO tarih | gelecek bir tarih olmalı |
options.shorten_url | boolean | kısaltılmış link |
external_key | metin, 128 | yalnız link_only: aynı anahtar aynı linki döndürür (created: false) |
Aynı kişiye birden fazla kanaldan tek link göndermek ve linklerin durumunu toplu sorgulamak için bkz. 10. User story: Tek link, çok kanal.
Hata kodları
Bölüm başlığı “Hata kodları”HTTP | code | Anlamı ve yapılacak |
|---|---|---|
401 | invalid_key | Anahtar hatalı veya başlık eksik |
401 | campaign_paused | Kampanya duraklatılmış; panelden devam ettirilmeli |
404 | campaign_not_found | Yoldaki kampanya, anahtarın kampanyası değil. Anahtarlar kampanyalar arasında taşınamaz |
422 | unknown_built_in_response_key | Tanınmayan Entegrasyon Anahtarı; yanıttaki key alanı hangisi olduğunu söyler |
422 | recipient_email_required | email modunda customer.email yok |
422 | invalid_expires_at | Geçmiş tarih ya da kampanya politikası dışında |
409 | idempotency_key_in_progress | Aynı anahtarla bir gönderim hâlâ işleniyor; tekrar deneyin |
429 | recipient_send_limit | Aynı adrese çok gönderim (saatte 10). Retry-After başlığına uyun |
503 | no_delivery_inbox | Gönderim kanalı tanımsız; platform tarafı yapılandırma eksiği |