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ı) veGET /api/v1/whatsapp-accounts/{id}/templates; erişim anahtarı ve App Secret dönmez, yalnızaccess_token_setveapp_secret_setdöner. - Bot nesnesine
whatsapp_account_ideklendi: numaranın bağlı olduğu WhatsApp hesabı kaydı. POST /api/v1/bots/{id}/connectgö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;kindvestatusile 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_limitvewhatsapp_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 azsanull),delivery_score_reasonsvedelivery_score_at. - Kampanya nesnesine
best_time(en iyi saatte otomatik planlandı),paused_atvepause_reason(hata_oraniya dakalite_redotomatik duraklatma) eklendi. POST /api/v1/campaignsgövdesindebest_time: true: gönderim zamanı botun geçmiş etkileşiminden, organizasyon saat dilimi, sessiz saat ve mesai kurallarıyla seçilir;scheduled_atile birlikte 400, öneri yoksa 409best_time_unavailabledöner.- Organizasyon bot şablonları:
GET/POST /api/v1/bot-templates,GET/PATCH/DELETE /api/v1/bot-templates/{id}ve şablondan bot oluşturanPOST /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ğlayanPOST /api/v1/growth-campaigns/{id}/sourcesve ayıranDELETE /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şınabreakdownalanında döner; satırların toplamı genel toplamla eşleşir.GET /api/v1/usageyanıtındamessagesnesnesineplan_limit(planın kotası) veextra_credits(kalan ek mesaj bakiyesi) eklendi;limitartık ek bakiye dahil bu ayın gerçek sınırıdır.- Kaynak atfı:
GET /api/v1/messages/listmesajlarındaai_sources(yanıtın dayandığı bilgi kaynağı parçaları; boş dizi kaynak dışı yanıt,nullatıf kaydı yok). Bot alanıshow_source_linksaçı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-qualityyanıtına kaynak dışı oran eklendi:attributed_replies,unsourced_repliesveunsourced_rate.GET /api/v1/reports/revenue: tıkla-WhatsApp reklamlarıadslistesinde vetotals.adsiçinde, bot sohbetiyle eşleşen mağaza siparişleritotals.storeiçinde; farklı para birimlerindeki maliyetcost.mixedile döner, elle girilen değermanual_costalanı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ırlarerrorsiç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(öncedry_runile tahmin, sonramax_responsesbütçe onayı) veGET /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_limitedo katmanınX-RateLimit-*değerlerini ve aşılan katmanı söyleyenX-RateLimit-Scopebaşlığını (key,user,organization,organization_day) taşır;Retry-Afterbaş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/media413 storage_quota_exceededdöner.GET /api/v1/usageyanıtınastorage(used_bytes,limit_bytes), faturalama görünümünelimits.storage_mbveusage.storage_byteseklendi. - Python SDK: 1.6.0 dahil yayımlanmış sürümlerde Python 3.9–3.11'de
import hibotyhatası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|rejectvePOST /api/v1/miniapps/{id}/versions/{version_id}/approve|reject. Onay açıkken bot ayarı, araç ve kaynak değişikliği202 pending_approvaldöner, geri almanew_version: nullvepending_approval: trueile 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_changesvesource_changes; Mini App sürümlerindeconfig_sha256vestatus(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ş
paymentnesnesinemethod(telegram_stars,telegram_card),currencyveamount(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:
whatsappbloğu aynı içerikten onay bekleyen WhatsApp kampanya taslağı açar (whatsapp_campaign); gönderilerde düğme tıklamasıclicksdöner. - Bot alanları
reply_language(sabit yanıt dili,nullotomatik),appointment_toolvecancel_request_tool; bu ayarlar sürüm geçmişine girmez. Mini App gönderimlerindekindartıkrandevuveiptal_talebide olabilir. - Yeni uçlar JavaScript ve Python SDK'lerinde ve MCP sunucusunda kullanılabilir.
1.5.0 · 16 Kasım 2026
- Her
/api/v1yanıtındaHiboty-Api-Versionbaş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/crmvePOST /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_holdvelegal_hold_at; yasal saklama açıkken kişi silme409 legal_holddö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.tsaşağıdaki alanları veWebhookOlayitipini içerir. GET /api/v1/reports/overview:usage.ai_repliesaltınaeffective_limit(geçerli AI tavanı; kendi anahtarındanull) veown_key(kendi AI anahtarı) eklendi.GET /api/v1/reports/usageveGET /api/v1/billing:limits.workspacesplanın çalışma alanı hakkını verir.GET /api/v1/templates: şablonunbodymetni döner.POST /api/v1/bots/import/preview: bot ayarları, bilgi kaynakları ve araçlar ayrıntılı döner.- Webhook
eventsalanları OpenAPI'deWebhookOlayienum'udur; bilinmeyen olay adı 400 döner. - Mağaza bağlantısına
wa_templatealanı 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_restricteddöner. - Kampanya oluşturmak için anahtarı oluşturan kişinin e-postası doğrulanmış olmalıdır; değilse
403 email_not_verifieddö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:readgibi); eski anahtarların yetkisi kendiliğinden genişlemez. GET /api/v1/botscursor ile sayfalanır;POST /api/v1/bots/{id}/refresh-webhookeklendi.- 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:readvebots:write.
1.2.0 · 5 Kasım 2026
POST /api/v1/messagesvePOST /api/v1/campaignsIdempotency-Keydestekler; dört liste ucuna cursor eklendi.- Yazma şemaları katı hâle geldi: bilinmeyen alan ve yanlış segment alanı 400 döner,
limitdoğrulanır. - Hata yanıtları hız başlıklarını taşır, aylık kotada
Retry-Aftergelir; 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/mcpadresinde MCP sunucusu ve MCP için OAuth 2.1 eklendi; araçlar OpenAPI'den üretilir.- SDK'ler paketlendi: npm
@hiboty/sdkve PyPIhiboty. WhatsApp A/B kampanyaları API'ye açıldı.
1.0.0 · 2 Kasım 2026
- OpenAPI 3.1 belgesi
GET /api/v1/openapi.jsonadresinde yayımlandı. - Bağımlılıksız JavaScript istemcisi
/sdk/hiboty.jsve tip dosyası eklendi; bütün/api/v1uçları yanıt sözleşmesi testine bağlandı.