# API a vývojáři — Mihu AI API a vývojáři # Vytvářejte s Mihu AI Platform RESTful API, SDK a webhooky pro integraci AI hlasových a komunikačních agentů do vašich aplikací. Rychlejší vývoj s komplexní dokumentací a příklady. Zobrazit dokumentaci (https://developers.mihu.ai) API konzole (https://app.mihu.ai/) 99.9% API dostupnost <100ms Odezva 50+ Endpointy cURL Python Node.js REST API 1 # Initiate an outbound call --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 Created Kopírovat RYCHLÝ START ## V provozu během několika minut Get started with the Mihu AI API in three simple steps. 1 ### Získejte svůj API token Přihlaste se do svého dashboardu a vygenerujte soukromý API token s volitelnou expirací. : Bearer 2 ### Nastavte základní URL Všechny API požadavky jsou směrovány na náš zabezpečený endpoint s vaším bearer tokenem. https://demo.mihu.ai/api/v1 3 ### Proveďte svůj první hovor Zahajte odchozí hovor se svým agentem a začněte automatizovat konverzace. POST /call { agentId, participant } AUTENTIZACE ## Bezpečný přístup k API Choose between API keys for server-to-server or OAuth 2.0 for user-delegated access. ### API klíče Generujte API klíče pro autentizaci vašich požadavků. Vytvářejte soukromé tokeny s volitelným datem expirace pro bezpečný přístup. Přidat API klíč Název API klíče Nastavit datum expirace Bez expirace Vytvořit soukromý token •••••••••••••••••••••••••••••••• •••••••••••••••••••••••••••••••• ### OAuth 2.0 Průmyslový standard autorizace pro uživatelem delegovaný přístup. Ideální pro integrace na tržištích. 1 #### Přesměrování na autorizaci Přesměrujte uživatele na obrazovku souhlasu Mihu GET /oauth/authorize?client_id=... 2 #### Přijetí autorizačního kódu Uživatel udělí oprávnění, obdržíte kód ?code=abc123&state=xyz 3 #### Výměna za přístupový token Vyměňte kód za přístupový token POST /oauth/token API reference ## Komplexní dokumentace koncových bodů Explore our RESTful API with detailed request/response examples for every endpoint. API reference Hovor post /call WhatsApp post /whatsapp/template Schůzky GET /appointments post /appointments Kontakty GET /contacts post /contacts Úkoly GET /tasks post /tasks Kampaně GET /campaigns Rozvrhy GET /schedules Přepisy GET /transcriptions post /api/v1/call ### Zahájit odchozí hovor Zahájí odchozí hovor pomocí určeného AI agenta. Agent zavolá na číslo účastníka a bude postupovat podle nakonfigurovaných pokynů promptu. #### Parametry požadavku Parametr Typ Povinné Popis agentId string Povinné UUID AI agenta, který se má použít pro hovor participant.number string Povinné Telefonní číslo k zavolání (formát E.164) participant.about string Volitelné Kontext o účastníkovi pro AI prompt.content string Volitelné Vlastní prompt pro přepsání výchozího nastavení agenta prompt.overwrite boolean Volitelné Zda přepsat výchozí prompt message.start string Volitelné Úvodní zpráva při spojení hovoru #### Příklad požadavku 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." } } #### Odezva 200 OK application/json { "success" : true , "message" : "Operation completed successfully" , "data" : { "callId" : "call_abc123def456" , "status" : "initiated" } } WEBHOOKY ## Oznámení událostí v reálném čase Set up Webhooks to trigger actions on external services in real-time. Stay informed on updates and changes to ensure seamless integration. Konfigurace webhooků URL webhooku Tajný klíč Typ události Aktualizace konverzace Zpráva o ukončení konverzace Stav konverzace Hovor se záměrem Textové vyhodnocení Hlasové vyhodnocení Uložit změny Aktuální konfigurace webhooku URL: https://example.com/webhooks/mihu Aktivní události: Zpráva o ukončení konverzace, Textové vyhodnocení, Hlasové vyhodnocení Příklad payloadu 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" : "Zákazník se dotázal na stav objednávky..." } } ## Připraveni začít vytvářet? Získejte svůj API klíč a spusťte svou první integraci během několika minut. Bezplatná úroveň zahrnuje 1 000 API volání měsíčně. Získat API klíč (https://app.mihu.ai/register) Přečíst dokumentaci (https://developers.mihu.ai)