API a vývojáři

Build with the 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 API konzole
99.9%
API dostupnost
<100ms
Odezva
50+
Endpointy
REST API
1# Initiate an outbound call


--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);
201 Created
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.mindhunters.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
••••••••••••••••••••••••••••••••
••••••••••••••••••••••••••••••••

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ů
Aktualizace konverzace
Zpráva o ukončení konverzace
Stav konverzace
Hovor se záměrem
Textové vyhodnocení
Hlasové vyhodnocení
Aktuální konfigurace webhooku
URL: https://integration.mihu.ai/webhook/422ffbc1-5068-4e83-bbbb-297d53f09ce3
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íč Přečíst dokumentaci