# API & Développeurs — Mihu AI API et développeurs # Construisez avec la 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. Voir la Documentation (https://developers.mihu.ai) Console API (https://app.mihu.ai/) 99.9% Disponibilite API <100ms Réponse 50+ Points de Terminaison cURL Python Node.js REST API 1 # Initier un appel sortant --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 Cree Copier 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.mihu.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 Creer un Jeton Prive •••••••••••••••••••••••••••••••• •••••••••••••••••••••••••••••••• ### 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 URL du Webhook Cle Secrete Type d'Evenement Mise a Jour de Conversation Rapport de Fin de Conversation Statut de la conversation Appel d'Intention Evaluation de Texte Evaluation Vocale Enregistrer les Modifications Configuration Webhook Actuelle URL : https://example.com/webhooks/mihu 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. Obtenir une Cle API (https://app.mihu.ai/register) Lire la Documentation (https://developers.mihu.ai)