# API e Sviluppatori — Mihu AI API e Sviluppatori # Costruisca con le Mihu AI Platform API RESTful, SDK e webhook per integrare agenti vocali e di messaggistica AI nelle Sue applicazioni. Rilasci più velocemente con documentazione ed esempi completi. Vedi la documentazione (https://developers.mihu.ai) Console API (https://app.mihu.ai/) 99.9% Uptime API <100ms Risposta 50+ Endpoint cURL Python Node.js REST API 1 # Avvia una chiamata in uscita --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 Copia AVVIO RAPIDO ## Operativo in Pochi Minuti Get started with the Mihu AI API in three simple steps. 1 ### Ottenga il Suo token API Acceda alla Sua dashboard e generi un token API privato con scadenza opzionale. : Bearer 2 ### Imposti il base URL Tutte le richieste API vengono inviate al nostro endpoint sicuro con il Suo bearer token. https://demo.mihu.ai/api/v1 3 ### Effettui la Sua prima chiamata Avvii una chiamata in uscita con il Suo agente e inizi ad automatizzare le conversazioni. POST /call { agentId, participant } AUTENTICAZIONE ## Accesso API Sicuro Choose between API keys for server-to-server or OAuth 2.0 for user-delegated access. ### Chiavi API Generi chiavi API per autenticare le Sue richieste. Crei token privati con scadenza opzionale per un accesso sicuro. Aggiungi chiave API Nome della chiave API Imposta data di scadenza Nessuna scadenza Crea token privato •••••••••••••••••••••••••••••••• •••••••••••••••••••••••••••••••• ### OAuth 2.0 Autorizzazione standard di settore per accesso delegato dagli utenti. Perfetta per integrazioni marketplace. 1 #### Reindirizza all'autorizzazione Invii gli utenti alla schermata di consenso di Mihu GET /oauth/authorize?client_id=... 2 #### Ricevi il codice di autorizzazione L'utente concede il permesso, Lei ottiene un codice ?code=abc123&state=xyz 3 #### Scambia con access token Scambi il codice con un access token POST /oauth/token Riferimento API ## Documentazione Endpoint Completa Explore our RESTful API with detailed request/response examples for every endpoint. Riferimento API Chiamata post /call WhatsApp post /whatsapp/template Appuntamenti GET /appointments post /appointments Contatti GET /contacts post /contacts Attività GET /tasks post /tasks Campagne GET /campaigns Pianificazioni GET /schedules Trascrizioni GET /transcriptions post /api/v1/call ### Avvia chiamata in uscita Avvia una chiamata in uscita usando un agente AI specifico. L'agente chiamerà il numero del partecipante e seguirà le istruzioni del prompt configurato. #### Parametri richiesta Parametro Tipo Obbligatorio Descrizione agentId string Obbligatorio UUID dell'agente AI da usare per la chiamata participant.number string Obbligatorio Numero di telefono da chiamare (formato E.164) participant.about string Opzionale Contesto sul partecipante per l'AI prompt.content string Opzionale Prompt personalizzato per sovrascrivere quello predefinito dell'agente prompt.overwrite boolean Opzionale Se sovrascrivere il prompt predefinito message.start string Opzionale Messaggio di apertura quando la chiamata si connette #### Esempio di richiesta POST /api/v1/call application/json { "agentId" : "32d8fc98-be1e-4d32-a12e-146f397fb1cb" , "prompt" : { "overwrite" : true , "content" : "Lei è Michael del team di supporto..." }, "participant" : { "number" : "+1 (415) 555-0123" , "about" : "Cliente di nome John Doe. Ordine #12345." }, "message" : { "start" : "Buongiorno! Sono Michael del supporto." } } #### Risposta 200 OK application/json { "success" : true , "message" : "Operazione completata con successo" , "data" : { "callId" : "call_abc123def456" , "status" : "initiated" } } WEBHOOK ## Real-Time Event Notifications Set up Webhooks to trigger actions on external services in real-time. Stay informed on updates and changes to ensure seamless integration. Configurazione webhook URL webhook Chiave segreta Tipo evento Aggiornamento conversazione Report fine conversazione Stato della conversazione Chiamata intento Valutazione testo Valutazione voce Salva modifiche Configurazione webhook attuale URL: https://example.com/webhooks/mihu Eventi attivi: Report fine conversazione, Valutazione testo, Valutazione voce Payload di esempio 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" : "Il cliente ha chiesto lo stato dell'ordine..." } } ## Pronto a iniziare a costruire? Ottenga la Sua chiave API e rilasci la Sua prima integrazione in pochi minuti. Il livello gratuito include 1.000 chiamate API al mese. Ottieni chiave API (https://app.mihu.ai/register) Leggi la documentazione (https://developers.mihu.ai)