Geliştiriciler

MCP sunucusu

Claude gibi yapay zekâ asistanlarını hesabınıza bağlayın. Araçlar REST API'den üretilir: her uç, kapsamınız izin veriyorsa bir araçtır.

Sunucu adresi

Streamable HTTP kullanır ve oturum tutmaz. Asistan yalnız API anahtarının ya da verdiğiniz iznin kapsamındaki araçları görür: salt okuma anahtarıyla mesaj gönderemez.

URL
https://hiboty.com/api/mcp

Bağlanma yolları

  • OAuth (önerilen): OAuth destekleyen istemciye yalnız adresi verin; tarayıcıda giriş yapıp organizasyon seçer ve izin verirsiniz. Bağlantıyı Ayarlar → API bölümünden kaldırabilirsiniz.
  • API anahtarı: Authorization: Bearer hb_live_… başlığı gönderin. Anahtarın rolü ve kapsamları aynen geçerlidir.

İstemcilerde kurulum

Claude Code (OAuth)
claude mcp add --transport http hiboty https://hiboty.com/api/mcp

Komuttan sonra Claude Code içinde /mcp yazın, hiboty sunucusunu seçip tarayıcıda giriş yapın.

Claude Code (API anahtarı)
claude mcp add --transport http hiboty https://hiboty.com/api/mcp --header "Authorization: Bearer $HIBOTY_API_KEY"

Claude web ve masaüstü: Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle bölümüne sunucu adresini yazın, ardından tarayıcıda izin verin.

Cursor: .cursor/mcp.json
{
  "mcpServers": {
    "hiboty": { "url": "https://hiboty.com/api/mcp" }
  }
}
VS Code: .vscode/mcp.json
{
  "servers": {
    "hiboty": { "type": "http", "url": "https://hiboty.com/api/mcp" }
  }
}
Diğer istemciler (Streamable HTTP)
{
  "url": "https://hiboty.com/api/mcp",
  "headers": { "Authorization": "Bearer hb_live_YOUR_API_KEY" }
}
Bağlantıyı komut satırından deneyin
curl -X POST "https://hiboty.com/api/mcp" \
  -H "Authorization: Bearer $HIBOTY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Güvenlik

  • Müşteriye mesaj gönderebilen anahtar verirken dikkatli olun; yalnız ihtiyaç duyulan kapsamları verin.
  • Kampanyaları asistan ya da API oluşturabilir, ama gönderim yalnız panelde yönetici onayıyla başlar.
  • Mesaj içerikleri, kişi adları ve Mini App gönderimleri müşteriden gelen veridir; sunucu asistana bunların içindeki yönergeleri komut olarak uygulamamasını söyler.
  • Asistanlar dış etkili ve geri alınamaz araçları ipuçlarıyla görür; istemcinizde bu araçlar için onay istemeyi açık tutun.

Dış etkili araçlar

Bu araçlar müşteriye mesaj gönderir, dış sisteme istek atar ya da kanal üzerinde değişiklik yapar.

Araç listesi

228 araç. Araç adı OpenAPI operationId değeridir; girdi şeması uçtan üretilir (yol ve sorgu parametreleri düz, gövde body altında, Idempotency-Key idempotency_key olarak).

Parametreler ve örnekler için API başvurusuna bakın.

Mesajlar

AraçNe yaparKapsamTür
sendMessageBir kişiye mesaj gönderirmessages:sendyazma, dış etkili
listMessagesBir sohbetin mesajlarını yeniden eskiye listelerreadsalt okunur
retryMessageBaşarısız mesajı yeniden denerconversations:writeyazma, dış etkili
rateAiReplyAI yanıtını değerlendirirconversations:writeyazma

Botlar

AraçNe yaparKapsamTür
listBotsOrganizasyonun botlarını listelerreadsalt okunur
createBotBot oluştururbots:writeyazma
listBotTemplatesGaleri şablonlarını listelerbots:readsalt okunur
createBotDraftAI ile bot taslağı üretir (kayıt yapmaz)bots:writeyazma, dış etkili
importBotBot dosyasından yeni taslak bot oluştururbots:writeyazma
previewBotImportBot dosyasını doğrular, kaydetmezbots:writeyazma
getBotBot ayrıntısıbots:readsalt okunur
updateBotBot ve AI ayarlarını güncellerbots:writeyazma
deleteBotBotu silerbots:writeyazma, dış etkili, geri alınamaz
connectBotBotu kanala bağlarbots:writeyazma, dış etkili
disconnectBotKanal bağlantısını kaldırırbots:writeyazma, dış etkili, geri alınamaz
pauseBotBotu duraklatırbots:writeyazma, dış etkili
resumeBotBotu sürdürürbots:writeyazma, dış etkili
getBotReadinessCanlıya hazırlık denetimibots:readsalt okunur
exportBotBot dosyasını dışa aktarırbots:readsalt okunur
testBotReplyAI yanıtını denerbots:writeyazma
listKnowledgeSourcesBilgi kaynaklarını listelerbots:readsalt okunur
createKnowledgeSourceBilgi kaynağı eklerbots:writeyazma, dış etkili
getKnowledgeSourceBilgi kaynağının içeriğibots:readsalt okunur
updateKnowledgeSourceBilgi kaynağını güncellerbots:writeyazma
deleteKnowledgeSourceBilgi kaynağını silerbots:writeyazma, geri alınamaz
refreshKnowledgeSourceURL kaynağını yeniden çekerbots:writeyazma, dış etkili
listBotToolsÖzel AI araçlarını listelerbots:readsalt okunur
createBotToolÖzel AI aracı eklerbots:writeyazma, dış etkili
updateBotToolÖzel AI aracını güncellerbots:writeyazma, dış etkili
deleteBotToolÖzel AI aracını silerbots:writeyazma, geri alınamaz
testBotToolÖzel aracı örnek girdiyle çağırırbots:writeyazma, dış etkili
listBotVersionsYapılandırma sürümlerini listelerbots:readsalt okunur
getBotVersionSürüm farkı ve geri alma önizlemesibots:readsalt okunur
restoreBotVersionSürüme geri dönerbots:writeyazma, geri alınamaz
getBotProfileKanal vitrin metinleribots:readsalt okunur, dış etkili
updateBotProfileVitrin metinlerini kanala yazarbots:writeyazma, dış etkili, geri alınamaz
suggestBotProfileAI ile vitrin önerisi üretirbots:writeyazma
listBotEvalCasesAI değerlendirme vakalarını listelerbots:readsalt okunur
createBotEvalCaseDeğerlendirme vakası eklerbots:writeyazma
updateBotEvalCaseDeğerlendirme vakasını güncellerbots:writeyazma
deleteBotEvalCaseDeğerlendirme vakasını silerbots:writeyazma, geri alınamaz
listBotEvalRunsDeğerlendirme çalıştırmalarını listelerbots:readsalt okunur
runBotEvalDeğerlendirme çalıştırırbots:writeyazma
getBotEvalRunÇalıştırma sonuçlarıbots:readsalt okunur
listAcquisitionLinksEdinme bağlantılarını listelerbots:readsalt okunur
createAcquisitionLinkEdinme bağlantısı oluştururbots:writeyazma
deleteAcquisitionLinkEdinme bağlantısını silerbots:writeyazma, geri alınamaz
listWhatsAppTemplatesBütün WhatsApp şablonlarıbots:readsalt okunur, dış etkili
createWhatsAppTemplateWhatsApp şablonu oluştururbots:writeyazma, dış etkili
deleteWhatsAppTemplateWhatsApp şablonunu silerbots:writeyazma, dış etkili, geri alınamaz
listAiFeedbackBeğenilmeyen AI yanıtlarını listelerbots:readsalt okunur
resolveAiFeedbackBeğenilmeyen yanıtı çözerbots:writeyazma
listTemplatesWhatsApp botunun onaylı şablonlarıreadsalt okunur
refreshBotWebhookTelegram webhook'unu yeniden kurarbots:writeyazma, dış etkili
setBotCommandsTelegram komut menüsünü kurbots:writeyazma, dış etkili
getBotPaymentSettingsKartla ödeme ayarını getirbots:readsalt okunur
updateBotPaymentSettingsKartla ödeme sağlayıcı token'ını kaydetbots:writeyazma
listPublishApprovalsOnay bekleyen değişiklikleri listelerbots:readsalt okunur
approveBotVersionBekleyen bot değişikliğini onaylarbots:writeyazma
rejectBotVersionBekleyen bot değişikliğini reddederbots:writeyazma
bulkBotActionBirden çok botta toplu işlembots:writeyazma, dış etkili
runAllBotEvaluationsTüm botlarda değerlendirme setini çalıştırırbots:writeyazma
getFleetEvaluationFilo değerlendirme özetibots:readsalt okunur
listOrgBotTemplatesOrganizasyon bot şablonlarını listelerbots:readsalt okunur
createOrgBotTemplateBotu şablon olarak kaydederbots:writeyazma
getOrgBotTemplateOrganizasyon şablonunu getirirbots:readsalt okunur
updateOrgBotTemplateŞablonun adını ve açıklamasını değiştirirbots:writeyazma
deleteOrgBotTemplateŞablonu silerbots:writeyazma, geri alınamaz
createBotFromOrgTemplateŞablondan bot oluştururbots:writeyazma
listWhatsAppAccountsWhatsApp hesaplarını listelerbots:readsalt okunur
getWhatsAppAccountWhatsApp hesabını getirirbots:readsalt okunur
listWhatsAppAccountTemplatesWhatsApp hesabının şablonlarını listelerbots:readsalt okunur

Kişiler

AraçNe yaparKapsamTür
listContactsKişileri en yeniden eskiye listelerreadsalt okunur
createContactKişi eklercontacts:writeyazma
getContactTek kişiyi döner (etiket, not ve özel alanlar dahil)readsalt okunur
updateContactAd, not, etiket ve özel alanları güncellerwriteyazma
deleteContactKişiyi kalıcı olarak siler (KVKK)contacts:writeyazma, geri alınamaz
getContactConsentGüncel izin ve izin geçmişi (en yeni önce, en fazla 50)readsalt okunur
updateContactConsentİletişim iznini (ve isteğe bağlı etiketleri) güncellerwriteyazma, geri alınamaz
importContactsCSV metninden kişileri içe aktarırcontacts:writeyazma
exportContactsKişileri CSV parçaları hâlinde dışa aktarırcontacts:readsalt okunur
bulkContactsKişilere toplu işlem uygularcontacts:writeyazma, geri alınamaz
clearContactMemoryKişinin AI hafızasını temizlercontacts:writeyazma, geri alınamaz
revokeContactLinksKişiye gönderilmiş bağlantıları iptal edercontacts:writeyazma, geri alınamaz
linkContactProfileKaydı başka bir kayıtla aynı müşteri profiline bağlarcontacts:writeyazma
unlinkContactProfileKaydı müşteri profilinden ayırırcontacts:writeyazma, geri alınamaz
listContactTagsEtiketleri kullanım sayılarıyla listelercontacts:readsalt okunur
renameContactTagEtiketi yeniden adlandırırcontacts:writeyazma, geri alınamaz
mergeContactTagsEtiketleri tek etikette birleştirircontacts:writeyazma, geri alınamaz
deleteContactTagsEtiketleri bütün kişilerden kaldırırcontacts:writeyazma, geri alınamaz
listContactFieldsÖzel alan tanımlarını listelercontacts:readsalt okunur
createContactFieldÖzel alan oluştururcontacts:writeyazma
updateContactFieldÖzel alanı güncellercontacts:writeyazma, geri alınamaz
deleteContactFieldÖzel alanı silercontacts:writeyazma, geri alınamaz

Sohbetler

AraçNe yaparKapsamTür
listConversationsSohbetleri son mesaja göre listelerreadsalt okunur
updateConversationStatusSohbet durumunu değiştirirwriteyazma, dış etkili
getConversationSohbet ayrıntısıconversations:readsalt okunur
assignConversationSohbeti ekip üyesine atarconversations:writeyazma, dış etkili
markConversationReadSohbeti okundu işaretlerconversations:writeyazma
snoozeConversationSohbeti ertelerconversations:writeyazma
clearConversationFloodMesaj seli duraklatmasını kaldırırconversations:writeyazma
replyToConversationTemsilci yanıtı gönderirmessages:sendyazma, dış etkili
listConversationNotesDahili notları listelerconversations:readsalt okunur
createConversationNoteDahili not eklerconversations:writeyazma
deleteConversationNoteDahili notu silerconversations:writeyazma, geri alınamaz
bulkConversationsSohbetlerde toplu işlem yaparconversations:writeyazma, dış etkili

Kampanyalar

AraçNe yaparKapsamTür
listCampaignsKampanyaları listelereadsalt okunur
createCampaignKampanya oluştur (onay bekler)writeyazma, dış etkili
getCampaignKampanya ve varyant sonuçlarıreadsalt okunur
updateCampaignBaşlamamış kampanyayı güncellercampaigns:writeyazma
deleteCampaignGönderilmemiş kampanyayı silercampaigns:writeyazma, geri alınamaz
cancelCampaignBitmemiş kampanyayı iptal etwriteyazma, geri alınamaz
getCampaignResultsVaryant sonuçları ve A/B kararıcampaigns:readsalt okunur
countCampaignAudienceSegmentle eşleşen izinli kişileri sayarcampaigns:readsalt okunur
getCampaignBestTimeÖnerilen gönderim saaticampaigns:readsalt okunur
listGrowthCampaignsBüyüme kampanyalarını listelercampaigns:readsalt okunur
createGrowthCampaignBüyüme kampanyası oluştururcampaigns:writeyazma
getGrowthCampaignBüyüme kampanyasını getirircampaigns:readsalt okunur
updateGrowthCampaignBüyüme kampanyasını güncellercampaigns:writeyazma
deleteGrowthCampaignBüyüme kampanyasını silercampaigns:writeyazma, geri alınamaz
getGrowthCampaignReportBüyüme kampanyası hunisi ve kaynak karşılaştırmasıcampaigns:readsalt okunur
addGrowthCampaignSourceKampanyaya kaynak bağlar ya da yeni bağlantı açarcampaigns:writeyazma, dış etkili
removeGrowthCampaignSourceKaynağı kampanyadan ayırırcampaigns:writeyazma, geri alınamaz

Mini App

AraçNe yaparKapsamTür
listMiniAppsMini App'leri listelereadsalt okunur
createMiniAppMini App oluştururminiapps:writeyazma
listMiniAppSubmissionsMini App gönderimleri ve siparişlerireadsalt okunur
getOrderSipariş ayrıntısıminiapps:readsalt okunur
updateOrderSipariş durumunu değiştirwriteyazma, dış etkili
getMiniAppMini App ayrıntısıminiapps:readsalt okunur
updateMiniAppDraftTaslağı güncellerminiapps:writeyazma
deleteMiniAppMini App'i silerminiapps:writeyazma, dış etkili, geri alınamaz
publishMiniAppTaslağı yayınlarminiapps:writeyazma, dış etkili
unpublishMiniAppYayından kaldırırminiapps:writeyazma, dış etkili
rollbackMiniAppÖnceki sürüme dönerminiapps:writeyazma, dış etkili
setMiniAppMenuButtonTelegram menü düğmesini ayarlarminiapps:writeyazma, dış etkili
listMiniAppVersionsSürümleri listelerminiapps:readsalt okunur
getMiniAppPreviewTaslak önizlemesiminiapps:readsalt okunur
listOrdersSiparişleri listelerminiapps:readsalt okunur
importMiniAppFeedÜrün beslemesini kataloğa aktarırminiapps:writeyazma, dış etkili, geri alınamaz
approveMiniAppVersionOnay bekleyen Mini App sürümünü yayınlarminiapps:writeyazma, dış etkili
rejectMiniAppVersionOnay bekleyen Mini App sürümünü reddederminiapps:writeyazma

Otomasyonlar

AraçNe yaparKapsamTür
listAutomationsOtomasyonları listelereadsalt okunur
createAutomationOtomasyon oluştururautomations:writeyazma
getAutomationOtomasyon ayrıntısıautomations:readsalt okunur
saveAutomationOtomasyonu kaydederautomations:writeyazma
updateAutomationOtomasyonu etkinleştir ya da durdurwriteyazma, geri alınamaz
deleteAutomationOtomasyonu silerautomations:writeyazma, geri alınamaz
listAutomationRunsOtomasyonun çalıştırmalarını listelerautomations:readsalt okunur

Webhook

AraçNe yaparKapsamTür
listWebhooksWebhook'ları listelereadsalt okunur
createWebhookWebhook oluşturwriteyazma, dış etkili
getWebhookWebhook ayrıntısıwebhooks:readsalt okunur
updateWebhookWebhook'u güncellerwebhooks:writeyazma, dış etkili
deleteWebhookWebhook'u silwriteyazma, geri alınamaz
enableWebhookKapanmış webhook'u yeniden açwriteyazma, dış etkili
listWebhookDeliveriesTeslim geçmişini listelerwebhooks:readsalt okunur
testWebhookTest olayı (ping) gönderirwebhooks:writeyazma, dış etkili

Sistem

AraçNe yaparKapsamTür
getUsagePlan ve bu ayın kullanımıreadsalt okunur

Özel Mini App

AraçNe yaparKapsamTür
listCustomMiniAppRequestsÖzel Mini App taleplerini listelerminiapps:readsalt okunur
createCustomMiniAppRequestÖzel Mini App talebi açarminiapps:writeyazma, dış etkili
getCustomMiniAppRequestÖzel Mini App talebi ayrıntısıminiapps:readsalt okunur
acceptCustomMiniAppQuoteTeklifi kabul ederminiapps:writeyazma, dış etkili, geri alınamaz
approveCustomMiniAppPreviewÖnizlemeyi onaylarminiapps:writeyazma, dış etkili, geri alınamaz
cancelCustomMiniAppRequestTalebi iptal ederminiapps:writeyazma, dış etkili, geri alınamaz

Hazır yanıtlar

AraçNe yaparKapsamTür
listSavedRepliesHazır yanıtları listelerconversations:readsalt okunur
createSavedReplyHazır yanıt eklerconversations:writeyazma
getSavedReplyHazır yanıt ayrıntısıconversations:readsalt okunur
updateSavedReplyHazır yanıtı güncellerconversations:writeyazma
deleteSavedReplyHazır yanıtı silerconversations:writeyazma, geri alınamaz

Raporlar

AraçNe yaparKapsamTür
getReportOverviewGenel rapor özetireports:readsalt okunur
getDeliveryTelemetryTeslim telemetrisireports:readsalt okunur
getAgentReportTemsilci performansıreports:readsalt okunur
getCsatReportMemnuniyet raporureports:readsalt okunur
getAiQualityReportAI kalite raporureports:readsalt okunur
getCohortReportKitle kohortlarıreports:readsalt okunur
getRevenueReportGelir atfı ve ROIreports:readsalt okunur
getUsageReportPlan ve kullanımreports:readsalt okunur
setReportCostKampanya ya da bağlantı maliyetini yazarcampaigns:writeyazma
importReportCostsReklam maliyetlerini içe aktarırcampaigns:writeyazma

Topluluklar

AraçNe yaparKapsamTür
listCommunitiesTelegram topluluklarını listelercommunities:readsalt okunur
getCommunityTopluluk ayrıntısıcommunities:readsalt okunur
updateCommunityTopluluk ayarlarını güncellercommunities:writeyazma
removeCommunityTopluluğu kaldırırcommunities:writeyazma, geri alınamaz
refreshCommunityMembersÜye sayısını Telegram'dan yenilercommunities:writeyazma, dış etkili
listCommunityInviteLinksDavet bağlantılarını listelercommunities:readsalt okunur
createCommunityInviteLinkDavet bağlantısı oluştururcommunities:writeyazma, dış etkili
revokeCommunityInviteLinkDavet bağlantısını iptal edercommunities:writeyazma, dış etkili, geri alınamaz

Planlı gönderiler

AraçNe yaparKapsamTür
listScheduledPostsPlanlı gönderileri listelercommunities:readsalt okunur
createScheduledPostGönderi planlar ya da hemen yayınlarcommunities:writeyazma, dış etkili
getPostCalendarAy takvimini gönderilerle dönercommunities:readsalt okunur
getScheduledPostPlanlı gönderi ayrıntısıcommunities:readsalt okunur
updateScheduledPostPlanlı gönderiyi düzenlercommunities:writeyazma
cancelScheduledPostPlanlı gönderiyi iptal edercommunities:writeyazma, geri alınamaz
publishScheduledPostGönderiyi hemen yayınlarcommunities:writeyazma, dış etkili
approveScheduledPostOnay bekleyen gönderiyi onaylarcommunities:writeyazma, dış etkili
rejectScheduledPostOnay bekleyen gönderiyi reddedercommunities:writeyazma
resendUncertainPostSonucu belirsiz gönderiyi yeniden gönderircommunities:writeyazma, dış etkili

Organizasyon

AraçNe yaparKapsamTür
getOrganizationOrganizasyon ayarlarını getirirorganization:readsalt okunur
updateOrganizationOrganizasyon ayarlarını güncellerorganization:writeyazma, dış etkili, geri alınamaz
getContentPolicyİçerik politikasını getirirorganization:readsalt okunur
updateContentPolicyİçerik politikasını değiştirirorganization:writeyazma
getAiSettingsAI ayarlarını getirirorganization:readsalt okunur
updateAiSettingsAI ayarlarını güncellerorganization:writeyazma, dış etkili
listStoresMağaza bağlantılarını listelerorganization:readsalt okunur
saveStoreMağaza bağlantısını kaydederorganization:writeyazma, dış etkili
deleteStoreMağaza bağlantısını kaldırırorganization:writeyazma, geri alınamaz
testStoreMağaza bağlantısını sınarorganization:writeyazma, dış etkili
listCrmConnectionsCRM bağlantılarını listeleorganization:readsalt okunur
saveCrmConnectionCRM bağlantısını kaydetorganization:writeyazma, dış etkili
deleteCrmConnectionCRM bağlantısını kaldırorganization:writeyazma, geri alınamaz
testCrmConnectionCRM bağlantısını sınaorganization:writeyazma, dış etkili
listConnectionsBağlantıları listelerorganization:readsalt okunur

Medya

AraçNe yaparKapsamTür
listMediaMedya kütüphanesini listelerorganization:readsalt okunur
uploadMediaGörsel yüklerorganization:writeyazma
getMediaUsageGörselin kullanıldığı yerleri getirirorganization:readsalt okunur
deleteMediaGörseli silerorganization:writeyazma, geri alınamaz

Denetim

AraçNe yaparKapsamTür
listAuditLogsDenetim kaydını listelerorganization:readsalt okunur

Ekip

AraçNe yaparKapsamTür
listTeamMembersEkip üyelerini listelerteam:readsalt okunur
updateTeamMemberÜyenin rolünü ve bot erişimini değiştirirteam:writeyazma, geri alınamaz
removeTeamMemberÜyeyi ekipten çıkarırteam:writeyazma, geri alınamaz
listTeamInvitationsBekleyen davetleri listelerteam:readsalt okunur
createTeamInvitationEkibe davet gönderirteam:writeyazma, dış etkili
cancelTeamInvitationDaveti iptal ederteam:writeyazma, geri alınamaz

API anahtarları

AraçNe yaparKapsamTür
listApiKeysAPI anahtarlarını listelerapi_keys:readsalt okunur
revokeApiKeyAPI anahtarını iptal ederapi_keys:writeyazma, dış etkili, geri alınamaz
listConnectedAppsOAuth ile bağlı uygulamaları listelerapi_keys:readsalt okunur
revokeConnectedAppBağlı uygulamanın erişimini kaldırırapi_keys:writeyazma, dış etkili, geri alınamaz
getApiRequestLogAPI istek günlüğüapi_keys:readsalt okunur

Abonelik

AraçNe yaparKapsamTür
getBillingPlan, limit, kullanım ve abonelik durumunu getirirorganization:readsalt okunur