# API y Desarrolladores — Mihu AI API y desarrolladores # Construye con la Mihu AI Platform APIs RESTful, SDKs y webhooks para integrar agentes de voz y mensajería IA en tus aplicaciones. Despliega más rápido con documentación completa y ejemplos. Ver Documentación (https://developers.mihu.ai) Consola API (https://app.mihu.ai/) 99.9% Disponibilidad API <100ms Respuesta 50+ Endpoints cURL Python Node.js REST API 1 # Iniciar una llamada saliente --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 Creado Copiar INICIO RÁPIDO ## Funcionando en Cuestión de Minutos Get started with the Mihu AI API in three simple steps. 1 ### Obtén Tu Token API Inicia sesión en tu panel y genera un token API privado con expiración opcional. : Bearer 2 ### Configura la URL Base Todas las solicitudes API se realizan a nuestro endpoint seguro con tu token bearer. https://demo.mihu.ai/api/v1 3 ### Realiza Tu Primera Llamada Inicia una llamada saliente con tu agente y comienza a automatizar conversaciones. POST /call { agentId, participant } AUTENTICACIÓN ## Acceso Seguro a API Choose between API keys for server-to-server or OAuth 2.0 for user-delegated access. ### Claves API Genera claves API para autenticar tus solicitudes. Crea tokens privados con fechas de expiración opcionales para acceso seguro. Añadir Clave API Nombre de la Clave API Establecer Fecha de Expiración Sin Expiración Crear Token Privado •••••••••••••••••••••••••••••••• •••••••••••••••••••••••••••••••• ### OAuth 2.0 Autorización estándar de la industria para acceso delegado por el usuario. Perfecto para integraciones de marketplace. 1 #### Redirigir a Autorización Envía usuarios a la pantalla de consentimiento de Mihu GET /oauth/authorize?client_id=... 2 #### Recibir Código de Autorización El usuario otorga permiso, obtienes un código ?code=abc123&state=xyz 3 #### Intercambiar por Token de Acceso Cambia el código por un token de acceso POST /oauth/token Referencia API ## Documentación Completa de Endpoints Explore our RESTful API with detailed request/response examples for every endpoint. Referencia API Llamada post /call WhatsApp post /whatsapp/template Citas GET /appointments post /appointments Contactos GET /contacts post /contacts Tareas GET /tasks post /tasks Campañas GET /campaigns Programaciones GET /schedules Transcripciones GET /transcriptions post /api/v1/call ### Iniciar Llamada Saliente Inicia una llamada saliente usando un agente IA especificado. El agente llamará al número del participante y seguirá las instrucciones del prompt configurado. #### Parámetros de Solicitud Parámetro Tipo Requerido Descripción agentId string Requerido UUID del agente IA a usar para la llamada participant.number string Requerido Número de teléfono a llamar (formato E.164) participant.about string Opcional Contexto sobre el participante para la IA prompt.content string Opcional Prompt personalizado para sobrescribir el predeterminado del agente prompt.overwrite boolean Opcional Si sobrescribir el prompt predeterminado message.start string Opcional Mensaje de apertura cuando la llamada conecta #### Ejemplo de Solicitud POST /api/v1/call application/json { "agentId" : "32d8fc98-be1e-4d32-a12e-146f397fb1cb" , "prompt" : { "overwrite" : true , "content" : "Eres Michael del equipo de soporte..." }, "participant" : { "number" : "+1 (415) 555-0123" , "about" : "Cliente llamado John Doe. Pedido #12345." }, "message" : { "start" : "¡Hola! Soy Michael de soporte." } } #### Respuesta 200 OK application/json { "success" : true , "message" : "Operación completada exitosamente" , "data" : { "callId" : "call_abc123def456" , "status" : "initiated" } } WEBHOOKS ## Notificaciones de Eventos en Tiempo Real Set up Webhooks to trigger actions on external services in real-time. Stay informed on updates and changes to ensure seamless integration. Configuración de Webhooks URL de Webhook Clave Secreta Tipo de Evento Actualización de Conversación Informe de Fin de Conversación Estado de Conversación Llamada de Intención Evaluación de Texto Evaluación de Voz Guardar Cambios Configuración Actual de Webhook URL: https://example.com/webhooks/mihu Eventos Activos: Informe de Fin de Conversación, Evaluación de Texto, Evaluación de Voz Ejemplo 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" : "El cliente preguntó sobre el estado del pedido..." } } ## ¿Listo para Comenzar a Construir? Obtén tu clave API y despliega tu primera integración en minutos. El nivel gratuito incluye 1,000 llamadas API por mes. Obtener Clave API (https://app.mihu.ai/register) Leer la Documentación (https://developers.mihu.ai)