> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Famulor Loop
> Utilisez le système téléphonique d'entreprise intégré sur le web, sur mobile et avec des téléphones de bureau enregistrés.
Famulor Loop donne à chaque membre activé de l'espace de travail un poste personnel, un statut de disponibilité, des appareils enregistrés et un historique d'appels personnel.
## Disponibilité
Loop devient disponible lorsqu'il est inclus dans le forfait de l'espace de travail, activé dans les paramètres de l'espace de travail, activé pour votre adhésion, et relié à un numéro actif acheté via Famulor.
L'accès à Loop est une fonctionnalité par membre, pas un rôle distinct de l'espace de travail. Seul le propriétaire de l'espace de travail peut l'activer ou le désactiver pour chaque membre.
## Espace téléphonique personnel
Utilisez Loop pour :
* définir votre statut sur disponible, occupé, ne pas déranger ou hors ligne ;
* appeler depuis le softphone web ou mobile ;
* enregistrer et révoquer vos propres appareils ;
* trouver des collègues disponibles par nom ou par poste ;
* consulter vos appels personnels dans Loop Recents.
Loop Recents est distinct de l'Historique omnicanal des assistants. Votre rôle continue de déterminer si vous pouvez consulter l'historique des assistants.
Les clients gérés apparaissent dans Devices sous les noms **Loop Web Phone**, **Loop iOS App** ou **Loop Android App**. Vous pouvez renommer ou révoquer vos propres appareils. Les noms que vous attribuez aux téléphones SIP externes restent inchangés.
## Extension Chrome
Famulor Loop est également disponible sous forme de panneau latéral Chrome — un composeur compact qui reste ouvert à côté de l'onglet sur lequel vous travaillez, pour ne pas avoir à ouvrir le tableau de bord complet afin de prendre un appel.
Installez **Famulor Loop** depuis le Chrome Web Store, puis ouvrez son panneau latéral depuis l'icône de la barre d'outils. **Alt + Maj + L** l'ouvre depuis n'importe où dans Chrome.
Ouvrez `https://app.famulor.io/device` dans un onglet de navigateur où vous êtes connecté — le panneau latéral propose un bouton pour cela. La page affiche un code PIN à 4 chiffres, valable deux minutes et utilisable une seule fois.
Saisissez ce PIN dans le panneau latéral et connectez-vous. Le navigateur apparaît alors dans Devices sous le nom **Chrome extension**, et vous pouvez le révoquer à cet endroit comme n'importe quel autre client.
Depuis le panneau latéral, vous pouvez composer et recevoir des appels ; couper le micro, utiliser le clavier et terminer un appel actif ; et laisser un appel accepté se poursuivre même si vous fermez le panneau. Les notifications couvrent les appels entrants, manqués et échoués — acceptez ou refusez un appel entrant depuis le panneau, ou directement depuis la notification lorsque votre navigateur et votre système d'exploitation proposent ces boutons. Le panneau affiche aussi votre historique d'appels et les conversations d'assistant que vous êtes autorisé à voir, sans avoir à ouvrir le tableau de bord complet. Chrome demande l'accès au microphone la première fois que vous appelez depuis l'extension.
Pour appeler depuis l'extension, Famulor Loop doit être activé pour votre adhésion, comme pour tout autre client Loop — voir Disponibilité ci-dessus. Sans cela, le panneau masque le composeur et n'affiche que les conversations que vous êtes autorisé à voir.
## Utilisation par l'équipe
Lorsque Loop est disponible, la page Usage ajoute des statistiques propres à Loop pour la période sélectionnée : appels, minutes, crédits client, taux de réponse, tendances des appels entrants et sortants, et répartition par membre de l'équipe. Cette section est masquée lorsque Loop n'est pas disponible. Les prix fournisseur, les marges et les identifiants opérateur ne sont jamais affichés.
## Horaires personnels
Définissez dans **Softphone → Paramètres** un planning hebdomadaire et un fuseau horaire pour les moments où les transferts d'assistant doivent vous joindre. Votre statut manuel Occupé, Ne pas déranger ou Hors ligne, les appels actifs et les clients enregistrés restent prioritaires.
**Lorsque vous êtes injoignable** est désactivé par défaut. Vous pouvez choisir une destination de transfert à froid validée, un assistant actif ou une règle de routage visible existante. Cela ne s'applique qu'aux transferts directs d'un assistant vers vous ou votre poste ; cela ne modifie pas silencieusement les routes de numéros, les groupes d'appel ou les files d'attente. Une prise en charge réussie par un assistant est terminale.
Les identifiants API appartenant à un utilisateur peuvent lire ou remplacer le planning, le fallback et le calendrier de rendez-vous Recall avec `GET /loop/availability` et `PATCH /loop/availability`. Un fuseau horaire `null` reprend celui de l'espace de travail. Omettre `fallback` ou `recall_appointment_calendar_id` conserve la valeur actuelle.
## Pays de numérotation
Dans les paramètres du Softphone, choisissez le pays par défaut personnel utilisé pour les numéros saisis sans indicatif international. Par exemple, un numéro mobile allemand commençant par `0170` est converti au format `+49` avant le début de l'appel. Un numéro commençant déjà par `+44` conserve cet indicatif, et les postes internes Loop ne sont jamais développés.
Les intégrations appartenant à un utilisateur peuvent lire ou modifier cette préférence avec `GET /loop/preferences` et `PATCH /loop/preferences`.
## Recall
Recall conserve les demandes de rappel qui vous sont assignées lorsqu'un transfert a été manqué ou qu'un appelant a demandé à être rappelé. Depuis le softphone, vous pouvez rappeler vous-même la personne, demander à un assistant sélectionné de la mettre en relation avec vous, lui demander de fixer un rendez-vous, ou marquer l'élément comme résolu. Choisissez le calendrier utilisé pour les rendez-vous Recall sous **Softphone → Paramètres**. Connectez d'abord des calendriers sur la page Booking, puis sélectionnez-en un ici. Une fois que vous démarrez un assistant, le softphone indique que l'assistant est en train d'appeler, à la place des détails Recall.
`GET /loop/recalls` renvoie uniquement les éléments Recall assignés au membre authentifié, y compris pour les propriétaires et administrateurs. Utilisez `POST /loop/recalls/{id}/actions` pour les actions disponibles. Un démarrage d'assistant réussi devient le choix mémorisé pour ce membre.
L'application peut afficher les rappels d'assistant planifiés et les demandes Recall personnelles dans le même espace de rappels. Leurs ressources publiques restent distinctes : les intégrations existantes de rappels planifiés continuent d'utiliser `/scheduled-callbacks`, tandis que les intégrations Recall personnelles utilisent `/loop/recalls`.
## Routage des appels de l'espace de travail
Les propriétaires et administrateurs de l'espace de travail peuvent gérer la même configuration Loop depuis l'application, l'API REST ou MCP :
* disponibilité de l'espace de travail, numéro de téléphone par défaut, pays de numérotation, enregistrement et règle de routage par défaut ;
* groupes d'appel avec sonnerie simultanée, séquentielle ou en tourniquet, délai par membre, délai de sonnerie et filtrage de présence facultatif ;
* files d'attente avec routage atomique en tourniquet, séquentiel ou par inactivité la plus longue, temps d'attente, temps de clôture, ordre des membres, capacité par membre et règle de débordement ;
* règles de routage ordonnées vers des membres, postes, groupes, files d'attente, assistants, une autre règle ou un numéro externe ;
* destinations entrantes pour les numéros de téléphone actifs achetés via Famulor.
Utilisez `PATCH /loop` pour les paramètres de l'espace de travail, et les ressources `/loop/ring-groups`, `/loop/queues`, `/loop/routing-rules` et `/loop/number-routes` pour le routage des appels. Les opérations de lecture nécessitent `loop:read` ; les modifications nécessitent `loop:write`. Les identifiants appartenant à un utilisateur doivent appartenir à un propriétaire ou un administrateur de l'espace de travail.
Les écritures sur les groupes d'appel et les files d'attente acceptent des affectations de membres ordonnées, avec un délai pour les membres d'un groupe d'appel et une capacité d'appels simultanés pour les membres d'une file d'attente. L'ancienne liste de membres à plat reste acceptée pour les intégrations compatibles.
Les règles de routage partagent un planning hebdomadaire facultatif unique. Chaque étape s'exécute toujours, pendant ces horaires, ou en dehors de ces horaires, et ne se poursuit que pour les issues sélectionnées avant réponse : indisponible, occupé, délai dépassé ou erreur. Une personne ou un assistant qui répond arrête toujours la règle. Les mises à jour sont atomiques et les références cycliques sont rejetées.
## API et MCP
L'API REST expose l'accès et les paramètres Loop, l'annuaire, la présence personnelle, les horaires et préférences de numérotation, les métadonnées des appareils enregistrés, la révocation d'appareils, les appels personnels récents et les éléments Recall, ainsi que le routage des appels de l'espace de travail. Utilisez les permissions `loop:read` et `loop:write`. Les préférences personnelles, les horaires et Recall nécessitent des identifiants appartenant à un utilisateur, associés à un membre de l'espace de travail.
Les outils MCP équivalents sont disponibles dans le groupe d'outils Telephony. Devices utilise `list_loop_devices`, `rename_loop_device` et `revoke_loop_device` ; les plannings personnels utilisent `get_loop_availability` et `update_loop_availability` ; les préférences de numérotation utilisent `get_loop_dialing_preferences` et `update_loop_dialing_preferences` ; Recall utilise `list_loop_recalls` et `act_on_loop_recall`. Les réponses publiques n'incluent jamais les secrets d'enregistrement, les diagnostics d'échec bruts ni les données de coût internes. L'utilisation est affichée en minutes et en crédits.
Les informations d'un nouvel enregistrement ne s'affichent qu'une fois dans l'application authentifiée. Elles ne sont pas disponibles via l'API publique ou MCP.