> ## 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 > Nutze die integrierte Business-Telefonanlage im Web, auf Mobilgeräten und mit registrierten Tischtelefonen. Famulor Loop gibt jedem aktivierten Workspace-Mitglied eine persönliche Durchwahl, einen Verfügbarkeitsstatus, registrierte Geräte und persönliche Anruflisten. ## Verfügbarkeit Loop wird verfügbar, wenn es im Workspace-Plan enthalten, in den Workspace-Einstellungen aktiviert, für deine Mitgliedschaft freigeschaltet und mit einer aktiven, [über Famulor gekauften Nummer](/de/telephony/phone-numbers) verbunden ist. Der Zugriff auf Loop ist eine Mitgliederfunktion, keine eigene Workspace-Rolle. Nur der Workspace-Owner kann Loop für jedes Mitglied ein- oder ausschalten. ## Persönlicher Telefonbereich Mit Loop kannst du: * deinen Status auf verfügbar, beschäftigt, nicht stören oder offline setzen; * über das Web- oder Mobile-Softphone telefonieren; * eigene Geräte registrieren und widerrufen; * verfügbare Kollegen nach Name oder Durchwahl finden; * persönliche Anrufe unter Loop Recents sehen. Loop Recents sind von der kanalübergreifenden History der Assistenten getrennt. Ob du diese History einsehen kannst, bestimmt weiterhin deine Rolle. Verwaltete Clients erscheinen unter Devices als **Loop Web Phone**, **Loop iOS App** oder **Loop Android App**. Du kannst deine eigenen Geräte umbenennen oder widerrufen. Namen, die du externen SIP-Telefonen gibst, bleiben unverändert. Um ein Tischtelefon oder einen anderen SIP-Client eines Drittanbieters zu registrieren, füge es unter **Devices** hinzu – ein Workspace-Owner oder -Admin legt das Gerät an und wählt das Loop-Mitglied, dem es gehört. Famulor zeigt daraufhin die Registrierungsdaten: SIP-URI, Server, Benutzername, Passwort und Port/Transport. Das Passwort erscheint nur in diesem Moment – kopiere es also sofort in das Telefon oder den Client; die übrigen Felder bleiben danach auf dem Gerät lesbar. **New password** stellt ein neues aus und macht das alte sofort ungültig – aktualisiere daher jeden Client, der es noch verwendet hat. ## Ausklapp-Fenster Loop lässt sich auch aus dem Dashboard heraus in ein eigenes Browser-Tab oder -Fenster auslagern – ganz ohne Erweiterung. Wähle dazu das Erweitern-Symbol im Softphone-Dock; die Loop-Hauptseite zeigt anschließend einen Hinweis **Show Loop tab**, der das ausgelagerte Fenster wieder in den Vordergrund holt. ## Chrome-Erweiterung Famulor Loop ist auch als Chrome-Seitenleiste verfügbar – ein kompakter Dialer, der neben dem Tab geöffnet bleibt, an dem du gerade arbeitest, sodass du für einen Anruf nicht das vollständige Dashboard öffnen musst. Installiere **Famulor Loop** aus dem Chrome Web Store und öffne dann die Seitenleiste über das Symbol in der Symbolleiste. **Alt + Shift + L** öffnet sie von überall in Chrome. Öffne `https://app.famulor.io/device` in einem angemeldeten Browser-Tab – die Seitenleiste hat dafür einen eigenen Button. Die Seite zeigt eine 4-stellige PIN, gültig für zwei Minuten und einmal verwendbar. Gib diese PIN in der Seitenleiste ein und verbinde. Der Browser erscheint danach unter Devices als **Chrome extension** und lässt sich dort wie jeder andere Client widerrufen. Über die Seitenleiste kannst du wählen und Anrufe annehmen; stummschalten, die Tastatur nutzen und einen aktiven Anruf beenden; und einen angenommenen Anruf weiterlaufen lassen, auch wenn du die Seitenleiste schließt. Benachrichtigungen decken eingehende, verpasste und fehlgeschlagene Anrufe ab – nimm einen eingehenden Anruf über die Seitenleiste an oder lehne ihn ab, oder direkt über die Benachrichtigung, sofern dein Browser und Betriebssystem diese Schaltflächen anbieten. Die Seitenleiste zeigt außerdem deine Anrufliste und die Assistant-Konversationen, für die du berechtigt bist – ohne dass du das vollständige Dashboard öffnen musst. Chrome fragt beim ersten Anruf darüber nach Mikrofonzugriff. Für Anrufe über die Erweiterung muss Famulor Loop für deine Mitgliedschaft aktiviert sein, genau wie bei jedem anderen Loop-Client – siehe Verfügbarkeit oben. Ohne das blendet die Seitenleiste den Dialer aus und zeigt nur die Konversationen, für die du berechtigt bist. ## Teamnutzung Wenn Loop verfügbar ist, ergänzt die Usage-Seite reine Loop-Statistiken für den gewählten Zeitraum: Anrufe, Minuten, Kunden-Credits, Annahmequote, Trends für ein- und ausgehende Anrufe sowie eine Aufschlüsselung nach Teammitglied. Dieser Bereich ist ausgeblendet, wenn Loop nicht verfügbar ist. Anbieterpreise, Margen und Carrier-Kennungen werden nie angezeigt. ## Persönliche Arbeitszeiten Lege in **Softphone → Settings** einen Wochenplan und eine Zeitzone fest, wann dich Assistant-Weiterleitungen erreichen sollen. Dein manueller Status Besetzt, Nicht stören oder Offline, aktive Anrufe und registrierte Clients haben weiterhin Vorrang. **When you cannot be reached** ist standardmäßig deaktiviert. Du kannst dich für ein geprüftes Cold-Transfer-Ziel, einen aktiven Assistenten oder eine bestehende, sichtbare Routing-Regel entscheiden. Das gilt nur für direkte Assistant-Weiterleitungen an dich oder deine Durchwahl; Rufnummernrouten, Ring Groups oder Queues werden dadurch nicht stillschweigend verändert. Eine erfolgreiche Assistant-Übernahme ist endgültig. Benutzergebundene API-Zugangsdaten können den Zeitplan, den Fallback und den Recall-Terminkalender über `GET /loop/availability` lesen und mit `PATCH /loop/availability` ersetzen. Bei `null` als Zeitzone wird die Workspace-Zeitzone übernommen. Fehlt `fallback` oder `recall_appointment_calendar_id`, bleibt der aktuelle Wert erhalten. ## Standardland für Anrufe Wähle in den Softphone Settings dein persönliches Standardland für Nummern, die ohne internationale Landesvorwahl eingegeben werden. Eine deutsche Mobilfunknummer, die mit `0170` beginnt, wird zum Beispiel vor Anrufbeginn in das Format `+49` umgewandelt. Eine Nummer, die bereits mit `+44` beginnt, behält diese Landesvorwahl; interne Loop-Durchwahlen werden nie erweitert. Benutzergebundene Integrationen können diese Einstellung über `GET /loop/preferences` lesen und mit `PATCH /loop/preferences` aktualisieren. ## Recall Recall hält dir zugewiesene Rückrufwünsche fest, wenn eine Weiterleitung verpasst wurde oder ein Anrufer um Rückruf gebeten hat. Im Softphone kannst du die Person selbst anrufen, einen ausgewählten Assistenten bitten, die Person mit dir zu verbinden, den Assistenten einen Termin vereinbaren lassen oder den Eintrag als erledigt markieren. Den Kalender für Recall-Termine wählst du unter Softphone → Settings. Verbinde zuerst Kalender unter [Kalender & Buchung](/de/assistants/calendar-booking) und wähle ihn dann hier aus. Nachdem du einen Assistenten gestartet hast, zeigt das Softphone, dass der Assistent anruft, statt der Recall-Details. `GET /loop/recalls` liefert nur Recall-Einträge des authentifizierten Mitglieds, auch für Owner und Admins. Für die verfügbaren Aktionen nutze `POST /loop/recalls/{id}/actions`. Ein erfolgreicher Assistant-Start wird als Auswahl für dieses Mitglied gespeichert. Die Anwendung kann geplante Assistant-Rückrufe und persönliche Recall-Wünsche im selben Rückruf-Arbeitsbereich anzeigen. Ihre öffentlichen Ressourcen bleiben getrennt: Bestehende Integrationen für geplante Rückrufe nutzen weiterhin `/scheduled-callbacks`, persönliche Recall-Integrationen nutzen `/loop/recalls`. ## Anrufrouting im Workspace Workspace-Owner und -Admins können dieselbe Loop-Konfiguration über die Anwendung, die REST-API oder MCP verwalten: * Workspace-Verfügbarkeit, Standard-Telefonnummer, Wählland, Aufzeichnung und Standard-Routing-Regel; * Ring Groups mit gleichzeitigem, sequenziellem oder Round-Robin-Klingeln, Verzögerung pro Mitglied, Klingel-Timeout und optionalem Presence-Filter; * Call Queues mit atomarem Round-Robin-, sequenziellem oder Longest-Idle-Routing, Wartezeit, Nachbearbeitungszeit, Mitgliederreihenfolge, Kapazität pro Mitglied und einer Overflow-Regel; * geordnete Routing-Regeln für Mitglieder, Durchwahlen, Gruppen, Queues, Assistenten, eine weitere Regel oder eine externe Nummer; * eingehende Ziele für aktive, über Famulor gekaufte Telefonnummern. Nutze `PATCH /loop` für Workspace-Einstellungen und die Ressourcen `/loop/ring-groups`, `/loop/queues`, `/loop/routing-rules` und `/loop/number-routes` für das Anrufrouting. Lesezugriffe benötigen `loop:read`, Änderungen `loop:write`. Benutzergebundene Zugangsdaten müssen einem Workspace-Owner oder -Admin gehören. Schreibzugriffe für Ring Groups und Queues akzeptieren geordnete Mitgliederzuweisungen, einschließlich einer Verzögerung für Ring-Group-Mitglieder und paralleler Anrufkapazität für Queue-Mitglieder. Die ältere, flache Mitgliederliste bleibt für kompatible Integrationen weiterhin zulässig. Routing-Regeln teilen sich einen optionalen Wochenplan. Jeder Schritt läuft immer, innerhalb oder außerhalb dieser Zeiten, und wird nur bei ausgewählten Ergebnissen vor der Annahme fortgesetzt: nicht erreichbar, besetzt, Timeout oder Fehler. Sobald eine Person oder ein Assistent annimmt, stoppt die Regel immer. Änderungen sind atomar, zyklische Verweise werden abgelehnt. ```mermaid theme={null} flowchart TD A(["Anruf betritt die Routing-Regel"]) --> B{"Zeitplan-Bedingung des Schritts"} B -->|"Schritt läuft"| C["Ziel des Schritts versuchen"] B -->|"Schritt übersprungen — kein Ergebnis"| N{"Weiterer Schritt in der Regel?"} C --> D{"Ergebnis"} D -->|"angenommen"| E(["Regel stoppt — Anruf angenommen"]) D -->|"ein ausgewähltes Ergebnis vor der Annahme"| N D -->|"ein beliebiges anderes Ergebnis vor der Annahme"| Z(["Regel endet — niemand hat den Anruf angenommen"]) N -->|"Ja"| B N -->|"Nein"| Z ``` ## API und MCP Die REST-API stellt Loop-Zugriff und -Einstellungen, das Verzeichnis, persönliche Presence, Arbeitszeiten und Wählpräferenzen, Metadaten registrierter Geräte, den Geräte-Widerruf, persönliche Anruflisten und Recall-Einträge sowie das Anrufrouting im Workspace bereit. Nutze die Berechtigungen `loop:read` und `loop:write`. Persönliche Präferenzen, Arbeitszeiten und Recall benötigen benutzergebundene Zugangsdaten, die mit einem Workspace-Mitglied verknüpft sind. Entsprechende MCP-Tools stehen im Telephony-Toolset zur Verfügung. Devices nutzen `list_loop_devices`, `rename_loop_device` und `revoke_loop_device`; persönliche Zeitpläne nutzen `get_loop_availability` und `update_loop_availability`; Wählpräferenzen nutzen `get_loop_dialing_preferences` und `update_loop_dialing_preferences`; Recall nutzt `list_loop_recalls` und `act_on_loop_recall`. Öffentliche Antworten enthalten nie Registrierungsgeheimnisse, rohe Fehlerdiagnosen oder interne Kostendaten. Die Nutzung wird in Minuten und Credits angezeigt. Neue Registrierungsdaten werden einmalig in der authentifizierten Anwendung angezeigt. Über die öffentliche API oder MCP sind sie nicht verfügbar.