Extensiones y dispositivos
Rutas: /extensions y /devices (vea /api/docs para la referencia completa).
Extensiones
La página de Extensiones.
Una extensión es un número marcable dentro de una empresa.
| Campo | Significado |
|---|---|
number | De 1 a 16 dígitos, único por empresa. |
kind | A qué llega el número: user, queue, ivr, ringgroup, conference, park, paging o fax. Predeterminado user. |
user_id | El propietario, solo para kind = user. Un usuario tiene como máximo una extensión. |
display_name | Se muestra en los teléfonos y en el directorio. Para una extensión con propietario, por omisión es el nombre del usuario. |
enabled | Las extensiones desactivadas no son enrutables. |
target_flow_id | Solo para kind = ivr: el menú IVR o el flujo de llamada que ejecuta una llamada interna al número (vea Menús IVR). null significa ninguno. |
Permisos: extensions:read y extensions:write, ambos limitados al departamento.
Una extensión pertenece al departamento de su propietario. Una extensión sin propietario (una cola, un IVR, un grupo de timbrado o un número reservado) es de toda la empresa, así que necesita el permiso de toda la empresa. Para quitar un propietario, use PATCH con remove_owner: true. Al eliminar una extensión también se eliminan sus dispositivos.
No se permite asignar una extensión a una cuenta que tiene un rol de sistema, ni quitársela, para los principales de empresa (MPBX-ACCOUNT-SYSTEM).
Dispositivos
La página de Dispositivos. Los nombres de usuario SIP están difuminados; las contraseñas SIP nunca se muestran.
Un dispositivo es una identidad SIP (un teléfono de escritorio, un softphone o una aplicación) de una extensión.
| Campo | Significado |
|---|---|
extension_id | La extensión a la que pertenece. |
name | Una etiqueta para el dispositivo. |
sip_username | Lo genera el servidor. |
transport_policy | Qué transportes SIP puede usar el dispositivo. |
mac, model, provisioning_template | Datos de hardware opcionales. Una cadena vacía en PATCH los borra. |
has_credentials | Si el dispositivo tiene credenciales SIP. Las rutas de dispositivos nunca muestran las credenciales en sí. |
revoked_at | Se define cuando el dispositivo fue revocado. |
Permisos: devices:read y devices:write, limitados al departamento a través del propietario de la extensión.
POST /devices/{id}/revoke elimina las credenciales del dispositivo y evita que se registre. Crear y rotar las credenciales es un flujo aparte por dispositivo que no forma parte de estas rutas.
Los registros activos se publican como eventos device en el WebSocket de eventos para quienes tienen devices:read.
Aprovisionamiento automático de teléfonos
Los teléfonos de escritorio (Yealink, Fanvil, Snom, Grandstream) se configuran automáticamente a partir de su dirección MAC. Vea Aprovisionamiento de teléfonos de escritorio. Para conectar una aplicación o un navegador, vea Agregar usuarios, extensiones y teléfonos.