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.
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.
Encabezados de la API
En cada encabezado, la dirección del endpoint, los parámetros y un ejemplo de solicitud y respuesta.
Visión general
Autenticación, formato de solicitud, códigos de error, límites de velocidad
LeerSeguridad de la API
Claves y alcances, IP permitidas, firma HMAC de solicitudes, renovación de claves, registro de solicitudes
LeerGestión de llamadas
Clic para llamar, finalizar, transferir, silenciar
LeerColas
Lista de colas, en espera, agregar/quitar miembros
LeerEstados de agentes
Estados de extensiones y membresías de colas
LeerLista negra
Listar, agregar y eliminar números bloqueados
LeerArchivos de audio
Lista de locuciones, carga, actualización, eliminación
LeerLlamadas automáticas
Crear campaña, agregar números, obtener resultados, webhook
LeerAsistente de Voz
Conversaciones, notas, citas, llamadas de tarea, incrustación
LeerVerificación por voz (OTP)
Enviar código, verificar, estado, webhook
LeerAPI de SMS
SMS masivo / personalizado, SMS OTP, informe de entrega, SMS entrantes, lista negra
LeerWebhooks
Verificación de firma, política de reintentos, esquemas de eventos
LeerIncrustar (iframe de CRM)
En las pantallas de la central y en su software de WebPhone: código, enlace firmado, eventos de JavaScript
LeerQue 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.
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.
DetalleCliente 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.
EjemploPantalla 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