API e Desenvolvedores

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

99.9%
Disponibilidade da API
<100ms
Resposta
50+
Endpoints
API REST
1# Iniciar uma chamada de saída
--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": "Cliente 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);
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.mindhunters.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
••••••••••••••••••••••••••••••••
••••••••••••••••••••••••••••••••

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
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
Configuração atual do webhook
URL: https://integration.mihu.ai/webhook/422ffbc1-5068-4e83-bbbb-297d53f09ce3
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.