​

Sessiz saatler: kuruluş genelinde kanal kapıları vs. kampanya yedek penceresi

1. Kuruluş genelinde kanal kapısı — kuruluş ayarlarındaki kanal başına düğmeler (settings → quiet_hours.<channel>.enabled), PUT /api/v1/settings/general üzerinden yazılır ve pano kuruluş ayarlarında yansıtılır (ayrıca bkz. Uyumluluk duruşu).
2. Kampanya yedek penceresi — kendi penceresini taşımayan drip ve journey gönderimi kampanya satırları için kuruluş genelinde tek başlangıç/bitiş çifti. Panoda: Ayarlar → Kampanya limitleri → Varsayılan sessiz saatler; API üzerinden: GET/PUT /api/v1/campaigns/quiet-hours/settings.
3. Önizleme uç noktası — GET /api/v1/compliance/quiet-hours/preview; “Bu alıcıya bu gönderim şu anda geçer mi?” sorusuna yanıt veren salt okunur bir denetim. Her devreye almadan önce çalıştırın; aşağıdaki el kitabında adım adım işlenir.

​

İki pencere

​

Kuruluş genelinde kanal başına kapı

​

Kanal başına varsayılan duruş

​

Temel trafiğin akmasını sağlayan iki istisna

• Önceden açık onay — consent_overrides_quiet_hours true (varsayılan) ile, açık onay kaydı olan bir alıcı ses dışı her kanaldan geçer. Ses bu istisnayı asla kullanmaz.
• İşlemsel trafik şeridi — arayanın işlemsel olarak etiketlediği gönderimler (OTP’ler, uyarılar, hesap bildirimleri) etkin bir kanalda bile kapıdan muaftır. Ses bu istisnayı da asla kullanmaz.

​

Kampanya yedek penceresi

curl https://api.orbit.devotel.io/api/v1/campaigns/quiet-hours/settings \
  -H "Authorization: Bearer $ORBIT_API_KEY"

{
  "enabled": false,
  "start_hour": null,
  "end_hour": null,
  "platform_default_start": 21,
  "platform_default_end": 9
}

curl -X PUT https://api.orbit.devotel.io/api/v1/campaigns/quiet-hours/settings \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": true, "start_hour": 22, "end_hour": 7 }'

curl -X PUT https://api.orbit.devotel.io/api/v1/campaigns/quiet-hours/settings \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": false }'

​

Alıcı saat dilimi çözümlemesi

1. Sağlandığında arayandan gelen açık bir recipientTimezone ipucu.
2. ABD alan kodu → IANA saat dilimi, +1 numaraları için.
3. E.164 ülke kodu → temsili bir IANA saat dilimi (Avrupa, Asya, Amerika kıtaları ve yaygın operatör pazarları).
4. E-posta alıcıları için kuruluşun varsayılan saat dilimi.
5. Yukarıdakilerden hiçbiri çözümlenmediğinde — kuruluşun unknown_timezone_policy değeri (panoda Ayarlar → Ses altında da yapılandırılabilir):

​

TCPA federal ses istisnası

​

Onay sessiz saatleri geçersiz kılar

​

Eyalet mini-TCPA katmanları

• outside_state_window — bir eyalet katmanı pencereyi daralttı ve bu saat onun dışına düştü.
• state_blocked_day — katman bu hafta gününde aramayı tamamen yasaklar.

​

Operasyonel el kitabı

1. GET /api/v1/compliance/quiet-hours/preview?phone=<E.164>&channel=<channel> ile alıcıların bir örneğini önizleyin; timezone_override=<IANA>yı yalnızca CRM’iniz numaranın çözdüğünden daha iyi bir ipucu taşıdığında ekleyin.
2. Kuruluş kapı bloğunu doğrulayın: GET /api/v1/settings/general çağırın ve PUT öncesinde quiet_hours ağacını okuyun — yazmalar üst düzeyde birleşir ama quiet_hours anahtarının kendisi toptan değiştirilir (aşağıdaki yazma bölümüne bakın).
3. Toplu devreye almalarda GET /api/v1/settings/compliance-health izleyin — uyarıları en kötü suçluyu sıralar (en çok tutulan gönderen, hata kümeleri), böylece en gürültülü şeridi önce düzeltirsiniz.

​

Çalışılmış örnekler

​

21:05’te toplu devreye alma — bekletme kuyruğu davranışı

• Pencere içi alıcılar hemen kabul edilir.
• Tutulan alıcılar 422 ve next_allowed_at alır; işçiniz onları park eder ve toplu işi sürdürür. Toplu işin kendisi duraklamaz — bekletmeler alıcı başınadır.
• Her alıcının penceresi yeniden açıldığında park edilen satırı yeniden gönderin; tutulma sırasında slot yakılmadı.

curl "https://api.orbit.devotel.io/api/v1/compliance/quiet-hours/preview?phone=%2B14155551234&channel=sms" \
  -H "Authorization: Bearer $ORBIT_API_KEY"

{
  "allowed_now": false,
  "local_hour": 21,
  "local_timezone": "America/New_York",
  "window_start_local": "08:00",
  "window_end_local": "21:00",
  "next_allowed_at": "2026-08-26T12:00:00Z",
  "reason": "outside_window",
  "channel": "sms"
}

​

Saat dilimi çözümlenemeyen ABD ses alıcısı — fail-closed

​

Pencere içinde onay geçersiz kılma

kişi a — dosyada onay kaydı      → izinli (neden: consent_override)
kişi b — onay kaydı yok          → tutuldu (422 QUIET_HOURS_BLOCKED)

​

Kuruluş ayarları API’si üzerinden kanal etkinleştirme

curl -X PUT https://api.orbit.devotel.io/api/v1/settings/general \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "settings": {
      "quiet_hours": {
        "sms": { "enabled": true },
        "whatsapp": { "enabled": true, "start_hour": 9, "end_hour": 21 },
        "unknown_timezone_policy": "skip",
        "consent_overrides_quiet_hours": true
      }
    }
  }'

​

Bir duruş seçin

1. Her şeyi kapalı bırakın (varsayılan) — sessiz saat yargı alanlarının dışında çalışıyorsanız veya limitleri başka yerde ele alıyorsanız. Tek uyarı: ABD kampanya ve çevirici sesi sert engelli kalır — bu kapatılamaz.
2. ABD pazarlama operatörü — kuruluş kapısında sms (ve ad-hoc arıyorsanız ses) etkinleştirin; alıcının yerel saatine göre 08:00–21:00 platform saatleri hemen uygulanır. Onay istisnası izinli alıcıları erişilebilir tutar.
3. Drip kampanyalı AB/APAC operatörü — kampanya yedeğini yerel pencerenize (örn. 22:00 → 07:00) Ayarlar → Kampanya limitleri altında ayarlayın; böylece kendi penceresi olmayan her drip ve journey rejiminiz içinde gönderir. 1:1 trafiğin de tutulmasını istiyorsanız kuruluş kapısını kanal başına ekleyin.

​

Ayrıca bakınız

• Gönderim kapıları — önizleme uç noktası ve tam kapı yığını (DNC, RND, acil durum durdurma).
• ABD eyalet arama pencereleri — hangi eyaletlerin daha katı mini-TCPA katmanı taşıdığı ve engelin bir yasaya nasıl geri izlendiği.
• API Başvurusu → Uyumluluk — tam istek/ yanıt şemaları.
• Kampanya A/B testi — kazanan seçiminin ve ayırma deneylerinin bu kapıdan ve kişi başına sıklık limitleri üzerinden nasıl geçtiği.