> ## 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

> Use the built-in business phone system on web, mobile, and registered desk phones.

Famulor Loop gives every enabled workspace member a personal extension, availability status, registered devices, and personal call recents.

## Availability

Loop becomes available when it is included in the workspace plan, enabled in workspace settings, enabled for your membership, and connected to an active [number purchased through Famulor](/telephony/phone-numbers).

<Note>
  Loop access is a member feature, not a separate workspace role. Only the workspace owner can turn it on or off for each member.
</Note>

## Personal phone workspace

Use Loop to:

* set your status to available, busy, do not disturb, or offline;
* call from the web or mobile softphone;
* register and revoke your own devices;
* find available colleagues by name or extension;
* see your personal calls under Loop Recents.

Loop Recents are separate from the omnichannel assistant History. Your role continues to determine whether you can view assistant history.

Managed clients appear in Devices as **Loop Web Phone**, **Loop iOS App**, or **Loop Android App**. You can rename or revoke your own devices. Names you assign to external SIP phones remain unchanged.

To register a desk phone or another third-party SIP client, add it under **Devices** — a workspace owner or admin creates the device and picks the Loop member it belongs to. Famulor then shows the registration details: SIP URI, server, username, password, and port/transport. The password appears only at that moment, so copy it into the phone or client straight away; the other fields stay readable on the device afterwards. **New password** issues a fresh one and invalidates the old immediately, so update every client that was still using it.

## Popout window

Loop can also be popped out of the dashboard into its own browser tab or window — no extension needed. Select the expand icon in the softphone dock to open it; the main Loop page then shows a **Show Loop tab** prompt that brings the popout back into view.

## Chrome extension

Famulor Loop is also available as a Chrome side panel — a compact dialer that stays open next to whatever tab you're working in, so you don't need the full dashboard open to take a call.

<Steps>
  <Step title="Add the extension to Chrome">
    Install **Famulor Loop** from the Chrome Web Store, then open its side panel from the toolbar icon. **Alt + Shift + L** opens it from anywhere in Chrome.
  </Step>

  <Step title="Get a pairing PIN">
    Open `https://app.famulor.io/device` in a signed-in browser tab — the side panel has a button for it. The page shows a 4-digit PIN, valid for two minutes and usable once.
  </Step>

  <Step title="Pair the extension">
    Enter that PIN in the side panel and connect. The browser then appears in Devices as **Chrome extension**, and you can revoke it there like any other client.
  </Step>
</Steps>

From the side panel you can dial and receive calls; mute, use the keypad, and end an active call; and keep an accepted call running even if you close the panel. Notifications cover incoming, missed, and failed calls — accept or decline an incoming call from the panel, or straight from the notification where your browser and operating system offer those buttons. The panel also shows your call history and the assistant conversations you're authorized to see, without opening the full dashboard. Chrome asks for microphone access the first time you call from it.

<Note>
  Calling from the extension needs Famulor Loop enabled for your membership, the same as any other Loop client — see Availability above. Without it, the panel hides the dialer and shows only the conversations you're authorized to see.
</Note>

## Team usage

When Loop is available, the Usage page adds Loop-only statistics for the selected period: calls, minutes, customer credits, answer rate, inbound and outbound trends, and a breakdown by team member. This section is hidden when Loop is unavailable. Provider prices, margins, and carrier identifiers are never shown.

## Personal working hours

Set a weekly schedule and timezone in **Softphone → Settings** when assistant transfers should reach you. Your manual Busy, Do not disturb, or Offline status, active calls, and registered clients still take priority.

**When you cannot be reached** is disabled by default. You may opt into a validated cold-transfer destination, an active assistant, or an existing visible routing rule. This applies only to direct assistant transfers to you or your extension; it does not silently change phone-number routes, ring groups, or queues. A successful assistant handoff is terminal.

User-owned API credentials can read or replace the schedule, fallback, and Recall appointment calendar with `GET /loop/availability` and `PATCH /loop/availability`. A null timezone inherits the workspace timezone. Omitting `fallback` or `recall_appointment_calendar_id` preserves the current value.

## Dialing country

In Softphone Settings, choose the personal default country used for numbers entered without an international country code. For example, a German mobile number beginning with `0170` is converted to `+49` format before the call starts. A number that already begins with `+44` keeps that country code, and internal Loop extensions are never expanded.

User-owned integrations can read or update this preference with `GET /loop/preferences` and `PATCH /loop/preferences`.

## Recall

Recall keeps follow-up requests assigned to you when a transfer was missed or a caller asked to be called back. From the softphone, you can call the person yourself, ask a selected assistant to connect the person to you, ask the assistant to arrange an appointment, or mark the item as resolved. Choose the calendar used for Recall appointments under Softphone → Settings. Connect calendars on the [Booking page](/assistants/calendar-booking) first, then select one here. After you start an assistant, the softphone shows that the assistant is calling instead of the Recall details.

`GET /loop/recalls` returns only Recall items assigned to the authenticated member, including for owners and admins. Use `POST /loop/recalls/{id}/actions` for the available actions. A successful assistant start becomes the remembered choice for that member.

The application can show scheduled assistant callbacks and personal Recall requests in the same callback workspace. Their public resources remain separate: existing scheduled callback integrations continue to use `/scheduled-callbacks`, while personal Recall integrations use `/loop/recalls`.

## Workspace call routing

Workspace owners and admins can manage the same Loop configuration from the app, REST API, or MCP:

* workspace availability, default phone number, dialing country, recording, and default routing rule;
* ring groups with simultaneous, sequential, or round-robin ringing, per-member delay, ring timeout, and optional presence filtering;
* call queues with atomic round-robin, sequential or longest-idle routing, wait time, wrap-up time, member order, per-member capacity, and an overflow rule;
* ordered routing rules for members, extensions, groups, queues, assistants, another rule, or an external number;
* inbound destinations for active phone numbers purchased through Famulor.

Use `PATCH /loop` for workspace settings and the `/loop/ring-groups`, `/loop/queues`, `/loop/routing-rules`, and `/loop/number-routes` resources for call routing. Read operations require `loop:read`; changes require `loop:write`. User-owned credentials must belong to a workspace owner or admin.

Ring-group and queue writes accept ordered member assignments, including a delay for ring-group members and concurrent-call capacity for queue members. The older flat member list remains accepted for compatible integrations.

Routing rules share one optional weekly schedule. Each step runs always, during those hours, or outside those hours, and continues only for selected pre-answer outcomes: unavailable, busy, timeout, or error. An answered person or assistant always stops the rule. Updates are atomic and cyclic references are rejected.

```mermaid theme={null}
flowchart TD
  A(["Call enters the routing rule"]) --> B{"Step's schedule condition"}
  B -->|"step runs"| C["Attempt the step's target"]
  B -->|"step skipped — no outcome"| N{"Another step in the rule?"}
  C --> D{"Outcome"}
  D -->|"answered"| E(["Rule stops — call handled"])
  D -->|"a selected pre-answer outcome"| N
  D -->|"any other pre-answer outcome"| Z(["Rule ends — nobody took the call"])
  N -->|"Yes"| B
  N -->|"No"| Z
```

## API and MCP

The REST API exposes Loop access and settings, the directory, personal presence, working hours and dialing preferences, registered-device metadata, device revocation, personal call recents and Recall items, and workspace call routing. Use the `loop:read` and `loop:write` permissions. Personal preferences, working hours and Recall require a user-owned credential associated with a workspace member.

Equivalent MCP tools are available in the Telephony toolset. Devices use `list_loop_devices`, `rename_loop_device`, and `revoke_loop_device`; personal schedules use `get_loop_availability` and `update_loop_availability`; dialing preferences use `get_loop_dialing_preferences` and `update_loop_dialing_preferences`; Recall uses `list_loop_recalls` and `act_on_loop_recall`. Public responses never include registration secrets, raw failure diagnostics, or internal cost data. Usage is shown in minutes and credits.

<Warning>
  New registration details are displayed once in the authenticated application. They are not available through the public API or MCP.
</Warning>