Ana içeriğe geç
DocumentationAPI ReferenceVideo Tutorials

Entegrasyonlar

Entegrasyonlar, AI sesli ajanlarınızı harici hizmetlere bağlayarak genişletir. Bu bölüm, mevcut tüm entegrasyonları ve bunları nasıl yapılandıracağınızı kapsar.

Mevcut Entegrasyonlar​

EntegrasyonAmaçDurumPlanlar
Telefon NumaralarıTelefon numaraları ve çağrılarMevcutTümü
SIP TrunkKendi operatörünüzü getirin (sipgate, Placetel, TENIOS, easybell, Zadarma, Twilio BYO, Telnyx, Özel)MevcutTümü — uyumluluk onayı gerektirir
Google CalendarGoogle üzerinden randevu planlamaMevcutTümü
Outlook CalendarMicrosoft Outlook üzerinden randevu planlamaMevcutTümü
HubSpot CRMAI sesli ajanınızdan kişileri ve fırsatları okuyun/yazınMevcutTümü
MCP sunucularıKendi MCP uyumlu araç sunucunuzu getirin ve araçlarını ajanlara sunun — MCP Sunucuları bölümüne bakınMevcutTümü
API AnahtarlarıHarici uygulama erişimiMevcutTümü
Webhook'larGerçek zamanlı olay bildirimleriMevcutTümü
Tüm Planlar

Takvim entegrasyonları, SIP, HubSpot, MCP sunucuları, API erişimi ve webhook'lar Free dahil tüm planlarda mevcuttur. SIP trunking, bağlantı sihirbazının kilidi açılmadan önce bir kez yapılacak uyumluluk onayı gerektirir.

Telefon Numarası Kurulumu​

Telefon numaraları, ajanlarınızın gerçek telefon çağrıları almasına ve yapmasına olanak tanır.

Kurulum Adımları​

  1. Kenar çubuğunda Telefon Numaraları'na gidin
  2. "Numara Satın Al" seçeneğine tıklayın
  3. Ülke ve numara türü seçin
  4. Satın almayı tamamlayın
  5. Numaraya bir ajan atayın

Numaralar satın alındıktan sonra otomatik olarak yapılandırılır ve kullanıma hazırdır.

SIP Trunk Entegrasyonu​

Kendi SIP operatörünüzü getirin — HANC, SIP'yi yerel olarak konuşur ve gelen çağrıları AI sesli ajanınıza yönlendirir (ve giden çağrıları trunk'ınız üzerinden geri). Bir kez yapılacak uyumluluk onayından sonra Free dahil tüm planlarda mevcuttur.

Desteklenen Operatörler​

HANC, aşağıdaki operatörler için ayarlanmış adaptörlere ve diğerleri için genel bir seçeneğe sahiptir:

OperatörAPI ile otomatik numara içe aktarmaNotlar
sipgateEvet (Kişisel Erişim Token'ı)AB SIP trunking
PlacetelManuelAlman VoIP, Webportal kimlik bilgileri
TENIOSManuelAvrupa SIP
easybellManuelAlman operatörü, Kundencenter kimlik bilgileri
ZadarmaEvet (isteğe bağlı API anahtarı)Global numaralar
Twilio (BYO)EvetAccount SID + Auth Token
TelnyxEvetAPI güdümlü SIP ve DID'ler
Özel SIP trunkManuelDiğer herhangi bir sağlayıcı — host, port, transport sağlayın

Uyumluluk Onayı​

SIP operatör bağlantıları, giden kampanyalarla aynı uyumluluk akışını paylaşır. Hesabınız onaylanana kadar, SIP Bağla düğmesi mailto:support@hanc.ai CTA içeren tüm desteklenen operatörleri listeleyen bir tanıtım modalı açar. Onay genellikle aynı iş gününde verilir.

Kurulum Adımları (onaydan sonra)​

  1. Telefon Numaraları → SIP Bağla bölümüne gidin.
  2. Operatörünüzü seçin.
  3. SIP kimlik bilgilerini (ve operatörünüz otomatik içe aktarmayı destekliyorsa isteğe bağlı API anahtarı/secret) girin.
  4. Özel SIP için ayrıca host, port (varsayılan 5060) ve transport (UDP / TCP / TLS) sağlayın.
  5. Bağla'ya tıklayın — HANC, SIP kullanıcınızı kaydeder ve desteklendiği yerlerde telefon numaralarınızı listeler.
  6. İçe aktarılacak numaraları seçin (veya E.164 ile manuel olarak ekleyin).
  7. Her numaraya bir gelen ve/veya giden ajan atayın.

Ne Zaman SIP, Ne Zaman Numara Satın Almalı​

SenaryoÖneri
Telefon hizmetinde yeniHANC üzerinden numara satın alın (daha basit — uyumluluk adımı yok)
Mevcut PBX veya operatör sözleşmesiSIP ile bağlanın — numaranızı koruyun
Sıkı operatör gereksinimleri olan kurumsal telefonTam kontrol için SIP
Birden fazla bölge / numara havuzuEsneklik için SIP

Google Calendar Entegrasyonu​

AI sesli ajanlarınızın çağrılar sırasında müsaitliği kontrol etmesini ve randevu almasını sağlamak için Google Calendar'ı bağlayın.

Kurulum Adımları​

  1. Entegrasyon → Takvimler bölümüne gidin
  2. "Google Calendar'ı Bağla" seçeneğine tıklayın
  3. Google ile oturum açın
  4. Hanc.AI erişimine izin verin

İstenen izinler:

  • Takvim etkinliklerini görüntüleme (müsaitliği kontrol etmek için)
  • Takvim etkinlikleri oluşturma (randevu almak için)

Takvim Yapılandırması​

Bağlandıktan sonra, ajanınızda takvim aracını yapılandırın:

AyarAçıklama
calendar_idPlanlama için hangi Google Calendar'ın kullanılacağı
timezoneRandevu planlama için saat dilimi (örn. Europe/Vienna)
work_hoursRezervasyon için müsait saatler (örn. Pazartesi-Cuma 9:00-18:00)
slot_durationVarsayılan randevu uzunluğu (örn. 30 dakika)
bufferRandevular arası tampon süresi (örn. 15 dakika)

Ajanlarda Takvim Kullanımı​

Bağlanıp yapılandırıldıktan sonra, ajanlar şunları yapabilir:

  • Belirli tarih ve saatler için müsaitliği kontrol edin
  • Randevuları otomatik olarak alın
  • Çalışma saatlerine ve tampon sürelere saygı gösterin
  • Yeniden planlama isteklerini yönetin

Örnek konuşma:

Müşteri: "Salı saat 15:00 için bir randevu alabilir miyim?"

Ajan: [Takvimi kontrol eder]
       "Evet, Salı saat 15:00 müsait.
        Rezervasyonu tamamlamak için adınızı alabilir miyim?"

Outlook Calendar Entegrasyonu​

AI sesli ajanlarınız üzerinden randevu planlamayı etkinleştirmek için Microsoft Outlook Calendar'ı bağlayın.

Kurulum Adımları​

  1. Entegrasyon → Takvimler bölümüne gidin
  2. "Outlook Calendar'ı Bağla" seçeneğine tıklayın
  3. Microsoft hesabınızla oturum açın
  4. Hanc.AI erişimine izin verin

İstenen izinler:

  • Takvim etkinliklerini görüntüleme (müsaitliği kontrol etmek için)
  • Takvim etkinlikleri oluşturma (randevu almak için)

Takvim Yapılandırması​

Bağlandıktan sonra, ajanınızda takvim aracını yapılandırın:

AyarAçıklama
TakvimPlanlama için hangi Outlook takviminin kullanılacağı
Saat DilimiRandevu planlama için saat dilimi (örn. Europe/Vienna)
Çalışma SaatleriRezervasyon için müsait saatler (örn. Pazartesi-Cuma 9:00-18:00)
Yuva SüresiVarsayılan randevu uzunluğu (örn. 30 dakika)
TamponRandevular arası tampon süresi (örn. 15 dakika)

Google Calendar'dan Farkları​

Her iki takvim entegrasyonu da ajan açısından aynı şekilde çalışır. Tek fark oturum açma sürecidir — zaten hangi takvim hizmetini kullanıyorsanız onu seçin.

ipucu

Hem Google hem de Outlook takvimlerini aynı anda bağlayabilirsiniz, ancak her ajan yalnızca bir takvim aracı kullanabilir.

Randevuları İptal Etme​

Randevu alan arayanlar bir iptal bağlantısı alır. Geri aramaya gerek kalmadan randevularını doğrudan iptal edebilirler.

HubSpot CRM Entegrasyonu​

AI sesli ajanlarınızın çağrı sırasında kişileri ve fırsatları okuyup yazabilmesi ve HANC'ın yerleşik CRM'inin HubSpot boru hatlarınızı yansıtabilmesi için HubSpot çalışma alanınızı bağlayın.

Neyi Etkinleştirir​

  • Canlı araç — HubSpot CRM ajanın Eylemler sekmesinde. Ajan, arayanı telefonla bir HubSpot kişisiyle eşleştirebilir, fırsat aşamasını alabilir ve canlı konuşmadan özellikleri güncelleyebilir. Eylemler ve Araçlar bölümüne bakın.
  • HANC'ın CRM'inde boru hattı yansıtma. HubSpot fırsat aşamalarınız Fırsatlar kanban'ında görünür, böylece çağrıları ve HubSpot bağlamını yan yana görebilirsiniz.
  • Boru hattı başına AI düğmesi — AI'nın hangi HubSpot boru hatlarında işlem yapmasına izin verileceğine karar verin; diğer her şey salt okunur kalır.

Kurulum Adımları​

  1. Entegrasyonlar sayfasını açın ve HubSpot Bağla'ya tıklayın.
  2. HubSpot hesabınızda HANC'ı yetkilendirin.
  3. Hangi boru hatlarının yansıtılacağını (CRM → Boru Hattı ayarları altında görünür) ve hangilerinin ajan aşama güncellemelerine izin vereceğini seçin.
  4. Çağrı sırasında HubSpot'a dokunması gereken herhangi bir ajana HubSpot CRM aracını ekleyin.
ipucu

HANC'ın CRM'ini kullanmak için HubSpot kullanmak zorunda değilsiniz. Yerleşik CRM bağımsız çalışır — HubSpot entegrasyonu yalnızca zaten HubSpot'ta yaşayan ve her iki dünyayı senkronize tutmak isteyen kuruluşlar içindir.

MCP Sunucuları​

Model Context Protocol (MCP), AI asistanlarını harici araçlara bağlamak için açık bir standarttır. Bir MCP uyumlu sunucu çalıştırıyorsanız, Entegrasyon sayfasında bir kez kaydedebilir ve ajanlarınızın konuşma sırasında araçlarını çağırmasını sağlayabilirsiniz.

Kurulum Adımları (genel bakış)​

  1. Entegrasyon → MCP sunucuları bölümüne gidin.
  2. MCP sunucusu bağla'ya tıklayın, bir etiket ve sunucunuzun HTTPS URL'sini girin, kimlik doğrulamayı (Yok veya Bearer token) seçin ve kaydedin.
  3. Araçları kullanmak istediğiniz ajanı açın, Eylemler → Eylem Ekle → MCP sunucuları'na gidin ve bu ajanın kullanması gereken bağlantıları açın.

Ajan, her çağrının başında sunucunun araçlarını keşfedip kullanacaktır.

Ayrıntılı kurulum, sorun giderme ve MCP'nin yerleşik araçlarla nasıl uyum sağladığı için tam MCP Sunucuları sayfasına bakın.

API Anahtarları​

Hanc.AI'yi kendi uygulamalarınızla entegre etmek için API anahtarları oluşturun.

API Anahtarı Oluşturma​

Kullanıcı başına en fazla 3 API anahtarı oluşturabilirsiniz.

  1. Entegrasyon → API Anahtarları bölümüne gidin
  2. "API Anahtarı Oluştur" seçeneğine tıklayın
  3. Bir ad girin (örn. "CRM Entegrasyonu")
  4. İzinleri ayarlayın (okuma, yazma, yönetici)
  5. Anahtarı hemen kopyalayın (yalnızca bir kez gösterilir)

API Anahtarı Güvenliği​

Önemli
  • Anahtarları güvenli şekilde saklayın (ortam değişkenleri, secrets manager)
  • Anahtarları asla sürüm kontrolüne işlemeyin
  • Anahtarları periyodik olarak döndürün
  • Kullanılmayan anahtarları silin

API Anahtarlarını Kullanma​

API isteklerine ekleyin:

curl -X GET "https://api.hanc.ai/v1/agent/list" \
  -H "x-api-key: YOUR_API_KEY"

API Anahtarı İzinleri​

İzinErişim
OkumaAjanları, çağrıları, analitiği görüntüleme
YazmaAjanları oluşturma/değiştirme, KB yükleme
YöneticiTüm işlemler, silme, ayarlar

Mevcut uç noktalar​

Kaynak (Çağrılar, Ajanlar, Bilgi Tabanı, Telefon Numaraları, Sesler, Abonelik, Müşteriler, Çalışma Alanları) tarafından gruplandırılmış API uç noktalarının tam listesi kendi sayfasında bulunur:

→ Tam API Referansı

Webhook'lar​

Hanc.AI hesabınızdaki olaylar hakkında gerçek zamanlı bildirimler almak için webhook'ları yapılandırın.

Kurulum​

  1. Entegrasyon → Webhook'lar bölümüne gidin
  2. Webhook uç nokta URL'nizi girin
  3. Abone olunacak olayları seçin
  4. Yapılandırmayı kaydedin

Webhook'lar, JSON formatında olay verileriyle uç noktanıza HTTP POST istekleri gönderir.

Çağrı Sonrası Eylemler​

Çağrı sonrası eylemler, bir AI sesli ajan konuşması sona erdikten sonra otomatik olarak tetiklenir. Bunları bireysel ajanlarda yapılandırın.

Mevcut Eylem Türleri​

EylemAçıklama
E-postaÇağrının e-posta özetini gönderin (işletme sahibine, müşteriye veya her ikisine)
SMSÇağrıdan sonra bir SMS bildirimi gönderin
WhatsAppÇağrıdan sonra bir WhatsApp mesajı gönderin
API ÇağrısıÇağrı verileriyle harici bir uç noktaya HTTP isteği yapın

Kurulum​

  1. AI Sesli Ajanlar → ajanınızı seçin
  2. Eylemler sekmesini açın
  3. "Eylem Ekle" seçeneğine tıklayın
  4. Eylem türünü seçin ve yapılandırın:
    • Tetikleyici: Eylemin ne zaman tetikleneceği (örn. her çağrıdan sonra, yalnızca belirli sonuçlarda)
    • Alıcılar: Bildirimi kim alacak
    • İçerik: Çağrı verisi değişkenleri içeren mesaj şablonu

Özel Entegrasyonlar​

API'yi Kullanma​

Hanc.AI API'sini kullanarak özel entegrasyonlar oluşturun:

Temel URL: https://api.hanc.ai/v1
Kimlik Doğrulama: Bearer token (API anahtarı)
Format: JSON

API Dokümantasyonu​

Kullanılabilir uç noktaların tam listesi için API Referansı bölümüne bakın.

Entegrasyon En İyi Uygulamaları​

Güvenlik​

  • Kimlik bilgilerini güvenli şekilde saklayın
  • API anahtarlarını düzenli olarak döndürün
  • İzinleri gerekli olan minimuma sınırlayın

Güvenilirlik​

  • Tüm entegrasyon olaylarını günlüğe kaydedin
  • Entegrasyon sağlığını izleyin

Test Etme​

  • Önce hazırlık ortamında entegrasyonları test edin
  • Her iki yönde veri akışını doğrulayın
  • Hata senaryolarını test edin
  • Entegrasyon kurulumunu belgeleyin

Sorun Giderme​

Entegrasyon bağlanmıyor​

  1. Kimlik bilgilerinin doğru olduğunu doğrulayın
  2. Yazım hatalarını kontrol edin
  3. Üçüncü taraf hesabının aktif olduğundan emin olun
  4. Bağlantıyı kesip yeniden bağlanmayı deneyin

Takvim senkronize olmuyor​

  1. Takvim erişimini yeniden yetkilendirin
  2. Takvim izinlerini kontrol edin
  3. Seçilen takvimin doğru olduğunu doğrulayın
  4. Senkronizasyon gecikmelerini kontrol edin (5 dakikaya kadar)

İlgili Konular​