Entegrasyonlar
Entegrasyonlar, harici hizmetlere bağlanarak sesli ajanlarınızı genişletir. Bu bölüm, tüm kullanılabilir entegrasyonları ve bunların nasıl yapılandırılacağını kapsar.
Kullanılabilir Entegrasyonlar
| Entegrasyon | Amaç | Durum | Planlar |
|---|---|---|---|
| Telefon Numaraları | Telefon numaraları ve çağrılar | Kullanılabilir | Tümü |
| SIP Trunk | Kendi operatörünüzü getirin (sipgate, Placetel, TENIOS, easybell, Zadarma, Twilio BYO, Telnyx, Özel) | Kullanılabilir | Tümü — uyumluluk onayı gerektirir |
| Google Calendar | Google üzerinden randevu planlama | Kullanılabilir | Tümü |
| Outlook Calendar | Microsoft Outlook üzerinden randevu planlama | Kullanılabilir | Tümü |
| eTermin | Müsaitliği kontrol edin ve randevuları canlı olarak alın/erteleyin/iptal edin — bkz. eTermin | Kullanılabilir | Tümü |
| resmio | Restoran masalarını canlı olarak rezervasyon defterinize alın — bkz. resmio | Kullanılabilir | Tümü |
| HubSpot CRM | Sesli ajanınızdan kişileri ve anlaşmaları okuyun/yazın | Kullanılabilir | Tümü |
| MCP sunucuları | Kendi MCP uyumlu araç sunucunuzu getirin ve araçlarını ajanlara sunun — bkz. MCP Sunucuları | Kullanılabilir | Tümü |
| API Anahtarları | Harici uygulama erişimi | Kullanılabilir | Tümü |
| Web Kancaları | Gerçek zamanlı olay bildirimleri | Kullanılabilir | Tümü |
Takvim entegrasyonları, SIP, HubSpot, MCP sunucuları, API erişimi ve web kancaları Free dahil tüm planlarda kullanılabilir. SIP trunking, bağlantı sihirbazının kilidi açılmadan önce bir kerelik 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ı
- Kenar çubuğunda Telefon Numaraları bölümüne gidin
- "Numara Satın Al" düğmesine tıklayın
- Ülke ve numara türünü seçin
- Satın alımı tamamlayın
- Numaraya bir ajan atayın
Numaralar, satın alma sonrasında otomatik olarak yapılandırılır ve kullanıma hazırdır.
SIP Trunk Entegrasyonu
Kendi SIP operatörünüzü getirin — HANC yerel olarak SIP konuşur ve gelen çağrıları sesli ajanınıza (ve giden çağrıları trunk'ınız üzerinden geri) yönlendirir. Bir kerelik uyumluluk onayından sonra Free dahil tüm planlarda kullanılabilir.
Desteklenen Operatörler
HANC, aşağıdaki operatörler için ayarlanmış bağdaştırıcılara ve diğer her şey için genel bir seçeneğe sahiptir:
| Operatör | API ile numaraları otomatik içe aktarma | Notlar |
|---|---|---|
| sipgate | Evet (Kişisel Erişim Belirteci) | AB SIP trunking |
| Placetel | Elle | Alman VoIP, Webportal kimlik bilgileri |
| TENIOS | Elle | Avrupa SIP |
| easybell | Elle | Alman operatör, Kundencenter kimlik bilgileri |
| Zadarma | Evet (isteğe bağlı API anahtarı) | Küresel numaralar |
| Twilio (BYO) | Evet | Account SID + Auth Token |
| Telnyx | Evet | API tabanlı SIP ve DID'ler |
| Özel SIP trunk | Elle | Diğer herhangi bir sağlayıcı — ana bilgisayar, bağlantı noktası, taşıma 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'i Bağla düğmesi, desteklenen tüm operatörleri mailto:support@hanc.ai eylem çağrısıyla listeleyen bir tanıtım penceresi açar. Onay genellikle aynı iş günü içinde verilir.
Kurulum Adımları (onaydan sonra)
- Telefon Numaraları → SIP'i Bağla bölümüne gidin.
- Operatörünüzü seçin.
- SIP kimlik bilgilerini (ve operatörünüz otomatik içe aktarmayı destekliyorsa isteğe bağlı API anahtarı/gizli anahtarı) girin.
- Özel SIP için ayrıca ana bilgisayar, bağlantı noktası (varsayılan 5060) ve taşımayı (UDP / TCP / TLS) sağlayın.
- Bağla düğmesine tıklayın — HANC, SIP kullanıcınızı kaydeder ve destekleniyorsa telefon numaralarınızı listeler.
- İçe aktarılacak numaraları seçin (veya E.164 ile elle ekleyin).
- Her numaraya bir gelen ve/veya giden ajan atayın.
SIP ne zaman, Numara Satın Alma ne zaman?
| Senaryo | Öneri |
|---|---|
| Telefon hizmetinde yeni | HANC üzerinden numara satın alın (daha basit — uyumluluk adımı yok) |
| Mevcut PBX veya operatör sözleşmesi | SIP ile bağlanın — numaranızı koruyun |
| Katı operatör gereksinimleri olan kurumsal telefon | Tam kontrol için SIP |
| Birden fazla bölge / numara havuzu | Esneklik için SIP |
Google Calendar Entegrasyonu
Sesli ajanlarınızın çağrılar sırasında müsaitliği kontrol edip randevu almasını sağlamak için Google Calendar'ı bağlayın.
Kurulum Adımları
- Entegrasyon → Takvimler bölümüne gidin
- "Google Calendar'ı Bağla" düğmesine tıklayın
- Google ile oturum açın
- Hanc.AI erişimini yetkilendirin
İ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:
| Ayar | Açıklama |
|---|---|
| calendar_id | Planlama için hangi Google Takvim'in kullanılacağı |
| timezone | Randevu planlama için saat dilimi (ör. Europe/Vienna) |
| work_hours | Rezervasyon için uygun saatler (ör. Pazartesi-Cuma 9:00-18:00) |
| slot_duration | Varsayılan randevu uzunluğu (ör. 30 dakika) |
| buffer | Randevular arasındaki tampon süre (ör. 15 dakika) |
Ajanlarda Takvim Kullanımı
Bağlandıktan ve yapılandırıldıktan sonra, ajanlar şunları yapabilir:
- Belirli tarih ve saatler için müsaitliği kontrol etme
- Randevuları otomatik olarak alma
- Çalışma saatlerine ve tampon sürelerine uyma
- Erteleme isteklerini ele alma
Örnek görüşme:
Müşteri: "Salı saat 15:00 için bir randevu alabilir miyim?"
Ajan: [Takvimi kontrol eder]
"Evet, Salı saat 15:00 uygun.
Rezervasyonu tamamlamak için adınızı alabilir miyim?"
Outlook Calendar Entegrasyonu
Sesli ajanlarınız aracılığıyla randevu planlamayı etkinleştirmek için Microsoft Outlook Calendar'ı bağlayın.
Kurulum Adımları
- Entegrasyon → Takvimler bölümüne gidin
- "Outlook Calendar'ı Bağla" düğmesine tıklayın
- Microsoft hesabınızla oturum açın
- Hanc.AI erişimini yetkilendirin
İ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:
| Ayar | Açıklama |
|---|---|
| Takvim | Planlama için hangi Outlook takviminin kullanılacağı |
| Saat dilimi | Randevu planlama için saat dilimi (ör. Europe/Vienna) |
| Çalışma saatleri | Rezervasyon için uygun saatler (ör. Pazartesi-Cuma 9:00-18:00) |
| Zaman dilimi süresi | Varsayılan randevu uzunluğu (ör. 30 dakika) |
| Tampon | Randevular arasındaki tampon süre (ör. 15 dakika) |
Google Calendar'dan Farkları
Her iki takvim entegrasyonu da ajanın bakış açısından aynı şekilde çalışır. Tek fark oturum açma sürecidir — zaten kullandığınız hangi takvim hizmetiyse onu seçin.
Google ve 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. Tekrar aramaya gerek kalmadan randevularını doğrudan iptal edebilirler.
eTermin Randevu Alma
Sesli ajanlarınızın, doğrudan eTermin takvimlerinize ve hizmetlerinize, çift rezervasyona karşı yerleşik korumayla, görüşme sırasında müsaitliği kontrol edip randevu alması, ertelemesi veya iptal etmesi için eTermin'i bağlayın. Randevularınız zaten eTermin'de yaşadığında ve kendi süreleri ve kuralları olan farklı hizmetler sunduğunuzda, düz bir takvim yerine eTermin kullanın.
Bağlantı adımları, ajan bazında yapılandırma ve çift rezervasyon koruması için tam eTermin sayfasına bakın.
resmio Masa Rezervasyonları
Ajanlarınızın bir görüşme sırasında — zamana ve kişi sayısına göre gerçek müsaitliği kontrol ederek, ertelemeleri ve iptalleri ele alarak — doğrudan rezervasyon defterinize restoran masaları rezerve etmesi için resmio'yu bağlayın. Restoranınız zaten rezervasyonları resmio üzerinden aldığında resmio kullanın.
Bağlantı adımları ve ayrıntılar için tam resmio sayfasına bakın.
İş Akışlarında Bağlı Hesaplar Aracılığıyla İşlem Yapma
Bir ajanın canlı bir çağrı sırasında kullandığı her zaman açık araçların ötesinde, iş akışlarının özel bir Entegrasyon adımı vardır (v2.8'de eklendi). Bir iş akışına Entegrasyon adımı bırakarak onun tek bir adımda bağlı bir Google Calendar, Outlook veya HubSpot hesabı aracılığıyla işlem yapmasını sağlayın — örneğin, daha büyük bir otomatik akışın parçası olarak bir takvim etkinliği oluşturmak veya bir HubSpot anlaşmasını güncellemek. Adım, bu sayfada kurduğunuz aynı hesap düzeyindeki bağlantıları kullanır; bu nedenle ek olarak yetki vermeniz gereken bir şey yoktur.
HubSpot CRM Entegrasyonu
Sesli ajanlarınızın görüşme sırasında kişileri ve anlaşmaları okuyup yazması ve HANC'nin yerleşik CRM'inin HubSpot iş hatlarınızı yansıtabilmesi için HubSpot çalışma alanınızı bağlayın.
Neyi Etkinleştirir
- Canlı araç —
HubSpot CRMajanın Eylemler sekmesinde. Ajan, arayanı telefonla bir HubSpot kişisiyle eşleştirebilir, anlaşma aşamasını getirebilir ve canlı görüşmeden özellikleri güncelleyebilir. Bkz. Eylemler ve Araçlar. - HANC'nin CRM'inde iş hattı yansıtma. HubSpot anlaşma aşamalarınız Anlaşmalar kanban panosunda görünür; böylece çağrıları ve HubSpot bağlamını yan yana görebilirsiniz.
- İş hattı bazında AI anahtarı — AI'ın hangi HubSpot iş hatlarında işlem yapmasına izin verildiğine karar verin; diğer her şey yalnızca okunabilir kalır.
Kurulum Adımları
- Entegrasyonlar sayfasını açın ve HubSpot'u Bağla düğmesine tıklayın.
- HubSpot hesabınızda HANC'yi yetkilendirin.
- Hangi iş hatlarının yansıtılacağını (CRM → İş hattı ayarları altında görünür) ve hangilerinin ajan aşama güncellemelerine izin vereceğini seçin.
- Görüşme sırasında HubSpot'a dokunması gereken herhangi bir ajana HubSpot CRM aracını ekleyin.
HANC'nin CRM'ini kullanmak için HubSpot kullanmanız gerekmez. Yerleşik CRM bağımsız çalışır — HubSpot entegrasyonu, yalnızca zaten HubSpot içinde yaşayan ve her iki dünyayı da senkronize etmek 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. MCP uyumlu bir sunucu çalıştırıyorsanız, onu Entegrasyon sayfasında bir kez kaydedebilir ve ajanlarınızın araçlarını görüşme ortasında çağırmasını sağlayabilirsiniz.
Kurulum Adımları (genel bakış)
- Entegrasyon → MCP sunucuları bölümüne gidin.
- MCP sunucusu bağla düğmesine tıklayın, bir etiket ve sunucunuzun HTTPS URL'sini girin, kimlik doğrulamayı (Yok veya Bearer belirteci) seçin ve kaydedin.
- Araçları kullanmak istediğiniz ajanı açın, Eylemler → Eylem Ekle → MCP sunucuları bölümüne gidin ve bu ajanın kullanması gereken bağlantıları açın.
Ajan, sunucunun araçlarını her çağrının başında keşfeder ve kullanır.
Ayrıntılı kurulum, sorun giderme ve MCP'nin yerleşik araçların yanında nasıl yer aldığı 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.
- Entegrasyon → API Anahtarları bölümüne gidin
- "API Anahtarı Oluştur" düğmesine tıklayın
- Bir ad girin (ör. "CRM Entegrasyonu")
- İzinleri ayarlayın (okuma, yazma, yönetici)
- Anahtarı hemen kopyalayın (yalnızca bir kez gösterilir)
API Anahtarı Güvenliği
- Anahtarları güvenli bir şekilde saklayın (ortam değişkenleri, gizli anahtar yöneticisi)
- Anahtarları asla sürüm denetimine kaydetmeyin
- Anahtarları periyodik olarak döndürün
- Kullanılmayan anahtarları silin
API Anahtarlarını Kullanma
API isteklerine dahil edin:
curl -X GET "https://api.hanc.ai/v1/agent/list" \
-H "x-api-key: YOUR_API_KEY"
API Anahtarı İzinleri
| İzin | Erişim |
|---|---|
| Okuma | Ajanları, çağrıları, analizleri görüntüleme |
| Yazma | Ajan oluşturma/değiştirme, bilgi tabanı yükleme |
| Yönetici | Tüm işlemler, silme, ayarlar |
Kullanılabilir uç noktalar
Kaynağa göre gruplanmış (Çağrılar, Ajanlar, Bilgi Tabanı, Telefon Numaraları, Sesler, Abonelik, Müşteriler, Çalışma Alanları) API uç noktalarının tam listesi kendi sayfasında bulunur:
Web Kancaları
Hanc.AI hesabınızdaki olaylar hakkında gerçek zamanlı bildirimler almak için web kancalarını yapılandırın.
Kurulum
- Entegrasyon → Web Kancaları bölümüne gidin
- Web kancası uç nokta URL'nizi girin
- Abone olunacak olayları seçin
- Yapılandırmayı kaydedin
Web kancaları, uç noktanıza JSON biçiminde olay verileriyle birlikte HTTP POST istekleri gönderir.
Çağrı Sonrası Eylemler
Çağrı sonrası eylemler, bir sesli ajan görüşmesi sona erdikten sonra otomatik olarak tetiklenir. Bunları tek tek ajanlarda yapılandırın.
Kullanılabilir Eylem Türleri
| Eylem | Açıklama |
|---|---|
| E-posta | Çağrının bir e-posta özetini gönderin (işletme sahibine, müşteriye veya her ikisine) |
| SMS | Çağrıdan sonra bir SMS bildirimi gönderin |
| Ç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
- Sesli Ajanlar → ajanınızı seçin bölümüne gidin
- Eylemler sekmesini açın
- "Eylem Ekle" düğmesine tıklayın
- Eylem türünü seçin ve yapılandırın:
- Tetikleyici: Eylemin ne zaman tetikleneceği (ör. her çağrıdan sonra, yalnızca belirli sonuçlarda)
- Alıcılar: Bildirimi kimin alacağı
- İçerik: Çağrı verisi değişkenleriyle mesaj şablonu
Özel Entegrasyonlar
API'yi Kullanma
Hanc.AI API'sini kullanarak özel entegrasyonlar oluşturun:
Base URL: https://api.hanc.ai/v1
Authentication: Bearer token (API key)
Format: JSON
API Belgeleri
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 bir şekilde saklayın
- API anahtarlarını düzenli olarak döndürün
- İzinleri gereken en aza indirin
Güvenilirlik
- Tüm entegrasyon olaylarını günlüğe kaydedin
- Entegrasyon durumunu izleyin
Test Etme
- Entegrasyonları önce hazırlık ortamında test edin
- Veri akışını her iki yönde doğrulayın
- Hata senaryolarını test edin
- Entegrasyon kurulumunu belgeleyin
Sorun Giderme
Entegrasyon bağlanmıyor
- Kimlik bilgilerinin doğru olduğunu doğrulayın
- Yazım hatalarını kontrol edin
- Üçüncü taraf hesabın etkin olduğundan emin olun
- Bağlantıyı kesip yeniden bağlamayı deneyin
Takvim senkronize olmuyor
- Takvim erişimini yeniden yetkilendirin
- Takvim izinlerini kontrol edin
- Seçilen takvimin doğru olduğunu doğrulayın
- Senkronizasyon gecikmelerini kontrol edin (5 dakikaya kadar)
İlgili Konular
- Telefon Numaraları — Telefon numarası yönetimi
- Sesli Ajanlar — Ajanlarda entegrasyon kullanma
- Analizler — Entegrasyon olay izleme