# API și Dezvoltatori — Mihu AI API și dezvoltatori # Construiește cu Mihu AI Platform API-uri RESTful, SDK-uri și webhook-uri pentru a integra agenți AI vocali și de mesagerie în aplicațiile tale. Lansează mai rapid cu documentație completă și exemple. Vezi Documentația (https://developers.mihu.ai) Consolă API (https://app.mihu.ai/) 99.9% Timp Funcționare API <100ms Răspuns 50+ Endpoint-uri cURL Python Node.js API REST 1 # Inițiază un apel de ieșire --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" : "Customer 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 Created Copiază START RAPID ## Funcțional în câteva minute Get started with the Mihu AI API in three simple steps. 1 ### Obține Token-ul API Conectează-te la panoul de control și generează un token API privat cu expirare opțională. : Bearer 2 ### Setează URL-ul de Bază Toate cererile API sunt făcute către endpoint-ul nostru securizat cu token-ul tău bearer. https://demo.mihu.ai/api/v1 3 ### Efectuează Primul Apel Inițiază un apel de ieșire cu agentul tău și începe automatizarea conversațiilor. POST /call { agentId, participant } AUTENTIFICARE ## Acces API securizat Choose between API keys for server-to-server or OAuth 2.0 for user-delegated access. ### Chei API Generează chei API pentru a autentifica cererile tale. Creează token-uri private cu date de expirare opționale pentru acces securizat. Adaugă Cheie API Numele Cheii API Setează Data Expirării Fără Expirare Creează Token Privat •••••••••••••••••••••••••••••••• •••••••••••••••••••••••••••••••• ### OAuth 2.0 Autorizare standard în industrie pentru acces delegat de utilizator. Perfect pentru integrări marketplace. 1 #### Redirecționează către Autorizare Trimite utilizatorii la ecranul de consimțământ Mihu GET /oauth/authorize?client_id=... 2 #### Primește Codul de Autorizare Utilizatorul acordă permisiunea, tu primești un cod ?code=abc123&state=xyz 3 #### Schimbă pentru Token de Acces Schimbă codul pentru un token de acces POST /oauth/token Referință API ## Documentație completă pentru Endpoint-uri Explore our RESTful API with detailed request/response examples for every endpoint. Referință API Apel post /call WhatsApp post /whatsapp/template Întâlniri GET /appointments post /appointments Contacte GET /contacte post /contacte Sarcini GET /tasks post /tasks Campanii GET /campaigns Programe GET /schedules Transcrieri GET /transcriptions post /api/v1/call ### Inițiază Apel de Ieșire Inițiază un apel de ieșire folosind un agent AI specificat. Agentul va apela numărul participantului și va urma instrucțiunile configurate în prompt. #### Parametri Cerere Parametru Tip Obligatoriu Descriere agentId string Obligatoriu UUID-ul agentului AI de utilizat pentru apel participant.number string Obligatoriu Numărul de telefon de apelat (format E.164) participant.about string Opțional Context despre participant pentru AI prompt.content string Opțional Prompt personalizat pentru a suprascrie setările implicite ale agentului prompt.overwrite boolean Opțional Dacă se suprascrie promptul implicit message.start string Opțional Mesaj de deschidere când apelul se conectează #### Exemplu Cerere 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." } } #### Răspuns 200 OK application/json { "success" : true , "message" : "Operation completed successfully" , "data" : { "callId" : "call_abc123def456" , "status" : "initiated" } } WEBHOOK-URI ## Notificări evenimente în timp real Set up Webhooks to trigger actions on external services in real-time. Stay informed on updates and changes to ensure seamless integration. Configurare Webhook-uri URL Webhook Cheie Secretă Tip Eveniment Actualizare Conversație Raport Final Conversație Status Conversație Apel Intenție Evaluare Text Evaluare Voce Salvează Modificările Configurație Webhook Curentă URL: https://example.com/webhooks/mihu Evenimente Active: Raport Final Conversație, Evaluare Text, Evaluare Voce Exemplu 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 , "status" : "completed" , "transcript_url" : "https://..." , "recording_url" : "https://..." , "sentiment" : "positive" , "summary" : "Clientul a întrebat despre statusul comenzii..." } } ## Gata să Începi Construcția? Obține cheia API și lansează prima integrare în câteva minute. Nivelul gratuit include 1.000 de apeluri API pe lună. Obține Cheie API (https://app.mihu.ai/register) Citește Documentația (https://developers.mihu.ai)