İçeriğe geç

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
  • KimlikBearer <kampanya anahtarı>
  • Limit60 istek / dakika (kampanya başına)
  • Modlarlink_only · email

POST/api/v1/external/surveys/link-campaigns/{campaignId}/link-sharings

POST /api/v1/external/surveys/link-campaigns/{campaignId}/link-sharings
Authorization: Bearer <kampanya anahtarı>
Content-Type: application/json
Idempotency-Key: <benzersiz değer> # yalnızca email modunda
{
"customer": {
"email": "[email protected]",
"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"
}
}
{
"url": "https://s.air.tk/p/AbCdEfGhIjKlMnOpQrStUv",
"token": "AbCdEfGhIjKlMnOpQrStUv",
"expires_at": "2026-10-01T00:00:00.000Z",
"campaign_id": "…"
}
{ "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.

AlanTip / sınırAçıklama
customer.emaile-posta, 254email modunda zorunlu
customer.namemetin, 128link içi değişkenlerde kullanılabilir
customer.external_idmetin, 128CRM kimliği
customer.phone_numbermetin, 32·
built_in_responsesanahtar 64 / değer 1024Entegrasyon Anahtarı ile gizli sorulara yazılır
custom_attrsen fazla 40 anahtarcevap değil, yalnızca metadata
options.single_usebooleanlink tek kullanımlık olsun mu
options.expires_atISO tarihgelecek bir tarih olmalı
options.shorten_urlbooleankısaltılmış link
external_keymetin, 128yalnı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.

HTTPcodeAnlamı ve yapılacak
401invalid_keyAnahtar hatalı veya başlık eksik
401campaign_pausedKampanya duraklatılmış; panelden devam ettirilmeli
404campaign_not_foundYoldaki kampanya, anahtarın kampanyası değil. Anahtarlar kampanyalar arasında taşınamaz
422unknown_built_in_response_keyTanınmayan Entegrasyon Anahtarı; yanıttaki key alanı hangisi olduğunu söyler
422recipient_email_requiredemail modunda customer.email yok
422invalid_expires_atGeçmiş tarih ya da kampanya politikası dışında
409idempotency_key_in_progressAynı anahtarla bir gönderim hâlâ işleniyor; tekrar deneyin
429recipient_send_limitAynı adrese çok gönderim (saatte 10). Retry-After başlığına uyun
503no_delivery_inboxGönderim kanalı tanımsız; platform tarafı yapılandırma eksiği