Intégration Front

Lorsque vous configurez les intégrations via la page d’onboarding de votre cabinet, vous devez notamment paramétrer l’intégration Front, qui permet de lier le logiciel Lobby avec votre messagerie Front.

⚠️ Un grand nombre de fonctionnalités et d’automatisations ne fonctionnent que si cette intégration est correctement faite.

Dans la section “Front” de l'onglet Intégrations, veuillez renseigner tous les champs obligatoires :

Pour trouver ces informations, vous devez vous rendre dans les paramètres de votre messagerie Front :

• Cliquez sur l’icône ⚙️ en haut à droite

• Cliquez sur l’onglet Developers dans la navigation

Dans l’onglet Developers :

1. Cliquez sur le bouton Create app

2. App name : “Lobby”

3. Short description : “Lobby”

4. Cliquez sur le bouton Create

   

Vous arrivez sur la page du plugin Lobby où se trouve l'information “App secret”.

Sur la page du plugin Lobby :

• Cliquez sur l’onglet Features

• Dans le bloc “Sidebar plugin”, cliquez sur le bouton Create sidebar plugin

Sur la page de création du sidebar plugin :

• Side panel URL → copier-coller l'url suivante : https://front-plugin.bellman.immo

• Cliquez sur le bouton Create pour valider

• Revenez sur la page d’édition du sidebar plugin pour récupérer l’information “Auth secret”

Dans l’onglet Developers :

• Accédez à l’onglet API Tokens

• Cliquez sur le bouton Create API Token

• API token name : “Lobby”

• Sélectionnez les trois scopes : “Provisionning”, “Private ressources” et “Shared ressources”

• Valider en cliquant sur le bouton Create

• Revenez sur la page de l’API Token créé à l’instant

• Copiez-le via le bouton Copy

Lorsque vous avez récupéré toutes les informations nécessaires, revenez sur la page d’onboarding de votre cabinet dans Lobby.

Dans la section "Front" de l'onglet Intégrations :

• Renseignez l’info “App Secret” dans le premier champ

• Puis renseignez l’info “API Token” dans le second

• Renseignez l’info “Auth Secret”

• Enfin ajouter l’adresse mail générique de votre cabinet

• Cliquez sur le bouton Enregistrer

Si toutes ces informations sont correctes, la synchronisation avec Front est lancée et le statut d’intégration passe à Connecté ! 🥳

Une fois toutes ces étapes réalisées, le plugin est visible sur Front (barre latérale de droite), avec cette vue :

⚠️ Envoyez une demande par mail à support@bellman.immo pour demander l'autorisation / validation du plugin pour qu'il soit fonctionnel.

Pour activer le tagging automatique des emails avec les tags Copropriété, vous devez réaliser une configuration supplémentaire dans les paramètres de Front.

ℹ️ Le tagging automatique permet de taguer les emails avec la copropriété concernée, et en fonction de la copropriété, d’assigner l’email au bon gestionnaire.

• Accédez aux paramètres Front (icône ⚙️ en haut à droite)

• Cliquez sur l’onglet Developers dans la navigation

• Puis accédez à nouveau à l’app Lobby

• Dans l’onglet Features, cherchez l’élément Webhook et cliquer sur Create webhook

• Dans le champ Webhook URL, renseignez l'url suivante : https://api-private.mon-bien.immo/rest/company/COMPANY_ID/tag-and-assign-saas/front

  ⚠️ Le COMPANY_ID correspond à l'ID de votre cabinet que vous retrouvez dans l'URL de la page des paramètres de votre cabinet.

  Par exemple : https://lobby.bellman.immo/mon-entreprise/cln32hg9m07a6a71njuc1sbhr/informations

⚠️ Si l’URL renseignée dans le champ n’est pas correcte, cela renvoie une erreur et il sera impossible d’enregistrer le paramétrage.

• Dans le champ Subscribed events, Sélectionnez l’option “Inbound messages”

• Cliquez sur le bouton Create pour valider

C’est terminé, le tagging automatique des emails est activé dans Front ! 🥳

Vos emails seront automatiquement tagués avec les noms des copropriétés, et assignés au gestionnaire correspondant à la copropriété.