Gestión de llamadas
Inicie llamadas desde su software (clic para llamar), finalice la llamada en curso, transfiérala o silénciela. Todos los endpoints requieren una clave de API (alcance call; Authorization: Bearer bt_… en el encabezado, véase Seguridad de la API) con y GET se llama con el método.
Límite de velocidad: 10 solicitudes por minuto. Identificador de llamada (call_uuid)begin_callvuelve en la respuesta y en los datos de llamadas en vivo.
GETIniciar llamada (clic para llamar)
Primero suena la extensión indicada; al contestar la extensión se llama al número de destino y se conectan ambas partes.
GET https://api.buluthat.com/api/begin_call.php?extension=1001&destination=905321234567| Parámetro | Obligatorio | Descripción |
|---|---|---|
Authorization (encabezado) | sí | Bearer bt_…, alcance call |
extension | sí | Extensión a la que se conectará la llamada (p. ej. 1001) |
destination | sí | Número al que llamar. Para Turquía 905321234567, para el extranjero 00 + código de país |
caller_id | no | Número que se mostrará en la llamada externa; si no se indica, el predeterminado de la extensión. Un número que no pertenece a su cuenta 400 devuelve |
manual_answer | no | true si es, se espera que la extensión conteste manualmente; si no se indica, en los dispositivos compatibles se contesta automáticamente |
timeout | no | Tiempo de timbre, 10-60 s (por defecto 30) |
announcement_to_caller | no | ID de la locución que se reproducirá a la extensión al conectarse |
announcement_to_callee | no | ID de la locución que se reproducirá a quien se llama al conectarse |
Respuesta correcta: 200 OK, el identificador de la llamada en el cuerpo.
358c20bc-fd86-11e5-87a2-157d41a07454Ejemplos de respuestas con error:
400 Bad Request extension 1005 not found
400 Bad Request caller_id 02120000000 not allowed
401 Unauthorized Geçersiz anahtar: K…GETFinalizar la llamada
GET https://api.buluthat.com/api/hangup.php?id=<call_uuid>id en lugar de, también se acepta el formato de ruta: /api/hangup/<call_uuid>. Respuesta 200 OK.
GETTransferir la llamada
Transfiere la llamada en curso a una extensión o a un número externo.
GET https://api.buluthat.com/api/transfer.php?id=<call_uuid>&user_number=1002| Parámetro | Descripción |
|---|---|
id | Identificador de llamada |
user_number | Extensión de destino (p. ej. 1002) o número externo (905321234567) |
GETSilenciar / activar sonido
GET https://api.buluthat.com/api/mute.php?id=<call_uuid>&state=onstate: on (silenciar) o off (activar sonido).
Datos de llamadas en vivo
La lista de llamadas en curso (llamante, llamado, extensión, estado, duración) se lee desde el endpoint del puente CRM; para abrir la ficha del cliente en una llamada entrante use estos datos o los webhooks. Para el detalle, solicite el documento "Puente CRM" al Centro de Soporte; para Byfix CRM el puente ya está listo.
Flujo típico: clic para llamar desde el CRM
1. Kullanıcı CRM'de numaraya tıklar
2. Sunucunuz begin_call'u çağırır (extension = kullanıcının dahilisi)
3. Dahili çalar, açınca müşteri aranır; call_uuid'yi kaydedin
4. Görüşme bitince CDR raporda; kayıt panelden dinlenir