Geliştiriciler

Değişiklik günlüğü

API, MCP ve SDK sürümlerindeki önemli değişikliklerin kısa özeti. En yeni kayıt üsttedir.

1.10.0 · 17 Kasım 2026

  • WhatsApp hesapları (WABA): GET /api/v1/whatsapp-accounts, GET /api/v1/whatsapp-accounts/{id} (hesap durumu, son eşitleme ve bağlı numaraların kalite, mesaj sınırı ve teslim puanı) ve GET /api/v1/whatsapp-accounts/{id}/templates; erişim anahtarı ve App Secret dönmez, yalnız access_token_set ve app_secret_set döner.
  • Bot nesnesine whatsapp_account_id eklendi: numaranın bağlı olduğu WhatsApp hesabı kaydı.
  • POST /api/v1/bots/{id}/connect gövdesinde isteğe bağlı business_id (Meta işletme portföyü kimliği) kabul edilir ve WhatsApp hesabı kaydına yazılır.
  • GET /api/v1/connections?kind=&status=: Telegram botları, WhatsApp numaraları ve hesapları, mağazalar, CRM, AI araçları, webhook'lar, OAuth uygulamaları ve ürün beslemeleri için sırsız birleşik bağlantı listesi; kind ve status ile süzülür.
  • Yeni uçlar JavaScript ve Python SDK'lerinde ve MCP sunucusunda kullanılabilir.

1.9.0 · 17 Kasım 2026

  • Bot nesnesine WhatsApp numara sağlığı eklendi: whatsapp_quality (GREEN, YELLOW, RED, UNKNOWN), whatsapp_messaging_limit ve whatsapp_quality_at; kalite RED iken kampanya başlamaz.
  • Bot nesnesine teslim edilebilirlik puanı eklendi: delivery_score (son 30 günün teslim, okunma, hata, engelleme ve izin kapatma oranlarından 0–100; veri azsa null), delivery_score_reasons ve delivery_score_at.
  • Kampanya nesnesine best_time (en iyi saatte otomatik planlandı), paused_at ve pause_reason (hata_orani ya da kalite_red otomatik duraklatma) eklendi.
  • POST /api/v1/campaigns gövdesinde best_time: true: gönderim zamanı botun geçmiş etkileşiminden, organizasyon saat dilimi, sessiz saat ve mesai kurallarıyla seçilir; scheduled_at ile birlikte 400, öneri yoksa 409 best_time_unavailable döner.
  • Organizasyon bot şablonları: GET/POST /api/v1/bot-templates, GET/PATCH/DELETE /api/v1/bot-templates/{id} ve şablondan bot oluşturan POST /api/v1/bot-templates/{id}/bots; şablonlar sır taşımaz, yeni araç imza sırları yalnız oluşturma yanıtında bir kez döner.
  • Telegram büyüme kampanyaları: GET/POST /api/v1/growth-campaigns, GET/PATCH/DELETE /api/v1/growth-campaigns/{id}, GET /api/v1/growth-campaigns/{id}/report (tıklama, başlatma, yeni ve etkinleşen kişi, katılım, maliyet) ile kaynak bağlayan POST /api/v1/growth-campaigns/{id}/sources ve ayıran DELETE /api/v1/growth-campaigns/{id}/sources/{source_id}.
  • Yeni uçlar JavaScript ve Python SDK'lerinde ve MCP sunucusunda kullanılabilir.

1.8.0 · 17 Kasım 2026

  • GET /api/v1/reports/usage?group_by=bot|channel: bu ayın giden mesaj, AI yanıtı, medya ve Meta tahmini bot ya da kanal başına breakdown alanında döner; satırların toplamı genel toplamla eşleşir.
  • GET /api/v1/usage yanıtında messages nesnesine plan_limit (planın kotası) ve extra_credits (kalan ek mesaj bakiyesi) eklendi; limit artık ek bakiye dahil bu ayın gerçek sınırıdır.
  • Kaynak atfı: GET /api/v1/messages/list mesajlarında ai_sources (yanıtın dayandığı bilgi kaynağı parçaları; boş dizi kaynak dışı yanıt, null atıf kaydı yok). Bot alanı show_source_links açıkken URL kaynağına dayanan yanıtın sonuna müşteriye kaynak bağlantısı eklenir; sesli yanıtta bu satır seslendirilmez.
  • GET /api/v1/reports/ai-quality yanıtına kaynak dışı oran eklendi: attributed_replies, unsourced_replies ve unsourced_rate.
  • GET /api/v1/reports/revenue: tıkla-WhatsApp reklamları ads listesinde ve totals.ads içinde, bot sohbetiyle eşleşen mağaza siparişleri totals.store içinde; farklı para birimlerindeki maliyet cost.mixed ile döner, elle girilen değer manual_cost alanındadır.
  • POST /api/v1/reports/costs/import: kampanya, edinme bağlantısı ve reklam dönem maliyetlerini CSV ya da satır listesiyle içe aktarır; hatalı satırlar errors içinde döner.
  • POST /api/v1/bots/bulk: seçilen botları duraklatır, sürdürür ya da ayarlarını topluca değiştirir; yanıt bot başına sonuç döner (kısmi başarı).
  • POST /api/v1/bots/evaluations/run-all (önce dry_run ile tahmin, sonra max_responses bütçe onayı) ve GET /api/v1/bots/evaluations (bot başına son koşunun başarı oranı ve önceki koşuya göre fark).
  • Yeni uçlar JavaScript ve Python SDK'lerinde ve MCP sunucusunda kullanılabilir.

1.7.0 · 17 Kasım 2026

  • Katmanlı hız sınırı: istekler anahtar, kullanıcı (OAuth) ve organizasyonun dakikalık ve günlük toplamına göre sınırlanır. Bir katman aşılırsa 429 rate_limited o katmanın X-RateLimit-* değerlerini ve aşılan katmanı söyleyen X-RateLimit-Scope başlığını (key, user, organization, organization_day) taşır; Retry-After başlığına uyun.
  • Depolama kotası: yüklenen görsellerin toplam boyutu planın kotasıyla sınırlıdır; kota dolunca POST /api/v1/media 413 storage_quota_exceeded döner. GET /api/v1/usage yanıtına storage (used_bytes, limit_bytes), faturalama görünümüne limits.storage_mb ve usage.storage_bytes eklendi.
  • Python SDK: 1.6.0 dahil yayımlanmış sürümlerde Python 3.9–3.11'de import hiboty hatasına yol açan sözdizimi düzeltildi; SDK yeniden Python 3.9 ve üzerinde çalışır.

1.6.0 · 17 Kasım 2026

  • Yayın onayı (dört göz): GET /api/v1/publish-approvals, POST /api/v1/bots/{id}/versions/{version_id}/approve|reject ve POST /api/v1/miniapps/{id}/versions/{version_id}/approve|reject. Onay açıkken bot ayarı, araç ve kaynak değişikliği 202 pending_approval döner, geri alma new_version: null ve pending_approval: true ile onay bekler; Mini App yayını bekleyen sürüm açar.
  • Sürüm alanları: bot sürümlerinde tools_changed, sources_changed, tool_changes ve source_changes; Mini App sürümlerinde config_sha256 ve status (published, pending, rejected).
  • POST /api/v1/bots/{id}/commands (setBotCommands): Telegram komut menüsünü kurar. GET/PUT /api/v1/bots/{id}/payments: Telegram kartla ödeme sağlayıcı token'ı; token hiçbir yanıtta dönmez.
  • Sipariş payment nesnesine method (telegram_stars, telegram_card), currency ve amount (en küçük birimde) eklendi.
  • POST /api/v1/miniapps/{id}/feed-import: Google Merchant XML/RSS, CSV ya da JSON ürün beslemesini katalog taslağına aktarır (dry_run, auto_refresh, ai_knowledge).
  • Planlı gönderi: whatsapp bloğu aynı içerikten onay bekleyen WhatsApp kampanya taslağı açar (whatsapp_campaign); gönderilerde düğme tıklaması clicks döner.
  • Bot alanları reply_language (sabit yanıt dili, null otomatik), appointment_tool ve cancel_request_tool; bu ayarlar sürüm geçmişine girmez. Mini App gönderimlerinde kind artık randevu ve iptal_talebi de olabilir.
  • Yeni uçlar JavaScript ve Python SDK'lerinde ve MCP sunucusunda kullanılabilir.

1.5.0 · 16 Kasım 2026

  • Her /api/v1 yanıtında Hiboty-Api-Version başlığı döner.
  • GET /api/v1/usage/requests: son günlerin istek sayısı, hata oranı, p95 süresi ve son istekler (yönetici, api_keys:read).
  • CRM bağlantıları: GET/POST/DELETE /api/v1/integrations/crm ve POST /api/v1/integrations/crm/test (HubSpot ve Pipedrive, müşterinin kendi token'ıyla).
  • Bot alanı voice_reply: sesli mesaja sesli yanıt (kapali, sesliye_sesli, her_zaman).
  • Organizasyon görünümünde salt okunur legal_hold ve legal_hold_at; yasal saklama açıkken kişi silme 409 legal_hold döner.
  • Yeni uçlar JavaScript ve Python SDK'lerinde ve MCP sunucusunda kullanılabilir.

1.4.1 · 14 Kasım 2026

  • JavaScript ve Python SDK 1.4.1: yalnız tip ve belge düzeltmesi, davranış değişmez. hiboty.d.ts aşağıdaki alanları ve WebhookOlayi tipini içerir.
  • GET /api/v1/reports/overview: usage.ai_replies altına effective_limit (geçerli AI tavanı; kendi anahtarında null) ve own_key (kendi AI anahtarı) eklendi.
  • GET /api/v1/reports/usage ve GET /api/v1/billing: limits.workspaces planın çalışma alanı hakkını verir.
  • GET /api/v1/templates: şablonun body metni döner. POST /api/v1/bots/import/preview: bot ayarları, bilgi kaynakları ve araçlar ayrıntılı döner.
  • Webhook events alanları OpenAPI'de WebhookOlayi enum'udur; bilinmeyen olay adı 400 döner.
  • Mağaza bağlantısına wa_template alanı eklendi: WhatsApp penceresi kapalıyken sipariş bildirimi bu şablonla gider.
  • Plan sınırının dışında kalan bottan gönderim 403 bot_plan_restricted döner.
  • Kampanya oluşturmak için anahtarı oluşturan kişinin e-postası doğrulanmış olmalıdır; değilse 403 email_not_verified döner.

1.4.0 · 6 Kasım 2026

  • Yeni uç grupları: organizasyon, içerik politikası, AI ayarları, mağaza, medya, denetim, abonelik, ekip, topluluk, davet bağlantısı, planlı gönderi, sohbet, hazır yanıt ve raporlar.
  • Kampanya güncelleme, silme, sonuç, kitle sayımı ve en iyi saat uçları; otomasyon, Mini App, sipariş ve özel talep uçları genişledi.
  • Kaynak kapsamları eklendi (contacts:read gibi); eski anahtarların yetkisi kendiliğinden genişlemez.
  • GET /api/v1/bots cursor ile sayfalanır; POST /api/v1/bots/{id}/refresh-webhook eklendi.
  • Bütün yeni uçlar JavaScript ve Python SDK'lerinde ve MCP sunucusunda kullanılabilir.

1.3.0 · 5 Kasım 2026

  • Bot yönetimi API, MCP ve SDK'lere açıldı: oluşturma, kanal bağlama, AI ayarları, bilgi kaynakları, özel araçlar, sürümler, vitrin, taşıma, değerlendirme, edinme bağlantıları, WhatsApp şablonları ve AI geri bildirimi.
  • Yeni kapsamlar: bots:read ve bots:write.

1.2.0 · 5 Kasım 2026

  • POST /api/v1/messages ve POST /api/v1/campaigns Idempotency-Key destekler; dört liste ucuna cursor eklendi.
  • Yazma şemaları katı hâle geldi: bilinmeyen alan ve yanlış segment alanı 400 döner, limit doğrulanır.
  • Hata yanıtları hız başlıklarını taşır, aylık kotada Retry-After gelir; MCP ve kimlik yolu hız sınırına girer.
  • Webhook yeniden açma ucu eklendi, localhost adresi kaydı 400 döner; SDK'ler hb_oat_ belirteçlerini kabul eder.

1.1.0 · 3 Kasım 2026

  • Kampanya, Mini App, sipariş, otomasyon, şablon, webhook ve kullanım uçları eklendi. Kampanya gönderimi yalnız panelde yönetici onayıyla başlar.
  • /api/mcp adresinde MCP sunucusu ve MCP için OAuth 2.1 eklendi; araçlar OpenAPI'den üretilir.
  • SDK'ler paketlendi: npm @hiboty/sdk ve PyPI hiboty. WhatsApp A/B kampanyaları API'ye açıldı.

1.0.0 · 2 Kasım 2026

  • OpenAPI 3.1 belgesi GET /api/v1/openapi.json adresinde yayımlandı.
  • Bağımlılıksız JavaScript istemcisi /sdk/hiboty.js ve tip dosyası eklendi; bütün /api/v1 uçları yanıt sözleşmesi testine bağlandı.