Farklı kitlelere paylaşım yapan bir yapay zekâ ajanı bayramları ve özel günleri nasıl yönetmeli?

Birçok hesap için paylaşım yapan bir ajan, planlanan her saati tek bir ulusal takvime göre değil, her hesabın kitlesinin bayramlarına ve özel günlerine göre kontrol etmelidir. Shager'da bu iki kontrol demek: Planlamadan önce önemli gelenekler için get_holidays çağırmak, ardından planlanan her gönderiyle birlikte dönen calendar_notes alanını okumak. Hiçbir aracın ajan adına yapamayacağı kısım ise hangi geleneğin hangi hesap için geçerli olduğuna karar vermektir; bu yüzden bunun müşteri bazında yazılı olması gerekir.

Takvim kolay. Asıl zor olan eşleştirme.

Özel günlerle ilgili hataların çoğu eksik veriden değil, her kitlenin aynı takvimi paylaştığını varsaymaktan kaynaklanır.

Tek bir çalışma alanından şu hesapları yöneten bir ajans düşünün:

1. Celile'deki bir Dürzi köyünde aile restoranı.
2. Hastalarının çoğu İsrail'in Arap vatandaşları olan bir diş kliniği zinciri.
3. Haredi kitleye satış yapan bir ev eşyası mağazası.
4. Rusça konuşanlar için bir toplum merkezi; kitlesinin bir kısmı Ortodoks kilisesi takvimini izliyor.
5. Avrupa ve Kuzey Amerika'ya gönderim yapan bir e-ticaret markası.

Salı günü paylaşılan neşeli bir indirim gönderisi bunların dördü için sorun olmayabilir, beşincisi için ise çok kötü bir zamanlama olabilir. Ajan yalnızca talimatlarında yazanı bilir. Bu yüzden aşağıdaki araçlar işe yaramadan önce her müşteri profilinde açık bir satır olmalı: bu kitlenin gözettiği gelenekler. Zaten tek ajanla birçok müşteri yönetiyorsanız, bu satırın yeri o profildir.

Diyagramın tamamı için yana kaydırın

Shager'ın bayram ve özel gün takvimi neleri kapsıyor?

Takvim; Yahudi ve İsrail, Müslüman, Batı Hristiyan, Ortodoks Hristiyan, Dürzi, Bahai, Hindu, Budist, Sih, Caynist, Çin ve İran bayramlarını ve özel günlerini içerir. Uluslararası ve ticari günleri de kapsar: Sevgililer Günü, Dünya Kadınlar Günü, ABD'deki Anneler Günü ve Babalar Günü, Cadılar Bayramı, Bekarlar Günü, Şükran Günü, Black Friday, Cyber Monday ve Yılbaşı.

Her gün, dört paylaşım tavsiyesinden birini taşır:

Tavsiye	Ajanın yapması gereken	Örnekler
avoid	O kitleye hiçbir tanıtım içeriği yok	Yom Kippur; İsrail'de Holokost'u Anma Günü ve Anma Günü
sensitive	Yalnızca saygılı içerik; agresif satış ve şaka yok	Oruç günleri, Kutsal Cuma, Aşure, Arefe günü, Kadir Gecesi
opportunity	Bir kutlama mesajı ya da temalı bir gönderi uygun düşer	Ramazan Bayramı, Noel, Diwali, Çin Yeni Yılı, Black Friday
normal	Değiştirilecek bir şey yok	Diğer her şey

Uygulamadaki takvim aynı verileri insanlara da gösterir; gelenek filtresi ve her tavsiye için ayrı bir renkle.

get_holidays çağırmak

Bu işlev MCP aracı get_holidays olarak ve OpenAPI spesifikasyonunda belgelenmiş bir REST işlemi olarak sunulur:

curl -s "https://app.shager.ai/api/v1/holidays?from=2026-11-20&to=2026-12-05&traditions=jewish,muslim&language=en" \
  -H "Authorization: Bearer $SHAGER_API_KEY"

from ve to verilmezse aralık bugünden itibaren 60 gündür. En fazla 400 gün olabilir. traditions sonuçları belirttiğiniz geleneklerle sınırlar; language ise adları İngilizce ya da İbranice döndürür. Yanıtın yapısı şöyledir:

{
  "data": {
    "from": "2026-11-20",
    "to": "2026-12-05",
    "note": "...",
    "holidays": [
      {
        "date": "YYYY-MM-DD",
        "tradition": "...",
        "name": "...",
        "key": "...",
        "advice": "opportunity",
        "guidance": "...",
        "approximate": true
      }
    ]
  }
}

guidance alanını insan onaylayana iletin; bir gönderinin neden kaydırıldığını tek cümleyle açıklar.

Baştan sona çağrı sırası

Haftalık bir çalışmada kullandığım sıra şu. Örnek olarak 2026 Kasım'ının sonunu alalım: Şükran Günü 26 Kasım perşembeye, Black Friday 27'sine, Cyber Monday ise 30'una denk geliyor. E-ticaret markası için bu, art arda gelen opportunity günleri demek. Haredi mağaza ya da Dürzi restoran içinse aynı günler sadece normal olabilir ve temalı bir gönderiye hiç değmeyebilir.

get_holidays  { from: "2026-11-20", to: "2026-12-05", traditions: <union of all profiles in this run> }

create_post   { workspace_id: "ws_retail",
                channel_ids: ["ch_shop_eu_ig", "ch_shop_us_fb"],
                caption: "...",
                per_channel: [
                  { channel_id: "ch_shop_eu_ig", caption: "..." },
                  { channel_id: "ch_shop_us_fb", caption: "..." }
                ],
                media_ids: ["med_19ae"] }

schedule_post { workspace_id: "ws_retail", post_id: "pst_5d2c",
                schedule_at: "2026-11-27T09:00:00-05:00" }

read calendar_notes on the returned post
  if any entry is avoid or sensitive for a tradition in this account's profile:
    cancel_post, pick a new time, schedule again, and log why

Birincisi, per_channel tek bir gönderinin her hesapta farklı bir açıklama taşımasını sağlar; böylece ABD sayfası Şükran Günü hafta sonundan söz ederken AB sayfası Amerikan çerçevesine girmeden Black Friday'i anlatabilir. Bunu hesap bazında açıklama çeşitlemesi yazısında daha ayrıntılı ele aldım.

İkincisi, bir gönderinin tek bir planlanmış saati vardır. Aynı gruptaki iki kitle bir gün konusunda ayrışıyorsa, açıklamalar bunu çözemez. Onları ayrı saatlere sahip ayrı gönderilere bölün.

calendar_notes, create_post, get_post ve schedule_post tarafından döndürülen her gönderide gelir ve o gönderinin planlandığı gündeki bayram ve özel günleri tavsiyeleriyle birlikte listeler. Birinin elle değiştirdiği bir saat de dahil olmak üzere planlamanın kaçırdığını yakalar.

Diyagramın tamamı için yana kaydırın

"Bir önceki akşam başlar" kuralı neden basit tarih kontrollerini bozar?

Yahudi bayramları, takvimde görünen tarihten bir önceki akşam gün batımında başlar. Reform hareketinin açıklaması, bunu akşamın sabahtan önce geldiği yaratılış anlatısına dayandırır. İslami gün de gün batımında başlar; Türkiye'deki okurların arife kavramından iyi bildiği bir durum.

Yalnızca tarihleri karşılaştıran bir ajan bu konuda öngörülebilir bir hata yapar. Takvim Yom Kippur'u bir tarihte gösterir. Ajan bir önceki gün saat 19.00'a planlanmış bir kampanyayı kontrol eder, eşleşme görmez ve gönderiyi orucun tam başlangıcına denk getirir.

İsrail'de iki anma gününde risk daha yüksektir. Şehit askerleri Anma Günü bir önceki gece gün batımında başlar ve gün boyunca eğlence yerleri yasa gereği kapalıdır. Holokost'u Anma Günü'nde ise halka açık eğlence yerleri yasa gereği hem arife akşamı hem de günün kendisinde kapalıdır. O akşam şakacı bir indirim gönderisi paylaşan bir marka yasayı çiğnemiş olmaz, ama kitle bunu fark eder.

Ajan talimatlarındaki kuralım basit: avoid ve sensitive günlerde, bir önceki günün öğleden sonrası ve akşamı da o günün parçası sayılır. opportunity günlerinde ise akşam başlangıcı işinize yarar; bayram başlamadan önce ulaşan bir kutlama mesajı tam zamanında gelmiş olur.

İslami tarihler neden yaklaşık olarak işaretleniyor?

Shager İslami tarihleri Ümmü'l-Kurâ takvimine göre hesaplar ve approximate: true olarak işaretler. Ümmü'l-Kurâ, Suudi Arabistan'ın resmî takvimidir ve önceden hesaplanır; dini ayların başlangıcı ise hilalin görülmesine bağlıdır. The New Arab, takvimin eski resmî web sitesinden takvimin hilalin fiilen görünmesiyle örtüşmeyebileceğini söyleyen bir ifadeyi aktarır. Ülkeler de farklı hilal görme ölçütleri uygular; bu yüzden bayram farklı ülkelerde farklı günlere denk gelebilir.

Kayma yaklaşık bir gündür. Klinik zinciri için bunun anlamı şu: Ramazan Bayramı kutlama mesajını erkenden taslak olarak hazırlayın ve yerel duyurudan sonra planlayın ya da bir gün erken yayınlansa bile iyi okunacak şekilde yazın. Yaklaşık bir sensitive gün için her iki yanında birer günlük tampon bırakın. Birden fazla ülkeye yayılmış kitleler içinse tek bir tarihin hepsine uyduğunu varsaymayın.

Uyarlayabileceğiniz bir komut

Before scheduling anything this week:
1. Read each client's audience profile and list its traditions. If a profile has none, stop and ask me.
2. Call get_holidays once for the whole week, with the union of those traditions.
3. avoid: no promotional posts to that audience, including the afternoon and evening before.
4. sensitive: respectful tone only. No discounts, no humour, no countdowns.
5. opportunity: propose a greeting or themed post, written separately per account with per_channel.
6. approximate=true: keep a one day buffer, or wait for the local announcement.
7. After schedule_post, read calendar_notes. On a conflict, cancel, reschedule and tell me what changed.

Saat farkları ve özel günler aynı turda ele alınsın diye bunu ajanlar için planlama stratejisi yazısındaki zamanlama kurallarıyla birlikte kullanın.

Her planlı çalıştırmadan önce kontrol listesi

1. Her hesabın, geleneklerin açıkça listelendiği bir kitle profili var.
2. Tek bir get_holidays çağrısı, çalıştırmanın tüm tarih aralığını kapsıyor.
3. Bir avoid günü, kendinden önceki akşamı da engelliyor.
4. Bir sensitive gün yalnızca saati değil, tonu da değiştiriyor.
5. opportunity gönderileri her kitle için ayrı yazılıyor; asla herkese tek bir genel kutlama mesajı değil.
6. Yaklaşık tarihlere bir günlük tampon ekleniyor.
7. Tartışmalı bir günde karışık kitleler ayrı gönderilere bölünüyor.
8. Planlamadan sonra ajan calendar_notes alanını okuyor ve yaptığı her değişikliği raporluyor.

Şabat gibi haftalık dinlenme günleri bir takvim girdisi değil, sabit bir kuraldır; bu yüzden bunları kitle profiline engellenmiş zaman aralıkları olarak ekleyin.

Ajanınız henüz bağlı değilse ajanlar için giriş sayfası kurulumu adım adım anlatıyor. Bağlandıktan sonra ilk faydalı iş küçük: Her müşteri profiline gelenekler satırını ekleyin ve önümüzdeki iki ay için get_holidays çalıştırıp neler geldiğine bakın.

SSS

Shager bir avoid gününde planlamayı engeller mi?

Hayır. Tavsiye bir bilgidir; get_holidays tarafından ve her gönderinin calendar_notes alanında döndürülür. Karar ajanda ve onun işini onaylayan kişide kalır, çünkü aynı gün bir kitle için yas günüyken bir başkası için sıradan bir gün olabilir.

Ajan bir hesap için hangi geleneklerin geçerli olduğunu nasıl bilir?

İşletmenin adından ya da şehrinden tahmin yürütmemelidir. Gelenekleri her müşterinin kitle profiline yazın ve ajana bu satır eksik olduğunda durup sormasını söyleyin.

Küresel bir e-ticaret markası dini bayramları hiç dikkate almalı mı?

Evet, özellikle büyük pazarları için. Hesaplarını pazara göre gruplayın, her grubu ticari günlere ve o pazarda yaygın geleneklere göre kontrol edin ve kutlama mesajlarını grup bazında yazın. Bir Noel gönderisi bir pazarda fırsat, bir başkasında ise alakasız ya da tuhaf olabilir.