API RESTful, SDK e webhook per integrare agenti vocali e di messaggistica AI nelle Sue applicazioni. Rilasci più velocemente con documentazione ed esempi completi.
1# Avvia una chiamata in uscita--request POST \3 --url https://demo.mindhunters.ai/api/v1/call \4 --header 'Authorization: Bearer <token>' \5 --header 'Content-Type: application/json' \--data7 "agentId": "32d8fc98-be1e-4d32-...",8 "participant": {9 "number": "+1 (415) 555-0123",10 "about": "Customer John Doe"11 }12 }'
requests2url =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);
Get started with the Mihu AI API in three simple steps.
Acceda alla Sua dashboard e generi un token API privato con scadenza opzionale.
Tutte le richieste API vengono inviate al nostro endpoint sicuro con il Suo bearer token.
Avvii una chiamata in uscita con il Suo agente e inizi ad automatizzare le conversazioni.
Choose between API keys for server-to-server or OAuth 2.0 for user-delegated access.
Generi chiavi API per autenticare le Sue richieste. Crei token privati con scadenza opzionale per un accesso sicuro.
Autorizzazione standard di settore per accesso delegato dagli utenti. Perfetta per integrazioni marketplace.
Invii gli utenti alla schermata di consenso di Mihu
GET /oauth/authorize?client_id=...
L'utente concede il permesso, Lei ottiene un codice
?code=abc123&state=xyz
Scambi il codice con un access token
POST /oauth/token
Explore our RESTful API with detailed request/response examples for every endpoint.
Avvia una chiamata in uscita usando un agente AI specifico. L'agente chiamerà il numero del partecipante e seguirà le istruzioni del prompt configurato.
| 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 |
{
"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."
}
}
{
"success": true,
"message": "Operazione completata con successo",
"data": {
"callId": "call_abc123def456",
"status": "initiated"
}
}
Set up Webhooks to trigger actions on external services in real-time. Stay informed on updates and changes to ensure seamless integration.
{
"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..."
}
}
Ottenga la Sua chiave API e rilasci la Sua prima integrazione in pochi minuti. Il livello gratuito include 1.000 chiamate API al mese.