Estado en vivo de la centralita: extensiones ocupadas/libres y las llamadas activas ahora mismo (uuid, quién llama, destino, estado). El uuid sirve como callId para colgar/transferir/grabar.

Registro de llamadas (Call Detail Records). Devuelve como máximo 50 por petición, las más recientes primero, dentro del rango. Para recorrer un día/periodo entero usa 'pbx_calls_in_range', que pagina solo.

Detalle de una llamada concreta por su callId (uuid).

Número total de llamadas registradas (opcionalmente dentro de un rango).

Devuelve la URL directa de descarga (audio/mpeg) de la grabación de una llamada. Requiere cabecera X-Api-Key para descargarla. Para guardarla en disco usa 'pbx_download_recording'.

Descarga el MP3 de la grabación de una llamada y lo guarda en la carpeta de grabaciones del servidor (CENTRALITA_RECORDINGS_DIR). Devuelve la ruta local del archivo, lista para transcribir.

Lista de extensiones (usuarios SIP) con su número, nombre, email, dominio y estado. Las contraseñas SIP/web se redactan salvo que el servidor arranque con CENTRALITA_ALLOW_SECRETS=true.

Ficha de una extensión por su id interno (no el número). Contraseñas redactadas salvo CENTRALITA_ALLOW_SECRETS=true.

Devuelve el id interno de una extensión a partir de su número/username (ej. '1003').

Colas de llamadas configuradas.

Detalle de una cola por su id.

Personas esperando en cola ahora mismo. Sin queueId devuelve todas las colas; con queueId, solo esa.

Estado en vivo de una cola por su número.

Tiempo de espera estimado/actual de una cola por su número.

Agentes del call center.

Detalle de un agente por su id.

Catálogo de tipos de pausa/descanso de agentes.

Histórico/listado de cambios de estado de agentes.

Conteo agregado de cambios de estado de agentes.

Agenda de la centralita (nombre, número, marcación rápida). Filtra por subcadena de nombre con 'q' y limita con 'limit'.

Busca un contacto de la agenda por su número de teléfono.

Locuciones/anuncios (IVR, etc.). El audio en base64 se omite por defecto para no saturar; pásalo con includeAudio=true.

Detalle de una locución por su id. El audio base64 se omite salvo includeAudio=true.

Mensajes de voz de una extensión (por su id interno).

Detalle de un mensaje de voz concreto.

Descarga el audio de un mensaje de voz y lo guarda en la carpeta de grabaciones. Devuelve la ruta local.

Encuestas de satisfacción configuradas.

Recupera TODAS las llamadas de un día o rango recorriendo la paginación del CDR (tope 50/petición) y deduplicando. Devuelve la lista completa y un resumen: total, por tipo (entrante/saliente/interna), atendidas vs no atendidas y por causa de cuelgue.

Productividad telefónica por extensión en un día/rango: llamadas salientes hechas (y cuántas con respuesta), entrantes atendidas y minutos en línea. Resuelve el número de extensión a nombre del trabajador.

Listado compacto número → nombre → email → id de cada extensión, para resolver quién es quién. Sin contraseñas.

Lista las llamadas con grabación (recording=true) de un día/rango, con su metadato y la URL de descarga del MP3. Punto de partida para descargar y transcribir. No descarga nada por sí mismo.

Lanza una llamada: primero hace sonar la extensión 'from' y, cuando descuelga, marca a 'to'. Es el click-to-call clásico para que un trabajador llame a un número. ⚠️ Hace sonar teléfonos reales.

Conecta dos números cualesquiera 'from' y 'to' a través de la centralita (callback). ⚠️ Hace sonar teléfonos reales.

Llama a 'to' y, al contestar, lo encola en la cola indicada. ⚠️ Llamada real.

Variante inversa: marca a 'to' en nombre de la cola. ⚠️ Llamada real.

Cuelga la llamada activa indicada por su callId/uuid (lo da pbx_live_status). ⚠️ Corta una llamada real.

Cuelga la llamada indicada dentro de N segundos. ⚠️ Cortará una llamada real.

Transfiere la llamada en curso a 'destination' sin consulta previa. ⚠️ Desvía una llamada real.

Inicia una transferencia con consulta: pone la llamada en espera y marca a 'destination' para hablar antes de completar. ⚠️ Llamada real.

Completa la transferencia atendida iniciada previamente (une las dos partes y sale).

Cancela una transferencia atendida en curso y recupera la llamada original.

Activa la grabación de la llamada activa indicada. Aviso legal: graba a personas reales; asegúrate del consentimiento/aviso.

Detiene la grabación de la llamada activa indicada.

Inyecta/reproduce una locución (announcementId) dentro de la llamada en curso. ⚠️ Audio en una llamada real.

Modifica campos de una extensión (ej. name, email, dnd, cw…). Pasa solo los campos a cambiar en 'fields'. Consulta primero la ficha con pbx_get_extension.

Genera una nueva contraseña SIP para la extensión. ⚠️ El teléfono/softphone dejará de registrarse hasta reconfigurarlo con la nueva clave.

Da de alta o actualiza un contacto de la agenda de la centralita (nombre, número, marcación rápida).

Cambia el estado de un agente (login/logout/pausa…). 'newStatus' es el código de estado de la plataforma.

Escribe variables/etiquetas (var1…var5 u otras) sobre el registro de una llamada. Útil para clasificar llamadas (cliente, motivo, expediente…).

Marca un mensaje de voz como escuchado/leído.

Marca un mensaje de voz como no escuchado.

Elimina un mensaje de voz del buzón de una extensión. ⚠️ Acción irreversible.