API başvurusu

Planlı gönderiler

Bu gruptaki 10 uç.

Planlı gönderileri listeler

GET/api/v1/scheduled-posts

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.

Kapsam
communities:read
SDK metodu
listScheduledPosts · list_scheduled_posts
MCP aracı
listScheduledPostssalt okunur

Sayfalı

Parametreler

AdTürZorunluAçıklama
community_idsorguuuidhayırYalnız bu topluluk
statussorguenumhayırYalnız bu durumpending_approval | rejected | scheduled | sending | sent | failed | uncertain | canceled
fromsorgudate-timehayırBu andan itibaren
tosorgudate-timehayırBu andan önce
limitsorguintegerhayırSayfa boyutu (1–200, varsayılan 50); tam sayı değilse 400val 1–200, default 50
cursorsorgustringhayırÖnceki yanıttaki next_cursor (opak)

Örnek istek

curl -X GET "https://hiboty.com/api/v1/scheduled-posts?limit=50" \
  -H "Authorization: Bearer $HIBOTY_API_KEY"

Örnek yanıt (200)

JSON
{
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "community_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "batch_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "topic_id": 1,
      "text": "string",
      "image_url": "https://example.com/a.png",
      "button_text": "string",
      "button_url": "https://example.com/a.png",
      "silent": true,
      "pin": true,
      "repeat": "none",
      "status": "pending_approval",
      "scheduled_at": "2026-11-06T09:00:00.000Z",
      "retry_at": "2026-11-06T09:00:00.000Z",
      "attempts": 1,
      "message_id": "string",
      "simulated": true,
      "error": "string",
      "reject_reason": "string",
      "created_by": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "reviewed_at": "2026-11-06T09:00:00.000Z",
      "sent_at": "2026-11-06T09:00:00.000Z",
      "clicks": 1,
      "created_at": "2026-11-06T09:00:00.000Z",
      "updated_at": "2026-11-06T09:00:00.000Z"
    }
  ],
  "next_cursor": "string"
}

Olası hatalar

  • 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.

Gönderi planlar ya da hemen yayınlar

POST/api/v1/scheduled-posts

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.

Kapsam
communities:write
SDK metodu
createScheduledPost · create_scheduled_post
MCP aracı
createScheduledPostdış etkili

Idempotency-Key destekli

Parametreler

AdTürZorunluAçıklama
Idempotency-Keybaşlıkstringhayırİ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ı

AdTürZorunluAçıklama
community_idsuuid[]evetitems 1–20
textstringevetGörselli gönderide en fazla 1024 karakterlen 1–4096
publish_nowbooleanhayır
topic_idsobjecthayırForum grubunda hedef konu: topluluk kimliği → konu kimliği
image_urlstring | nullhayırHerkese açık https adresilen ≤ 1000
button_textstring | nullhayırlen ≤ 64
button_urlstring | nullhayırhttps adresi; button_text ile birliktelen ≤ 1000
silentbooleanhayır
pinbooleanhayır
repeatenumhayırnone | daily | weekly
scheduled_atdate-timehayırSaat dilimi ofsetiyle ISO 8601 anı
whatsappobjecthayır
whatsapp.bot_iduuidevetWhatsApp botu
whatsapp.template_namestringevetMeta'da onaylı, MARKETING kategorisinde ve medya başlıksız şablonlen 1–512
whatsapp.template_languagestringevetlen 2–15
whatsapp.template_paramsstring[]hayırBaşlık ve gövde değişkenleri sırayla; satır sonları tek boşluğa çevriliritems ≤ 20
whatsapp.topicstringhayırİsteğe bağlı kampanya konusu; konuyu kapatan kişiler kitleye girmezlen ≤ 40

Örnek istek

curl -X POST "https://hiboty.com/api/v1/scheduled-posts" \
  -H "Authorization: Bearer $HIBOTY_API_KEY" \
  -H "Idempotency-Key: order-10482" \
  -H "Content-Type: application/json" \
  -d '{"community_ids":["3fa85f64-5717-4562-b3fc-2c963f66afa6"],"text":"Yeni kampanyamız başladı!","button_text":"İncele","button_url":"https://ornek.com/kampanya","repeat":"none","scheduled_at":"2030-01-15T10:00:00+03:00"}'

Örnek yanıt (201)

JSON
{
  "data": {
    "batch_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "posts": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "community_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "batch_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "topic_id": 1,
        "text": "string",
        "image_url": "https://example.com/a.png",
        "button_text": "string",
        "button_url": "https://example.com/a.png",
        "silent": true,
        "pin": true,
        "repeat": "none",
        "status": "pending_approval",
        "scheduled_at": "2026-11-06T09:00:00.000Z",
        "retry_at": "2026-11-06T09:00:00.000Z",
        "attempts": 1,
        "message_id": "string",
        "simulated": true,
        "error": "string",
        "reject_reason": "string",
        "created_by": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "reviewed_at": "2026-11-06T09:00:00.000Z",
        "sent_at": "2026-11-06T09:00:00.000Z",
        "clicks": 1,
        "created_at": "2026-11-06T09:00:00.000Z",
        "updated_at": "2026-11-06T09:00:00.000Z"
      }
    ],
    "warnings": [
      {
        "code": "ornek",
        "message": "string"
      }
    ],
    "whatsapp_campaign": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "status": "string",
      "audience_count": 1
    }
  }
}

Olası hatalar

  • 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
  • 422İçerik politikasına takıldı (content_policy).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

Ay takvimini gönderilerle döner

GET/api/v1/scheduled-posts/calendar

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

AdTürZorunluAçıklama
monthsorgustringhayırYYYY-MM

Örnek istek

curl -X GET "https://hiboty.com/api/v1/scheduled-posts/calendar" \
  -H "Authorization: Bearer $HIBOTY_API_KEY"

Örnek yanıt (200)

JSON
{
  "data": {
    "month": "string",
    "timezone": "Europe/Istanbul",
    "days": [
      {
        "date": "string",
        "in_month": true,
        "posts": [
          {
            "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "batch_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "status": "pending_approval",
            "scheduled_at": "2026-11-06T09:00:00.000Z",
            "repeat": "none",
            "text": "string",
            "targets": []
          }
        ]
      }
    ]
  }
}

Olası hatalar

  • 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.

Planlı gönderi ayrıntısı

GET/api/v1/scheduled-posts/{id}

Çok hedefli gönderide turun hedefleri ve özet durumu da döner. Kapsam: communities:read.

Kapsam
communities:read
SDK metodu
getScheduledPost · get_scheduled_post
MCP aracı
getScheduledPostsalt okunur

Parametreler

AdTürZorunluAçıklama
idyoluuidevetid kimliği

Örnek istek

curl -X GET "https://hiboty.com/api/v1/scheduled-posts/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "Authorization: Bearer $HIBOTY_API_KEY"

Örnek yanıt (200)

JSON
{
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "community_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "batch_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "topic_id": 1,
    "text": "string",
    "image_url": "https://example.com/a.png",
    "button_text": "string",
    "button_url": "https://example.com/a.png",
    "silent": true,
    "pin": true,
    "repeat": "none",
    "status": "pending_approval",
    "scheduled_at": "2026-11-06T09:00:00.000Z",
    "retry_at": "2026-11-06T09:00:00.000Z",
    "attempts": 1,
    "message_id": "string",
    "simulated": true,
    "error": "string",
    "reject_reason": "string",
    "created_by": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "reviewed_at": "2026-11-06T09:00:00.000Z",
    "sent_at": "2026-11-06T09:00:00.000Z",
    "clicks": 1,
    "created_at": "2026-11-06T09:00:00.000Z",
    "updated_at": "2026-11-06T09:00:00.000Z",
    "batch_status": "pending_approval",
    "targets": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "community_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "status": "pending_approval"
      }
    ]
  }
}

Olası hatalar

  • 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.

Planlı gönderiyi düzenler

PATCH/api/v1/scheduled-posts/{id}

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

AdTürZorunluAçıklama
idyoluuidevetid kimliği

Gövde alanları

AdTürZorunluAçıklama
textstringhayırlen 1–4096
topic_idsobjecthayırForum grubunda hedef konu: topluluk kimliği → konu kimliği
image_urlstring | nullhayırHerkese açık https adresilen ≤ 1000
button_textstring | nullhayırlen ≤ 64
button_urlstring | nullhayırhttps adresi; button_text ile birliktelen ≤ 1000
silentbooleanhayır
pinbooleanhayır
repeatenumhayırnone | daily | weekly
scheduled_atdate-timehayırSaat dilimi ofsetiyle ISO 8601 anı

Örnek istek

curl -X PATCH "https://hiboty.com/api/v1/scheduled-posts/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "Authorization: Bearer $HIBOTY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Kampanyamız yarın başlıyor!","scheduled_at":"2030-01-16T10:00:00+03:00"}'

Örnek yanıt (200)

JSON
{
  "data": {
    "batch_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "posts": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "community_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "batch_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "topic_id": 1,
        "text": "string",
        "image_url": "https://example.com/a.png",
        "button_text": "string",
        "button_url": "https://example.com/a.png",
        "silent": true,
        "pin": true,
        "repeat": "none",
        "status": "pending_approval",
        "scheduled_at": "2026-11-06T09:00:00.000Z",
        "retry_at": "2026-11-06T09:00:00.000Z",
        "attempts": 1,
        "message_id": "string",
        "simulated": true,
        "error": "string",
        "reject_reason": "string",
        "created_by": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "reviewed_at": "2026-11-06T09:00:00.000Z",
        "sent_at": "2026-11-06T09:00:00.000Z",
        "clicks": 1,
        "created_at": "2026-11-06T09:00:00.000Z",
        "updated_at": "2026-11-06T09:00:00.000Z"
      }
    ],
    "warnings": [
      {
        "code": "ornek",
        "message": "string"
      }
    ],
    "whatsapp_campaign": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "status": "string",
      "audience_count": 1
    }
  }
}

Olası hatalar

  • 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).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.

Planlı gönderiyi iptal eder

DELETE/api/v1/scheduled-posts/{id}

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.

Kapsam
communities:write
SDK metodu
cancelScheduledPost · cancel_scheduled_post
MCP aracı
cancelScheduledPostgeri alınamaz

Parametreler

AdTürZorunluAçıklama
idyoluuidevetid kimliği

Örnek istek

curl -X DELETE "https://hiboty.com/api/v1/scheduled-posts/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "Authorization: Bearer $HIBOTY_API_KEY"

Örnek yanıt (200)

JSON
{
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "canceled": true,
    "canceled_targets": 1,
    "sent_targets": 1
  }
}

Olası hatalar

  • 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.

Gönderiyi hemen yayınlar

POST/api/v1/scheduled-posts/{id}/publish

Ç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.

Kapsam
communities:write
SDK metodu
publishScheduledPost · publish_scheduled_post
MCP aracı
publishScheduledPostdış etkili

Idempotency-Key destekli

Parametreler

AdTürZorunluAçıklama
idyoluuidevetid kimliği
Idempotency-Keybaşlıkstringhayırİ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

Örnek istek

curl -X POST "https://hiboty.com/api/v1/scheduled-posts/3fa85f64-5717-4562-b3fc-2c963f66afa6/publish" \
  -H "Authorization: Bearer $HIBOTY_API_KEY" \
  -H "Idempotency-Key: order-10482"

Örnek yanıt (200)

JSON
{
  "data": {
    "batch_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "posts": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "community_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "batch_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "topic_id": 1,
        "text": "string",
        "image_url": "https://example.com/a.png",
        "button_text": "string",
        "button_url": "https://example.com/a.png",
        "silent": true,
        "pin": true,
        "repeat": "none",
        "status": "pending_approval",
        "scheduled_at": "2026-11-06T09:00:00.000Z",
        "retry_at": "2026-11-06T09:00:00.000Z",
        "attempts": 1,
        "message_id": "string",
        "simulated": true,
        "error": "string",
        "reject_reason": "string",
        "created_by": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "reviewed_at": "2026-11-06T09:00:00.000Z",
        "sent_at": "2026-11-06T09:00:00.000Z",
        "clicks": 1,
        "created_at": "2026-11-06T09:00:00.000Z",
        "updated_at": "2026-11-06T09:00:00.000Z"
      }
    ],
    "warnings": [
      {
        "code": "ornek",
        "message": "string"
      }
    ],
    "whatsapp_campaign": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "status": "string",
      "audience_count": 1
    }
  }
}

Olası hatalar

  • 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).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

Onay bekleyen gönderiyi onaylar

POST/api/v1/scheduled-posts/{id}/approve

İç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.

Kapsam
communities:write
SDK metodu
approveScheduledPost · approve_scheduled_post
MCP aracı
approveScheduledPostdış etkili

Idempotency-Key destekli

Parametreler

AdTürZorunluAçıklama
idyoluuidevetid kimliği
Idempotency-Keybaşlıkstringhayırİ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

Örnek istek

curl -X POST "https://hiboty.com/api/v1/scheduled-posts/3fa85f64-5717-4562-b3fc-2c963f66afa6/approve" \
  -H "Authorization: Bearer $HIBOTY_API_KEY" \
  -H "Idempotency-Key: order-10482"

Örnek yanıt (200)

JSON
{
  "data": {
    "batch_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "posts": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "community_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "batch_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "topic_id": 1,
        "text": "string",
        "image_url": "https://example.com/a.png",
        "button_text": "string",
        "button_url": "https://example.com/a.png",
        "silent": true,
        "pin": true,
        "repeat": "none",
        "status": "pending_approval",
        "scheduled_at": "2026-11-06T09:00:00.000Z",
        "retry_at": "2026-11-06T09:00:00.000Z",
        "attempts": 1,
        "message_id": "string",
        "simulated": true,
        "error": "string",
        "reject_reason": "string",
        "created_by": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "reviewed_at": "2026-11-06T09:00:00.000Z",
        "sent_at": "2026-11-06T09:00:00.000Z",
        "clicks": 1,
        "created_at": "2026-11-06T09:00:00.000Z",
        "updated_at": "2026-11-06T09:00:00.000Z"
      }
    ],
    "warnings": [
      {
        "code": "ornek",
        "message": "string"
      }
    ],
    "whatsapp_campaign": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "status": "string",
      "audience_count": 1
    }
  }
}

Olası hatalar

  • 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).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.

Onay bekleyen gönderiyi reddeder

POST/api/v1/scheduled-posts/{id}/reject

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.

Kapsam
communities:write
SDK metodu
rejectScheduledPost · reject_scheduled_post
MCP aracı
rejectScheduledPost

Idempotency-Key destekli

Parametreler

AdTürZorunluAçıklama
idyoluuidevetid kimliği
Idempotency-Keybaşlıkstringhayırİ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ı

AdTürZorunluAçıklama
reasonstringhayırlen ≤ 300

Örnek istek

curl -X POST "https://hiboty.com/api/v1/scheduled-posts/3fa85f64-5717-4562-b3fc-2c963f66afa6/reject" \
  -H "Authorization: Bearer $HIBOTY_API_KEY" \
  -H "Idempotency-Key: order-10482" \
  -H "Content-Type: application/json" \
  -d '{"reason":"Görseli güncelleyin."}'

Örnek yanıt (200)

JSON
{
  "data": {
    "batch_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "posts": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "community_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "batch_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "topic_id": 1,
        "text": "string",
        "image_url": "https://example.com/a.png",
        "button_text": "string",
        "button_url": "https://example.com/a.png",
        "silent": true,
        "pin": true,
        "repeat": "none",
        "status": "pending_approval",
        "scheduled_at": "2026-11-06T09:00:00.000Z",
        "retry_at": "2026-11-06T09:00:00.000Z",
        "attempts": 1,
        "message_id": "string",
        "simulated": true,
        "error": "string",
        "reject_reason": "string",
        "created_by": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "reviewed_at": "2026-11-06T09:00:00.000Z",
        "sent_at": "2026-11-06T09:00:00.000Z",
        "clicks": 1,
        "created_at": "2026-11-06T09:00:00.000Z",
        "updated_at": "2026-11-06T09:00:00.000Z"
      }
    ],
    "warnings": [
      {
        "code": "ornek",
        "message": "string"
      }
    ],
    "whatsapp_campaign": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "status": "string",
      "audience_count": 1
    }
  }
}

Olası hatalar

  • 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.

Sonucu belirsiz gönderiyi yeniden gönderir

POST/api/v1/scheduled-posts/{id}/resend

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.

Kapsam
communities:write
SDK metodu
resendUncertainPost · resend_uncertain_post
MCP aracı
resendUncertainPostdış etkili

Idempotency-Key destekli

Parametreler

AdTürZorunluAçıklama
idyoluuidevetid kimliği
Idempotency-Keybaşlıkstringhayırİ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

Örnek istek

curl -X POST "https://hiboty.com/api/v1/scheduled-posts/3fa85f64-5717-4562-b3fc-2c963f66afa6/resend" \
  -H "Authorization: Bearer $HIBOTY_API_KEY" \
  -H "Idempotency-Key: order-10482"

Örnek yanıt (200)

JSON
{
  "data": {
    "batch_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "posts": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "community_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "batch_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "topic_id": 1,
        "text": "string",
        "image_url": "https://example.com/a.png",
        "button_text": "string",
        "button_url": "https://example.com/a.png",
        "silent": true,
        "pin": true,
        "repeat": "none",
        "status": "pending_approval",
        "scheduled_at": "2026-11-06T09:00:00.000Z",
        "retry_at": "2026-11-06T09:00:00.000Z",
        "attempts": 1,
        "message_id": "string",
        "simulated": true,
        "error": "string",
        "reject_reason": "string",
        "created_by": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "reviewed_at": "2026-11-06T09:00:00.000Z",
        "sent_at": "2026-11-06T09:00:00.000Z",
        "clicks": 1,
        "created_at": "2026-11-06T09:00:00.000Z",
        "updated_at": "2026-11-06T09:00:00.000Z"
      }
    ],
    "warnings": [
      {
        "code": "ornek",
        "message": "string"
      }
    ],
    "whatsapp_campaign": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "status": "string",
      "audience_count": 1
    }
  }
}

Olası hatalar

  • 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