# API & ontwikkelaars — Mihu AI

API & Ontwikkelaars

# Bouw met de 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.

Documentatie bekijken (https://developers.mihu.ai) API Console (https://app.mihu.ai/)

99.9%

API Uptime

<100ms

Reactie

50+

Eindpunten

cURL Python Node.js

REST API

1 # Initieer een uitgaand gesprek

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

Kopiëren

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

Privétoken aanmaken

••••••••••••••••••••••••••••••••

••••••••••••••••••••••••••••••••

### 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

Webhook URL

Geheime sleutel

Gebeurtenistype

Conversatie-update

Gespreksrapportage

Gespreksstatus

Intentgesprek

Tekstevaluatie

Spraakevaluatie

Wijzigingen opslaan

Huidige webhook-configuratie

URL: https://example.com/webhooks/mihu

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.

API-sleutel ophalen (https://app.mihu.ai/register) Documentatie lezen (https://developers.mihu.ai)