API et développeurs

Build with the Mihu AI Platform

APIs RESTful, SDKs et webhooks pour integrer des agents vocaux et de messagerie IA dans vos applications. Livrez plus vite avec une documentation complete et des exemples.

99.9%
Disponibilite API
<100ms
Réponse
50+
Points de Terminaison
REST API
1# Initier un appel sortant
--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);
DEMARRAGE RAPIDE

Opérationnel en quelques minutes

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

1

Obtenez Votre Jeton API

Connectez-vous a votre tableau de bord et generez un jeton API prive avec une expiration optionnelle.

: Bearer
2

Definir l'URL de Base

Toutes les requetes API sont effectuees vers notre point de terminaison securise avec votre jeton bearer.

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

Effectuez Votre Premier Appel

Initiez un appel sortant avec votre agent et commencez a automatiser les conversations.

POST /call { agentId, participant }
AUTHENTIFICATION

Secure API Access

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

Cles API

Generez des cles API pour authentifier vos requetes. Creez des jetons prives avec des dates d'expiration optionnelles pour un acces securise.

Ajouter une Cle API
Nom de la Cle API
Definir la Date d'Expiration
Sans Expiration
••••••••••••••••••••••••••••••••
••••••••••••••••••••••••••••••••

OAuth 2.0

Autorisation standard de l'industrie pour l'accès délégué par l'utilisateur. Parfait pour les intégrations de marketplace.

1

Rediriger vers l'Autorisation

Envoyez les utilisateurs vers l'ecran de consentement de Mihu

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

Recevoir le Code d'Autorisation

L'utilisateur accorde la permission, vous obtenez un code

?code=abc123&state=xyz
3

Echanger contre un Jeton d'Acces

Echangez le code contre un jeton d'acces

POST /oauth/token
Reference API

Documentation complète des endpoints

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

Reference API
Appel
post /call
WhatsApp
post /whatsapp/template
Rendez-vous
GET /appointments
post /appointments
Contacts
GET /contacts
post /contacts
Taches
GET /tasks
post /tasks
Campagnes
GET /campaigns
Plannings
GET /schedules
Transcriptions
GET /transcriptions
post /api/v1/call

Initier un Appel Sortant

Initie un appel sortant en utilisant un agent IA specifie. L'agent appellera le numero du participant et suivra les instructions du prompt configure.

Parametres de Requete

Parametre Type Requis Description
agentId string Requis UUID de l'agent IA a utiliser pour l'appel
participant.number string Requis Numero de telephone a appeler (format E.164)
participant.about string Optionnel Contexte sur le participant pour l'IA
prompt.content string Optionnel Prompt personnalise pour remplacer celui par defaut de l'agent
prompt.overwrite boolean Optionnel Si le prompt par defaut doit etre ecrase
message.start string Optionnel Message d'ouverture lorsque l'appel se connecte

Exemple de Requete

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

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

Notifications d'événements en temps réel

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

Configuration des Webhooks
Mise a Jour de Conversation
Rapport de Fin de Conversation
Statut de la conversation
Appel d'Intention
Evaluation de Texte
Evaluation Vocale
Configuration Webhook Actuelle
URL : https://integration.mihu.ai/webhook/422ffbc1-5068-4e83-bbbb-297d53f09ce3
Evenements Actifs : Rapport de Fin de Conversation, Evaluation de Texte, Evaluation Vocale
Exemple de 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": "Le client s'est renseigné sur le statut de la commande..."
  }
}

Pret a Commencer a Construire ?

Obtenez votre cle API et livrez votre premiere integration en quelques minutes. Le niveau gratuit inclut 1 000 appels API par mois.