API & Geliştiriciler

Build with the 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 API Konsolu
99.9%
API Çalışma Süresi
<100ms
Yanıt
50+
Endpoint'ler
REST API
1# Giden arama başlat


--request POST \


3  --url https://demo.mindhunters.ai/api/v1/call \


4  --header 'Authorization: Bearer <token>' \


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 <token>",


6    "Content-Type": "application/json"


7}


data = {


9    "agentId": "32d8fc98-be1e-4d32-...",


10    "participant": {"number": "+1 (415) 555-0123"}


11}


12response = requests.post(url, headers=headers, json=data)
1const response = await fetch(


2  'https://demo.mindhunters.ai/api/v1/call',


3  {


4    method: 'POST',


5    headers: {


6      'Authorization': 'Bearer <token>',


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
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.mindhunters.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
••••••••••••••••••••••••••••••••
••••••••••••••••••••••••••••••••

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ı
Konuşma Güncellemesi
Konuşma Bitiş Raporu
Konuşma Durumu
Niyet Araması
Metin Değerlendirmesi
Ses Değerlendirmesi
Mevcut Webhook Yapılandırması
URL: https://integration.mihu.ai/webhook/422ffbc1-5068-4e83-bbbb-297d53f09ce3
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 Dokümanları Oku