# API и разработчици — Mihu AI API и разработчици # Изграждайте с Mihu AI Platform RESTful API-та, SDK-та и webhooks за интегриране на AI гласови и съобщителни агенти във вашите приложения. Доставяйте по-бързо с изчерпателна документация и примери. Преглед на документацията (https://developers.mihu.ai) API конзола (https://app.mihu.ai/) 99.9% API време на работа <100ms Отговор 50+ Endpoints 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 Копирай БЪРЗ СТАРТ ## В работен режим за минути Get started with the Mihu AI API in three simple steps. 1 ### Вземете вашия API токен Влезте в таблото си за управление и генерирайте частен API токен с опционална дата на изтичане. : Bearer 2 ### Задайте базов URL Всички API заявки се изпращат към нашия защитен endpoint с вашия bearer токен. https://demo.mihu.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 Таен ключ Тип събитие Актуализация на разговор Доклад за край на разговор Статус на разговора Обаждане по намерение Оценка на текст Оценка на глас Запазване на промените Текуща конфигурация на Webhook URL: https://example.com/webhooks/mihu Активни събития: Доклад за край на разговор, Оценка на текст, Оценка на глас Примерен 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 заявки на месец. Вземете API ключ (https://app.mihu.ai/register) Прочетете документацията (https://developers.mihu.ai)