> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Famulor Loop

> Usa el sistema telefónico empresarial integrado en la web, el móvil y los teléfonos de escritorio registrados.

Famulor Loop ofrece a cada miembro habilitado del espacio de trabajo una extensión personal, un estado de disponibilidad, dispositivos registrados y un historial de llamadas personal.

## Disponibilidad

Loop está disponible cuando se incluye en el plan del espacio de trabajo, está activado en los ajustes del espacio de trabajo, está habilitado para tu membresía y está conectado a un [número activo comprado a través de Famulor](/es/telephony/phone-numbers).

<Note>
  El acceso a Loop es una función de cada miembro, no un rol independiente del espacio de trabajo. Solo el propietario del espacio de trabajo puede activarlo o desactivarlo para cada miembro.
</Note>

## Espacio telefónico personal

Usa Loop para:

* definir tu estado como disponible, ocupado, no molestar o desconectado;
* llamar desde el softphone web o móvil;
* registrar y revocar tus propios dispositivos;
* encontrar compañeros disponibles por nombre o extensión;
* ver tus llamadas personales en Loop Recents.

Loop Recents es independiente del History omnicanal de los asistentes. Tu rol sigue determinando si puedes ver el historial de los asistentes.

Los clientes gestionados aparecen en Devices como **Loop Web Phone**, **Loop iOS App** o **Loop Android App**. Puedes cambiar el nombre o revocar tus propios dispositivos. Los nombres que asignes a teléfonos SIP externos no cambian.

Para registrar un teléfono de sobremesa u otro cliente SIP de terceros, añádelo en **Devices** — un propietario o administrador del espacio de trabajo crea el dispositivo y elige el miembro de Loop al que pertenece. Famulor muestra entonces los datos de registro: SIP URI, servidor, usuario, contraseña y puerto/transporte. La contraseña aparece solo en ese momento, así que cópiala de inmediato en el teléfono o cliente; los demás campos siguen siendo legibles en el dispositivo después. **New password** emite una nueva de inmediato e invalida la anterior, así que actualiza cualquier cliente que siguiera usándola.

## Ventana emergente

Loop también se puede independizar del panel en su propia pestaña o ventana del navegador — sin necesidad de extensión. Selecciona el icono de expandir en el dock del softphone para abrirla; la página principal de Loop muestra entonces un aviso **Show Loop tab** que vuelve a traer la ventana emergente a la vista.

## Extensión de Chrome

Famulor Loop también está disponible como panel lateral de Chrome: un marcador compacto que permanece abierto junto a la pestaña en la que estés trabajando, para que no necesites tener abierto el panel completo con tal de atender una llamada.

<Steps>
  <Step title="Añade la extensión a Chrome">
    Instala **Famulor Loop** desde la Chrome Web Store y luego abre su panel lateral desde el icono de la barra de herramientas. **Alt + Shift + L** lo abre desde cualquier punto de Chrome.
  </Step>

  <Step title="Obtén un PIN de emparejamiento">
    Abre `https://app.famulor.io/device` en una pestaña del navegador con la sesión iniciada; el panel lateral incluye un botón para ello. La página muestra un PIN de 4 dígitos, válido durante dos minutos y de un solo uso.
  </Step>

  <Step title="Empareja la extensión">
    Introduce ese PIN en el panel lateral y conecta. El navegador aparece entonces en Devices como **Chrome extension**, y puedes revocarlo ahí como cualquier otro cliente.
  </Step>
</Steps>

Desde el panel lateral puedes marcar y recibir llamadas; silenciar, usar el teclado numérico y finalizar una llamada activa; y mantener en curso una llamada aceptada aunque cierres el panel. Las notificaciones cubren llamadas entrantes, perdidas y fallidas: acepta o rechaza una llamada entrante desde el panel, o directamente desde la notificación cuando tu navegador y tu sistema operativo ofrezcan esos botones. El panel también muestra tu historial de llamadas y las conversaciones de asistentes que estés autorizado a ver, sin necesidad de abrir el panel completo. Chrome solicita acceso al micrófono la primera vez que llamas desde ahí.

<Note>
  Llamar desde la extensión requiere que Famulor Loop esté habilitado para tu membresía, igual que con cualquier otro cliente Loop; consulta Disponibilidad más arriba. Sin eso, el panel oculta el marcador y solo muestra las conversaciones que estés autorizado a ver.
</Note>

## Uso del equipo

Cuando Loop está disponible, la página Usage añade estadísticas exclusivas de Loop para el período seleccionado: llamadas, minutos, créditos del cliente, tasa de respuesta, tendencias de llamadas entrantes y salientes, y un desglose por miembro del equipo. Esta sección se oculta cuando Loop no está disponible. Nunca se muestran los precios del proveedor, los márgenes ni los identificadores del operador.

## Horario personal

Configura un horario semanal y una zona horaria en **Softphone → Settings** para cuándo deben llegarte las transferencias de asistentes. Tu estado manual de ocupado, no molestar o desconectado, las llamadas activas y los clientes registrados siguen teniendo prioridad.

**When you cannot be reached** está desactivado de forma predeterminada. Puedes optar por un destino de transferencia directa validado, un asistente activo o una regla de enrutamiento visible ya existente. Esto solo se aplica a las transferencias directas de un asistente hacia ti o tu extensión; no cambia de forma silenciosa las rutas de números de teléfono, los grupos de llamada ni las colas. Una entrega correcta a un asistente es terminal.

Las credenciales de API vinculadas a un usuario pueden leer o sustituir el horario, el fallback y el calendario de citas de Recall mediante `GET /loop/availability` y `PATCH /loop/availability`. Un valor `null` en la zona horaria hereda la del espacio de trabajo. Si se omite `fallback` o `recall_appointment_calendar_id`, se conserva el valor actual.

## País de marcación

En Softphone → Settings, elige el país predeterminado personal que se usa para los números introducidos sin código de país internacional. Por ejemplo, un número de móvil alemán que empieza por `0170` se convierte al formato `+49` antes de iniciar la llamada. Un número que ya empieza por `+44` conserva ese código de país, y las extensiones internas de Loop nunca se amplían.

Las integraciones vinculadas a un usuario pueden leer o actualizar esta preferencia mediante `GET /loop/preferences` y `PATCH /loop/preferences`.

## Recall

Recall mantiene asignadas a ti las solicitudes de seguimiento cuando se pierde una transferencia o quien llama pide que le devuelvan la llamada. Desde el softphone puedes llamar tú mismo a la persona, pedirle a un asistente seleccionado que la conecte contigo, pedirle al asistente que concierte una cita, o marcar el elemento como resuelto. Elige el calendario que se usa para las citas de Recall en Softphone → Settings. Conecta antes los calendarios en la [página Booking](/es/assistants/calendar-booking) y luego selecciona uno aquí. Después de iniciar un asistente, el softphone muestra que el asistente está llamando en lugar de los detalles de Recall.

`GET /loop/recalls` devuelve únicamente los elementos de Recall asignados al miembro autenticado, también para propietarios y administradores. Usa `POST /loop/recalls/{id}/actions` para las acciones disponibles. El inicio correcto de un asistente queda guardado como la elección recordada para ese miembro.

La aplicación puede mostrar las devoluciones de llamada programadas por asistentes y las solicitudes personales de Recall en el mismo espacio de callbacks. Sus recursos públicos siguen siendo independientes: las integraciones existentes de devoluciones programadas siguen usando `/scheduled-callbacks`, mientras que las integraciones personales de Recall usan `/loop/recalls`.

## Enrutamiento de llamadas del espacio de trabajo

Los propietarios y administradores del espacio de trabajo pueden gestionar la misma configuración de Loop desde la aplicación, la API REST o MCP:

* disponibilidad del espacio de trabajo, número de teléfono predeterminado, país de marcación, grabación y regla de enrutamiento predeterminada;
* grupos de llamada con timbrado simultáneo, secuencial o por turnos, retraso por miembro, tiempo límite de timbrado y filtro de presencia opcional;
* colas de llamadas con enrutamiento atómico por turnos, secuencial o por mayor tiempo inactivo, tiempo de espera, tiempo de cierre, orden de miembros, capacidad por miembro y una regla de desbordamiento;
* reglas de enrutamiento ordenadas hacia miembros, extensiones, grupos, colas, asistentes, otra regla o un número externo;
* destinos de entrada para números de teléfono activos comprados a través de Famulor.

Usa `PATCH /loop` para los ajustes del espacio de trabajo, y los recursos `/loop/ring-groups`, `/loop/queues`, `/loop/routing-rules` y `/loop/number-routes` para el enrutamiento de llamadas. Las operaciones de lectura requieren `loop:read`; los cambios requieren `loop:write`. Las credenciales vinculadas a un usuario deben pertenecer a un propietario o administrador del espacio de trabajo.

Las escrituras de grupos de llamada y colas aceptan asignaciones de miembros ordenadas, incluido un retraso para los miembros de un grupo de llamada y una capacidad de llamadas simultáneas para los miembros de una cola. La lista plana de miembros anterior se sigue aceptando para las integraciones compatibles.

Las reglas de enrutamiento comparten un horario semanal opcional. Cada paso se ejecuta siempre, durante ese horario o fuera de ese horario, y solo continúa para los resultados previos a la respuesta seleccionados: no disponible, ocupado, tiempo agotado o error. Cuando una persona o un asistente responde, la regla se detiene siempre. Las actualizaciones son atómicas y se rechazan las referencias cíclicas.

```mermaid theme={null}
flowchart TD
  A(["La llamada entra en la regla de enrutamiento"]) --> B{"Condición de horario del paso"}
  B -->|"el paso se ejecuta"| C["Intenta el destino del paso"]
  B -->|"paso omitido — sin resultado"| N{"¿Otro paso en la regla?"}
  C --> D{"Resultado"}
  D -->|"contestada"| E(["La regla se detiene — llamada atendida"])
  D -->|"un resultado previo a la respuesta seleccionado"| N
  D -->|"cualquier otro resultado previo a la respuesta"| Z(["La regla termina — nadie atendió la llamada"])
  N -->|"Sí"| B
  N -->|"No"| Z
```

## API y MCP

La API REST expone el acceso y los ajustes de Loop, el directorio, la presencia personal, el horario y las preferencias de marcación, los metadatos de los dispositivos registrados, la revocación de dispositivos, las llamadas recientes personales y los elementos de Recall, y el enrutamiento de llamadas del espacio de trabajo. Usa los permisos `loop:read` y `loop:write`. Las preferencias personales, el horario y Recall requieren una credencial vinculada a un usuario asociada a un miembro del espacio de trabajo.

Las herramientas MCP equivalentes están disponibles en el conjunto de herramientas Telephony. Los dispositivos usan `list_loop_devices`, `rename_loop_device` y `revoke_loop_device`; los horarios personales usan `get_loop_availability` y `update_loop_availability`; las preferencias de marcación usan `get_loop_dialing_preferences` y `update_loop_dialing_preferences`; Recall usa `list_loop_recalls` y `act_on_loop_recall`. Las respuestas públicas nunca incluyen secretos de registro, diagnósticos de errores sin procesar ni datos internos de coste. El consumo se muestra en minutos y créditos.

<Warning>
  Los datos de un nuevo registro se muestran una sola vez en la aplicación autenticada. No están disponibles mediante la API pública ni MCP.
</Warning>
