# API والمطورون — Mihu AI

API والمطورون

# ابنِ مع Mihu AI Platform

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

عرض الوثائق (https://developers.mihu.ai) وحدة تحكم API (https://app.mihu.ai/)

99.9%

وقت تشغيل API

<100 مللي ثانية

الاستجابة

50+

نقاط النهاية

cURL Python Node.js

REST API

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

--request POST \

3 --url https://demo.mihu.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 }

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 <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.mihu.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

عنوان URL للـ Webhook

المفتاح السري

نوع الحدث

تحديث المحادثة

تقرير نهاية المحادثة

حالة المحادثة

مكالمة النية

تقييم النص

تقييم الصوت

حفظ التغييرات

تكوين Webhook الحالي

عنوان URL: https://example.com/webhooks/mihu

الأحداث النشطة: تقرير نهاية المحادثة، تقييم النص، تقييم الصوت

مثال على الحمولة 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 (https://app.mihu.ai/register) اقرأ الوثائق (https://developers.mihu.ai)