En son oluşturulan önce. from ve to planlanan zamana uygulanır (to hariç). Üye rolünde yalnız erişebildiği botların gönderileri döner. Kapsam: communities:read.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
community_ids bir ya da en çok 20 hedef alır; birden çok hedef tek işlemde kaydedilir (biri geçersizse hiçbiri açılmaz). scheduled_at ya da publish_now gerekir. Üye rolünün gönderisi yönetici onayına düşer (pending_approval) ve publish_now ile de yayınlanmaz. İçerik politikası engeli 422 content_policy, dikkat ifadeleri ve kanal yetkisi eksikliği warnings dizisinde döner. Hemen yayında kanal hatası kaydı geri almaz: sonuç posts içindeki status ve error alanlarındadır. Test modunda gönderi Telegram'a gitmez, simulated true olur. Tekrarda çift gönderiyi önlemek için Idempotency-Key kullanın. whatsapp bloğu verilirse aynı içerikten WhatsApp kampanya taslağı açılır: yalnız onaylı MARKETING şablonuyla ve yalnız izinli (opted_in) kişilere, yönetici onayından sonra gider; write kapsamı gerekir. WhatsApp tarafı hatalıysa hiçbir kayıt açılmaz (404 template_not_found, 400 template_not_allowed ya da template_params, 409 empty_audience veya channel_not_configured, 502 channel_error). Kapsam: communities:write.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
Gövde alanları
Ad
Tür
Zorunlu
Açıklama
community_ids
uuid[]
evet
items 1–20
text
string
evet
Görselli gönderide en fazla 1024 karakterlen 1–4096
publish_now
boolean
hayır
topic_ids
object
hayır
Forum grubunda hedef konu: topluluk kimliği → konu kimliği
image_url
string | null
hayır
Herkese açık https adresilen ≤ 1000
button_text
string | null
hayır
len ≤ 64
button_url
string | null
hayır
https adresi; button_text ile birliktelen ≤ 1000
silent
boolean
hayır
pin
boolean
hayır
repeat
enum
hayır
none | daily | weekly
scheduled_at
date-time
hayır
Saat dilimi ofsetiyle ISO 8601 anı
whatsapp
object
hayır
whatsapp.bot_id
uuid
evet
WhatsApp botu
whatsapp.template_name
string
evet
Meta'da onaylı, MARKETING kategorisinde ve medya başlıksız şablonlen 1–512
whatsapp.template_language
string
evet
len 2–15
whatsapp.template_params
string[]
hayır
Başlık ve gövde değişkenleri sırayla; satır sonları tek boşluğa çevriliritems ≤ 20
whatsapp.topic
string
hayır
İsteğe bağlı kampanya konusu; konuyu kapatan kişiler kitleye girmezlen ≤ 40
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).template_not_allowed
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).template_not_found
409İşlem bu durumda yapılamıyor; kod nedeni söyler.empty_audience
Panel takvimiyle aynı aralık: Pazartesi başlayan haftalar, organizasyon saat dilimi. Her gün gönderileriyle döner; çok hedefli tur tek öğedir. month verilmezse bu ay. Kapsam: communities:read.
Kapsam
communities:read
SDK metodu
getPostCalendar · get_post_calendar
MCP aracı
getPostCalendarsalt okunur
Parametreler
Ad
Tür
Zorunlu
Açıklama
monthsorgu
string
hayır
YYYY-MM
Örnek istek
curl -X GET "https://hiboty.com/api/v1/scheduled-posts/calendar" \
-H "Authorization: Bearer $HIBOTY_API_KEY"
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
Yalnız scheduled ve pending_approval durumundaki gönderi düzenlenir; gönderimi başlamışsa 409 post_locked. Yönetici her gönderiyi, üye yalnız kendi onay bekleyenini düzenler; durum değişmez, üye gönderisi onay bekler. Çok hedefli gönderide aynı turun bütün hedefleri birlikte değişir. Doğrulama ve içerik politikası oluşturmayla aynıdır (422 content_policy). Kapsam: communities:write.
Kapsam
communities:write
SDK metodu
updateScheduledPost · update_scheduled_post
MCP aracı
updateScheduledPost
Parametreler
Ad
Tür
Zorunlu
Açıklama
idyol
uuid
evet
id kimliği
Gövde alanları
Ad
Tür
Zorunlu
Açıklama
text
string
hayır
len 1–4096
topic_ids
object
hayır
Forum grubunda hedef konu: topluluk kimliği → konu kimliği
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
409İşlem bu durumda yapılamıyor; kod nedeni söyler.post_locked
Yönetici her gönderiyi, üye yalnız kendi onay bekleyenini iptal eder. Çok hedefli gönderide gönderilmemiş hedefler ve serinin sonraki turları iptal edilir; gönderilmiş hedefler değişmez. İptal edilecek bir şey kalmadıysa 409 post_locked. Kapsam: communities:write.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
409İşlem bu durumda yapılamıyor; kod nedeni söyler.post_locked
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
Çok hedefli gönderide turun planlı hedefleri yayınlanır, her hedefin sonucu posts içinde döner; süreye sığmayan hedefler planlı kalır. Başarısız hedef ya da gönderi bu uçla yeniden denenir. Tek hedefte kanal hatası 502 channel_error, politika engeli 422 content_policy, planlı değilse 409 post_locked döner. Test modunda Telegram'a gitmez. Yönetici yetkisi gerekir. Kapsam: communities:write.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
409İşlem bu durumda yapılamıyor; kod nedeni söyler.post_locked
İçerik güncel politikayla yeniden denetlenir (422 content_policy). Zamanı geçmişse hemen yayınlanır; yayın hatası onayı geri almaz ve warnings içinde döner. Çok hedefli gönderide turun bütün hedefleri onaylanır. Onay beklemiyorsa 409 post_locked. Yönetici yetkisi gerekir. Kapsam: communities:write.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
409İşlem bu durumda yapılamıyor; kod nedeni söyler.post_locked
Neden isteğe bağlıdır ve gönderene bildirilir. Çok hedefli gönderide turun bütün hedefleri reddedilir. Onay beklemiyorsa 409 post_locked. Yönetici yetkisi gerekir. Kapsam: communities:write.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
409İşlem bu durumda yapılamıyor; kod nedeni söyler.post_locked
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
Yalnız uncertain durumundaki gönderi ya da hedef için. Dikkat: önceki deneme Telegram'a ulaşmış olabilir, mesaj ikinci kez görünebilir; önce kanalı kontrol edin. Diğer hedeflere dokunulmaz. Belirsiz değilse 409 post_locked, kanal hatası 502 channel_error. Yönetici yetkisi gerekir. Kapsam: communities:write.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
409İşlem bu durumda yapılamıyor; kod nedeni söyler.post_locked
422İçerik politikasına takıldı (content_policy).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
502Kanal ya da dış servis hatası (channel_error).channel_error