API y desarrolladores

Build with the 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.

99.9%
Disponibilidad API
<100ms
Respuesta
50+
Endpoints
REST API
1# Iniciar una llamada saliente
--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);
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.mindhunters.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
••••••••••••••••••••••••••••••••
••••••••••••••••••••••••••••••••

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
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
Configuración Actual de Webhook
URL: https://integration.mihu.ai/webhook/422ffbc1-5068-4e83-bbbb-297d53f09ce3
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.