# API i deweloperzy — Mihu AI

API i programiści

# Twórz z 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.

Zobacz dokumentację (https://developers.mihu.ai) Konsola API (https://app.mihu.ai/)

99.9%

Dostępność API

<100ms

Odpowiedź

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

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

Kopiuj

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.mihu.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

Utwórz prywatny token

••••••••••••••••••••••••••••••••

••••••••••••••••••••••••••••••••

### 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

URL webhooka

Klucz tajny

Typ zdarzenia

Aktualizacja rozmowy

Raport końcowy rozmowy

Status rozmowy

Wywołanie intencji

Ocena tekstu

Ocena głosu

Zapisz zmiany

Bieżąca konfiguracja webhooka

URL: https://example.com/webhooks/mihu

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.

Uzyskaj klucz API (https://app.mihu.ai/register) Przeczytaj dokumentację (https://developers.mihu.ai)
