API والمطورون

Build with the Mihu AI Platform

REST APIs وSDKs وwebhooks لدمج وكلاء الصوت والرسائل بالذكاء الاصطناعي في تطبيقاتك. انشر أسرع مع وثائق وأمثلة شاملة.

عرض الوثائق وحدة تحكم API
99.9%
وقت تشغيل API
<100 مللي ثانية
الاستجابة
50+
نقاط النهاية
REST API
1# بدء مكالمة صادرة


--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": "Customer 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 Created
البداية السريعة

جاهز للعمل في دقائق

Get started with the Mihu AI API in three simple steps.

1

احصل على رمز API الخاص بك

سجل الدخول إلى لوحة التحكم الخاصة بك وأنشئ رمز API خاص مع تاريخ انتهاء اختياري.

: Bearer
2

تعيين عنوان URL الأساسي

يتم إجراء جميع طلبات API إلى نقطة النهاية الآمنة لدينا مع رمز Bearer الخاص بك.

https://demo.mindhunters.ai/api/v1
3

قم بأول مكالمة لك

ابدأ مكالمة صادرة مع وكيلك وابدأ بأتمتة المحادثات.

POST /call { agentId, participant }
المصادقة

Secure API Access

Choose between API keys for server-to-server or OAuth 2.0 for user-delegated access.

مفاتيح API

أنشئ مفاتيح API لمصادقة طلباتك. أنشئ رموزاً خاصة مع تواريخ انتهاء اختيارية للوصول الآمن.

إضافة مفتاح API
اسم مفتاح API
تعيين تاريخ الانتهاء
بدون انتهاء
••••••••••••••••••••••••••••••••
••••••••••••••••••••••••••••••••

OAuth 2.0

ترخيص قياسي للوصول المفوض من المستخدم. مثالي لتكاملات السوق.

1

إعادة التوجيه إلى التفويض

أرسل المستخدمين إلى شاشة موافقة Mihu

GET /oauth/authorize?client_id=...
2

استلام رمز التفويض

يمنح المستخدم الإذن، تحصل على رمز

?code=abc123&state=xyz
3

استبدال برمز الوصول

استبدل الرمز برمز وصول

POST /oauth/token
مرجع API

توثيق شامل لنقاط النهاية

Explore our RESTful API with detailed request/response examples for every endpoint.

مرجع API
المكالمة
post /call
WhatsApp
post /whatsapp/template
المواعيد
GET /appointments
post /appointments
جهات الاتصال
GET /contacts
post /contacts
المهام
GET /tasks
post /tasks
الحملات
GET /campaigns
الجداول
GET /schedules
النصوص
GET /transcriptions
post /api/v1/call

بدء مكالمة صادرة

يبدأ مكالمة صادرة باستخدام وكيل ذكاء اصطناعي محدد. سيتصل الوكيل برقم المشارك ويتبع تعليمات الأوامر المُعدة.

معاملات الطلب

المعامل النوع مطلوب الوصف
agentId string مطلوب UUID لوكيل الذكاء الاصطناعي المستخدم للمكالمة
participant.number string مطلوب رقم الهاتف للاتصال (تنسيق E.164)
participant.about string اختياري سياق حول المشارك للذكاء الاصطناعي
prompt.content string اختياري أمر مخصص لتجاوز الافتراضي للوكيل
prompt.overwrite boolean اختياري ما إذا كان سيتم الكتابة فوق الأمر الافتراضي
message.start string اختياري الرسالة الافتتاحية عند اتصال المكالمة

مثال على الطلب

POST /api/v1/call
application/json 
{
  "agentId": "32d8fc98-be1e-4d32-a12e-146f397fb1cb",
  "prompt": {
    "overwrite": true,
    "content": "You are Michael from the support team..."
  },
  "participant": {
    "number": "+1 (415) 555-0123",
    "about": "Customer named John Doe. Order #12345."
  },
  "message": {
    "start": "Hello! This is Michael from support."
  }
}

الاستجابة

200 OK
application/json 
{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    "callId": "call_abc123def456",
    "الحالة": "initiated"
  }
}
WEBHOOKS

إشعارات أحداث في الوقت الفعلي

Set up Webhooks to trigger actions on external services in real-time. Stay informed on updates and changes to ensure seamless integration.

تكوين Webhooks
تحديث المحادثة
تقرير نهاية المحادثة
حالة المحادثة
مكالمة النية
تقييم النص
تقييم الصوت
تكوين Webhook الحالي
عنوان URL: https://integration.mihu.ai/webhook/422ffbc1-5068-4e83-bbbb-297d53f09ce3
الأحداث النشطة: تقرير نهاية المحادثة، تقييم النص، تقييم الصوت
مثال على الحمولة 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,
    "الحالة": "completed",
    "transcript_url": "https://...",
    "recording_url": "https://...",
    "sentiment": "positive",
    "summary": "استفسر العميل عن حالة الطلب..."
  }
}

هل أنت مستعد للبدء في البناء؟

احصل على مفتاح API الخاص بك وانشر أول تكامل لك في دقائق. الفئة المجانية تتضمن 1,000 طلب API شهرياً.

احصل على مفتاح API اقرأ الوثائق