# API e Desenvolvedores — Mihu AI API e Desenvolvedores # Construa com a Mihu AI Platform APIs RESTful, SDKs e webhooks para integrar agentes de voz e de mensagens com IA às suas aplicações. Lance mais rápido com documentação e exemplos completos. Ver documentação (https://developers.mihu.ai) Console da API (https://app.mihu.ai/) 99.9% Disponibilidade da API <100ms Resposta 50+ Endpoints cURL Python Node.js API REST 1 # Iniciar uma chamada de saída --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" : "Cliente 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 Copy INÍCIO RÁPIDO ## Operando em minutos Get started with the Mihu AI API in three simple steps. 1 ### Obtenha seu token de API Faça login no seu painel e gere um token de API privado com expiração opcional. : Bearer 2 ### Definir URL base Todas as requisições de API são feitas para nosso endpoint seguro com seu bearer token. https://demo.mihu.ai/api/v1 3 ### Faça sua primeira chamada Inicie uma chamada de saída com seu agente e comece a automatizar conversas. POST /call { agentId, participant } AUTENTICAÇÃO ## Acesso seguro à API Choose between API keys for server-to-server or OAuth 2.0 for user-delegated access. ### Chaves de API Gere chaves de API para autenticar suas requisições. Crie tokens privados com datas de expiração opcionais para acesso seguro. Adicionar chave de API Nome da chave de API Definir data de expiração Sem expiração Criar token privado •••••••••••••••••••••••••••••••• •••••••••••••••••••••••••••••••• ### OAuth 2.0 Autorização padrão do setor para acesso delegado pelo usuário. Perfeito para integrações de marketplace. 1 #### Redirecionar para autorização Envie os usuários para a tela de consentimento da Mihu GET /oauth/authorizeclient_id=... 2 #### Receber código de autorização O usuário concede permissão, você recebe um código ?code=abc123&state=xyz 3 #### Trocar por token de acesso Troque o código por um token de acesso POST /oauth/token Referência da API ## Documentação completa de endpoints Explore our RESTful API with detailed request/response examples for every endpoint. Referência da API Chamada post /call WhatsApp post /whatsapp/template Appointments GET /appointments post /appointments Contatos GET /contacts post /contacts Tasks GET /tasks post /tasks Campaigns GET /campaigns Schedules GET /schedules Transcriptions GET /transcriptions post /api/v1/call ### Iniciar chamada de saída Inicia uma chamada de saída usando um agente de IA especificado. O agente ligará para o número do participante e seguirá as instruções de prompt configuradas. #### Parâmetros da requisição Parameter Tipo Obrigatório Description agentId string Obrigatório UUID do agente de IA a usar na chamada participant.number string Obrigatório Número de telefone para ligar (formato E.164) participant.about string Opcional Contexto sobre o participante para a IA prompt.content string Opcional Prompt personalizado para substituir o padrão do agente prompt.overwrite boolean Opcional Se deve substituir o prompt padrão message.start string Opcional Mensagem de abertura quando a chamada conecta #### Exemplo de requisição POST /api/v1/call application/json { "agentId" : "32d8fc98-be1e-4d32-a12e-146f397fb1cb" , "prompt" : { "overwrite" : true , "content" : "Você é Michael da equipe de suporte..." }, "participant" : { "number" : "+1 (415) 555-0123" , "about" : "Cliente chamado John Doe. Pedido #12345." }, "message" : { "start" : "Olá! Aqui é o Michael do suporte." } } #### Resposta 200 OK application/json { "success" : true , "message" : "Operação concluída com sucesso" , "data" : { "callId" : "call_abc123def456" , "status" : "initiated" } } WEBHOOKS ## Notificações de eventos em tempo real Set up Webhooks to trigger actions on external services in real-time. Stay informed on updates and changes to ensure seamless integration. Configuração de webhooks URL do webhook Chave secreta Tipo de evento Atualização de conversa Relatório de fim de conversa Status da conversa Chamada de intenção Avaliação de texto Avaliação de voz Salvar alterações Configuração atual do webhook URL: https://example.com/webhooks/mihu Active Events: Relatório de fim de conversa, Avaliação de texto, Avaliação de voz Exemplo de 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" : "Cliente perguntou sobre o status do pedido..." } } ## Pronto para começar a construir Obtenha sua chave de API e publique sua primeira integração em minutos. O plano gratuito inclui 1.000 chamadas de API por mês. Obter chave de API (https://app.mihu.ai/register) Ler a documentação (https://developers.mihu.ai)