API и разработчици

Build with the Mihu AI Platform

RESTful API-та, SDK-та и webhooks за интегриране на AI гласови и съобщителни агенти във вашите приложения. Доставяйте по-бързо с изчерпателна документация и примери.

99.9%
API време на работа
<100ms
Отговор
50+
Endpoints
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);
БЪРЗ СТАРТ

В работен режим за минути

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

1

Вземете вашия API токен

Влезте в таблото си за управление и генерирайте частен API токен с опционална дата на изтичане.

: Bearer
2

Задайте базов URL

Всички API заявки се изпращат към нашия защитен endpoint с вашия bearer токен.

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

Направете първото си обаждане

Инициирайте изходящо обаждане с вашия агент и започнете да автоматизирате разговори.

POST /call { agentId, participant }
УДОСТОВЕРЯВАНЕ

Сигурен достъп до API

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

API ключове

Генерирайте API ключове за удостоверяване на вашите заявки. Създавайте частни токени с опционална дата на изтичане за сигурен достъп.

Добавяне на API ключ
Име на API ключа
Задайте дата на изтичане
Без изтичане
••••••••••••••••••••••••••••••••
••••••••••••••••••••••••••••••••

OAuth 2.0

Индустриален стандарт за оторизация при достъп, делегиран от потребители. Перфектно за интеграции с маркетплейси.

1

Пренасочване към авторизация

Изпратете потребителите към екрана за съгласие на Mihu

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

Получаване на код за авторизация

Потребителят дава разрешение, вие получавате код

?code=abc123&state=xyz
3

Обмен за токен за достъп

Обменете кода за токен за достъп

POST /oauth/token
API справка

Пълна документация на крайните точки

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

API справка
Обаждане
post /call
WhatsApp
post /whatsapp/template
Срещи
GET /appointments
post /appointments
Контакти
GET /contacts
post /contacts
Задачи
GET /tasks
post /tasks
Кампании
GET /campaigns
Графици
GET /schedules
Транскрипции
GET /transcriptions
post /api/v1/call

Иницииране на изходящо обаждане

Инициира изходящо обаждане чрез определен AI агент. Агентът ще се обади на номера на участника и ще следва конфигурираните инструкции.

Параметри на заявката

Параметър Тип Задължителен Описание
agentId string Задължителен UUID на AI агента, който да се използва за обаждането
participant.number string Задължителен Телефонен номер за обаждане (E.164 формат)
participant.about string Незадължителен Контекст за участника за AI
prompt.content string Незадължителен Персонализиран prompt за замяна на стандартния на агента
prompt.overwrite boolean Незадължителен Дали да се замени стандартният prompt
message.start string Незадължителен Начално съобщение при свързване на обаждането

Примерна заявка

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

Отговор

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

Известия за събития в реално време

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

Конфигурация на Webhooks
Актуализация на разговор
Доклад за край на разговор
Статус на разговора
Обаждане по намерение
Оценка на текст
Оценка на глас
Текуща конфигурация на Webhook
URL: https://integration.mihu.ai/webhook/422ffbc1-5068-4e83-bbbb-297d53f09ce3
Активни събития: Доклад за край на разговор, Оценка на текст, Оценка на глас
Примерен 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": "Клиентът попита за статуса на поръчката..."
  }
}

Готови ли сте да започнете да изграждате?

Вземете вашия API ключ и пуснете първата си интеграция за минути. Безплатният план включва 1,000 API заявки на месец.