# API ve Geliştiriciler — Mihu AI API & Geliştiriciler # İnşa edin Mihu AI Platform AI sesli ve mesajlaşma ajanlarını uygulamalarınıza entegre etmek için RESTful API'ler, SDK'lar ve webhook'lar. Kapsamlı dokümanlar ve örneklerle daha hızlı geliştirin. Dokümantasyonu Görüntüle (https://developers.mihu.ai) API Konsolu (https://app.mihu.ai/) 99.9% API Çalışma Süresi <100ms Yanıt 50+ Endpoint'ler cURL Python Node.js REST API 1 # Giden arama başlat --request POST \ 3 --url https://demo.mihu.ai/api/v1/call \ 4 --header 'Authorization: Bearer ' \ 5 --header 'Content-Type: application/json' \ --data 7 "agentId" : "32d8fc98-be1e-4d32-..." , 8 "participant" : { 9 "number" : "+1 (415) 555-0123" , 10 "about" : "Müşteri John Doe" 11 } 12 }' requests 2 url = headers = { 5 "Authorization" : "Bearer " , 6 "Content-Type" : "application/json" 7 } data = { 9 "agentId" : "32d8fc98-be1e-4d32-..." , 10 "participant" : { "number" : "+1 (415) 555-0123" } 11 } 12 response = requests. post (url, headers=headers, json=data) 1 const response = await fetch ( 2 'https://demo.mihu.ai/api/v1/call' , 3 { 4 method : 'POST' , 5 headers : { 6 'Authorization' : 'Bearer ' , 7 'Content-Type' : 'application/json' 8 }, 9 body : JSON.stringify ({ 10 agentId : '32d8fc98-be1e-4d32-...' , 11 participant : { number : '+1 (415) 555-0123' } 12 }) 13 } 14 ); 201 Oluşturuldu Kopyala HIZLI BAŞLANGIÇ ## Dakikalar İçinde Çalışır Durumda Get started with the Mihu AI API in three simple steps. 1 ### API Token'ınızı Alın Panelinize giriş yapın ve isteğe bağlı son kullanma tarihi olan özel bir API token'ı oluşturun. : Bearer 2 ### Base URL'i Ayarlayın Tüm API istekleri bearer token'ınızla güvenli endpoint'imize yapılır. https://demo.mihu.ai/api/v1 3 ### İlk Aramanızı Yapın Ajanınızla giden bir arama başlatın ve konuşmaları otomatikleştirmeye başlayın. POST /call { agentId, participant } KİMLİK DOĞRULAMA ## Güvenli API Erişimi Choose between API keys for server-to-server or OAuth 2.0 for user-delegated access. ### API Anahtarları İsteklerinizi doğrulamak için API anahtarları oluşturun. Güvenli erişim için isteğe bağlı son kullanma tarihleriyle özel token'lar oluşturun. API Anahtarı Ekle API Anahtarının Adı Son Kullanma Tarihi Ayarla Süresiz Özel Token Oluştur •••••••••••••••••••••••••••••••• •••••••••••••••••••••••••••••••• ### OAuth 2.0 Kullanıcı yetkili erişim için endüstri standardı yetkilendirme. Pazaryeri entegrasyonları için mükemmel. 1 #### Yetkilendirmeye Yönlendir Kullanıcıları Mihu'nun onay ekranına gönderin GET /oauth/authorize?client_id=... 2 #### Yetkilendirme Kodu Al Kullanıcı izin verir, bir kod alırsınız ?code=abc123&state=xyz 3 #### Erişim Token'ı için Değiştir Kodu erişim token'ı ile takas edin POST /oauth/token API Referansı ## Kapsamlı Uç Nokta Dokümantasyonu Explore our RESTful API with detailed request/response examples for every endpoint. API Referansı Arama post /call WhatsApp post /whatsapp/template Randevular GET /appointments post /appointments Kişiler GET /contacts post /contacts Görevler GET /tasks post /tasks Kampanyalar GET /campaigns Zamanlamalar GET /schedules Transkriptler GET /transcriptions post /api/v1/call ### Giden Arama Başlat Belirtilen bir AI ajanı kullanarak giden arama başlatır. Ajan, katılımcı numarasını arayacak ve yapılandırılmış prompt talimatlarını takip edecektir. #### İstek Parametreleri Parametre Tür Zorunlu Açıklama agentId string Zorunlu Arama için kullanılacak AI ajanının UUID'si participant.number string Zorunlu Aranacak telefon numarası (E.164 formatı) participant.about string İsteğe Bağlı AI için katılımcı hakkında bağlam prompt.content string İsteğe Bağlı Ajanın varsayılanını geçersiz kılacak özel prompt prompt.overwrite boolean İsteğe Bağlı Varsayılan prompt'un üzerine yazılıp yazılmayacağı message.start string İsteğe Bağlı Arama bağlandığında açılış mesajı #### Örnek İstek POST /api/v1/call application/json { "agentId" : "32d8fc98-be1e-4d32-a12e-146f397fb1cb" , "prompt" : { "overwrite" : true , "content" : "Destek ekibinden Michael'sınız..." }, "participant" : { "number" : "+1 (415) 555-0123" , "about" : "John Doe adlı müşteri. Sipariş #12345." }, "message" : { "start" : "Merhaba! Ben destek ekibinden Michael." } } #### Yanıt 200 OK application/json { "success" : true , "message" : "İşlem başarıyla tamamlandı" , "data" : { "callId" : "call_abc123def456" , "durum" : "initiated" } } WEBHOOK'LAR ## Gerçek Zamanlı Etkinlik Bildirimleri Set up Webhooks to trigger actions on external services in real-time. Stay informed on updates and changes to ensure seamless integration. Webhook'lar Yapılandırması Webhook URL'i Gizli Anahtar Olay Türü Konuşma Güncellemesi Konuşma Bitiş Raporu Konuşma Durumu Niyet Araması Metin Değerlendirmesi Ses Değerlendirmesi Değişiklikleri Kaydet Mevcut Webhook Yapılandırması URL: https://example.com/webhooks/mihu Aktif Olaylar: Konuşma Bitiş Raporu, Metin Değerlendirmesi, Ses Değerlendirmesi Örnek Payload conversation.end_report { "event" : "conversation.end_report" , "timestamp" : "2024-01-15T14:32:18Z" , "data" : { "conversation_id" : "conv_abc123def456" , "agent_id" : "32d8fc98-be1e-4d32-a12e-146f397fb1cb" , "direction" : "outbound" , "participant" : { "number" : "+1 (415) 555-0123" , "name" : "John Doe" }, "duration_seconds" : 187 , "durum" : "completed" , "transcript_url" : "https://..." , "recording_url" : "https://..." , "sentiment" : "positive" , "summary" : "Müşteri sipariş durumu hakkında bilgi istedi..." } } ## Geliştirmeye Başlamaya Hazır mısınız? API anahtarınızı alın ve ilk entegrasyonunuzu dakikalar içinde yayınlayın. Ücretsiz katman aylık 1.000 API araması içerir. API Anahtarı Al (https://app.mihu.ai/register) Dokümanları Oku (https://developers.mihu.ai)