API & Ontwikkelaars

Build with the Mihu AI Platform

RESTful API's, SDK's en webhooks om AI-spraak- en berichtenagenten in uw applicaties te integreren. Lever sneller met uitgebreide documentatie en voorbeelden.

99.9%
API Uptime
<100ms
Reactie
50+
Eindpunten
REST API
1# Initieer een uitgaand gesprek
--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);
SNELSTART

Operationeel in minuten

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

1

Uw API-token ophalen

Log in op uw dashboard en genereer een privé API-token met optionele vervaldatum.

: Bearer
2

Basis-URL instellen

Alle API-verzoeken worden naar ons beveiligde eindpunt gestuurd met uw bearer-token.

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

Uw eerste gesprek starten

Initieer een uitgaand gesprek met uw agent en begin met het automatiseren van conversaties.

POST /call { agentId, participant }
AUTHENTICATIE

Veilige API-toegang

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

API Keys

Genereer API-sleutels om uw verzoeken te authenticeren. Maak privétokens aan met optionele vervaldatums voor veilige toegang.

API Key toevoegen
Naam van de API Key
Vervaldatum instellen
Geen vervaldatum
••••••••••••••••••••••••••••••••
••••••••••••••••••••••••••••••••

OAuth 2.0

Industriestandaard autorisatie voor gedelegeerde gebruikerstoegang. Ideaal voor marketplace-integraties.

1

Doorverwijzen naar autorisatie

Stuur gebruikers naar het toestemmingsscherm van Mihu

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

Autorisatiecode ontvangen

Gebruiker verleent toestemming, u ontvangt een code

?code=abc123&state=xyz
3

Inwisselen voor toegangstoken

Wissel de code in voor een toegangstoken

POST /oauth/token
API-referentie

Uitgebreide eindpuntdocumentatie

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

API-referentie
Call
post /call
WhatsApp
post /whatsapp/template
Afspraken
GET /appointments
post /appointments
Contacten
GET /contacts
post /contacts
Taken
GET /tasks
post /tasks
Campagnes
GET /campaigns
Schema's
GET /schedules
Transcripties
GET /transcriptions
post /api/v1/call

Uitgaand gesprek initiëren

Initieert een uitgaand gesprek met een opgegeven AI-agent. De agent belt het nummer van de deelnemer en volgt de geconfigureerde promptinstructies.

Verzoekparameters

Parameter Type Vereist Beschrijving
agentId string Vereist UUID van de AI-agent die voor het gesprek wordt gebruikt
participant.number string Vereist Telefoonnummer om te bellen (E.164-formaat)
participant.about string Optioneel Context over de deelnemer voor de AI
prompt.content string Optioneel Aangepaste prompt om de standaard van de agent te overschrijven
prompt.overwrite boolean Optioneel Of de standaardprompt moet worden overschreven
message.start string Optioneel Openingsbericht wanneer het gesprek verbindt

Voorbeeldverzoek

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."
  }
}

Reactie

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

Real-time gebeurtenismeldingen

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

Webhooks-configuratie
Conversatie-update
Gespreksrapportage
Gespreksstatus
Intentgesprek
Tekstevaluatie
Spraakevaluatie
Huidige webhook-configuratie
URL: https://integration.mihu.ai/webhook/422ffbc1-5068-4e83-bbbb-297d53f09ce3
Actieve gebeurtenissen: Gespreksrapportage, Tekstevaluatie, Spraakevaluatie
Voorbeeld 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": "Klant heeft gevraagd naar de bestelstatus..."
  }
}

Klaar om te beginnen met bouwen?

Haal uw API-sleutel op en lever uw eerste integratie in enkele minuten. De gratis versie bevat 1.000 API-aanroepen per maand.