API i programiści

Build with the Mihu AI Platform

RESTful API, SDK i webhooki do integracji agentów głosowych i komunikacyjnych AI w Twoich aplikacjach. Wdrażaj szybciej dzięki kompleksowej dokumentacji i przykładom.

99.9%
Dostępność API
<100ms
Odpowiedź
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);
QUICK START

Gotowe do działania w kilka minut

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

1

Uzyskaj swój token API

Zaloguj się do panelu i wygeneruj prywatny token API z opcjonalną datą wygaśnięcia.

: Bearer
2

Ustaw bazowy URL

Wszystkie żądania API są kierowane do naszego bezpiecznego endpointu z Twoim tokenem bearer.

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

Wykonaj swoje pierwsze połączenie

Zainicjuj połączenie wychodzące za pomocą swojego agenta i zacznij automatyzować rozmowy.

POST /call { agentId, participant }
AUTHENTICATION

Bezpieczny dostęp do API

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

Klucze API

Generuj klucze API do uwierzytelniania swoich żądań. Twórz prywatne tokeny z opcjonalnymi datami wygaśnięcia dla bezpiecznego dostępu.

Dodaj klucz API
Nazwa klucza API
Ustaw datę wygaśnięcia
Bez wygaśnięcia
••••••••••••••••••••••••••••••••
••••••••••••••••••••••••••••••••

OAuth 2.0

Standardowa autoryzacja branżowa dla dostępu delegowanego przez użytkownika. Idealna do integracji z marketplace.

1

Przekieruj do autoryzacji

Przekieruj użytkowników do ekranu zgody Mihu

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

Odbierz kod autoryzacji

Użytkownik udziela uprawnień, Ty otrzymujesz kod

?code=abc123&state=xyz
3

Wymień na token dostępu

Wymień kod na token dostępu

POST /oauth/token
Referencja API

Kompleksowa dokumentacja endpointów

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

Referencja API
Połączenie
post /call
WhatsApp
post /whatsapp/template
Wizyty
GET /appointments
post /appointments
Kontakty
GET /contacts
post /contacts
Zadania
GET /tasks
post /tasks
Kampanie
GET /campaigns
Harmonogramy
GET /schedules
Transkrypcje
GET /transcriptions
post /api/v1/call

Zainicjuj połączenie wychodzące

Inicjuje połączenie wychodzące przy użyciu określonego agenta AI. Agent zadzwoni pod numer uczestnika i zastosuje się do skonfigurowanych instrukcji promptu.

Parametry żądania

Parametr Typ Wymagane Opis
agentId string Wymagane UUID agenta AI używanego do połączenia
participant.number string Wymagane Numer telefonu do połączenia (format E.164)
participant.about string Opcjonalne Kontekst dotyczący uczestnika dla AI
prompt.content string Opcjonalne Niestandardowy prompt nadpisujący domyślny prompt agenta
prompt.overwrite boolean Opcjonalne Czy nadpisać domyślny prompt
message.start string Opcjonalne Wiadomość otwierająca po nawiązaniu połączenia

Przykładowe żądanie

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."
  }
}

Odpowiedź

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

Powiadomienia o zdarzeniach w czasie rzeczywistym

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

Konfiguracja webhooków
Aktualizacja rozmowy
Raport końcowy rozmowy
Status rozmowy
Wywołanie intencji
Ocena tekstu
Ocena głosu
Bieżąca konfiguracja webhooka
URL: https://integration.mihu.ai/webhook/422ffbc1-5068-4e83-bbbb-297d53f09ce3
Aktywne zdarzenia: Raport końcowy rozmowy, ocena tekstu, ocena głosu
Przykładowy 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": "Klient zapytał o status zamówienia..."
  }
}

Gotowy, aby zacząć tworzyć?

Uzyskaj swój klucz API i wdróż swoją pierwszą integrację w kilka minut. Darmowy plan obejmuje 1000 wywołań API miesięcznie.