Centro de desarrolladores

Haga de su central una parte de su software.

Una sola clave de API, HTTP plano, respuestas JSON. Todo es REST, desde el clic para llamar y el control de llamadas hasta las campañas de llamadas automáticas, las tareas del asistente de voz y el código de verificación por voz; los resultados vuelven con webhooks firmados con HMAC.

Inicio rápido

Su primera solicitud en 2 minutos

Obtenga su clave en Panel > Llamadas automáticas > pestaña API (o en Ajustes de la central); envíela con el encabezado Bearer, X-Api-Key o ?key=.

  • La clave está vinculada a su cuenta de cliente; no puede acceder a datos de otro cliente.
  • Las operaciones de lectura son GET y las que modifican son POST; cuerpo JSON o formulario.
  • La respuesta de error siempre {"ok":false,"error":"…","code":"…"} tiene el formato.
  • Límite de velocidad: 120 solicitudes por minuto por clave; al superarlo, 429.
# clic para llamar: primero suena la extensión 1001, al contestar se llama al destino curl "https://api.buluthat.com/api/begin_call.php?key=K1234-…&extension=1001&destination=905321234567" # crear campaña curl -X POST "https://api.buluthat.com/api/autocall.php?action=create_campaign" \ -H "Authorization: Bearer bt_xxxxxxxx" \ -H "Content-Type: application/json" \ -d '{"name":"Recordatorio de pago","campaign_type":"ivr", "tts_template":"Hola {sayin}, su pago por {tutar}…", "digit_labels":{"1":"Ya pagué","2":"Responsable"}}' # enviar código de verificación por voz curl -X POST "https://api.buluthat.com/api/voice_otp.php?action=send" \ -H "X-Api-Key: bt_xxxxxxxx" -d "phone=905321234567" → {"ok":true,"id":8812,"code":"472915","expires_in":300}
Webhooks

Que los resultados le lleguen a usted, sin que tenga que preguntar.

Resultado de la llamada automática, resumen de la conversación del asistente de voz, estado del código de verificación — cada evento se envía por POST a su dirección en formato JSON; el encabezado X-Buluthat-Signature es la firma HMAC-SHA256. Una entrega fallida se reintenta con intervalos de 1 min → 6 horas.

Documento de webhook
// PHP: verificación de firma $raw = file_get_contents('php://input'); $sig = $_SERVER['HTTP_X_BULUTHAT_SIGNATURE'] ?? ''; $calc = hash_hmac('sha256', $raw, $secret); if (!hash_equals($calc, $sig)) { http_response_code(401); exit; } $event = json_decode($raw, true); // $event['event'] = 'call_finished' | 'session_ended' | 'otp_result' …
Puente con Byfix CRM

El asistente de voz encuentra al cliente en el CRM, abre registros de servicio y deja notas; se inicia "llamar con el asistente" desde el CRM. Listo, con una sola clave.

Detalle
Cliente PHP

Clase PHP lista para el código de verificación por voz; enviar/verificar con dos líneas. Los demás endpoints son HTTP plano, así que se llaman desde cualquier lenguaje.

Ejemplo
Pantalla en vivo incrustable

La transcripción en vivo de la conversación del asistente va en un iframe dentro del CRM; con token firmado de duración limitada, sin necesidad de sesión en el panel.

embed_url