Le module API d’onOffice est une option payante. Demandez à votre interlocuteur onOffice de l’activer avant de connecter votre compte, et renseignez-vous sur ce qu’onOffice facture pour l’utilisation de l’API.
Connecter votre compte
- Dans onOffice enterprise, ouvrez Extras → Paramètres → Utilisateur et créez un utilisateur API réservé à l’assistant.
-
Accordez à cet utilisateur API les droits suivants :
- Adresses : lecture et écriture.
- Biens : lecture.
- Agenda : écriture.
- Journal de l’agent (Maklerbuch) : écriture.
- Copiez le jeton d’API (32 caractères) et le secret d’API (64 caractères). onOffice n’affiche le secret qu’une seule fois. Si la connexion indique que le jeton et le secret semblent inversés, saisissez-les dans l’autre sens.
- Ouvrez Agent Tools → Marketplace → onOffice, saisissez le jeton et le secret, puis adaptez les réglages ci-dessous si les vôtres diffèrent des valeurs par défaut. Choisissez Ajouter. La connexion est vérifiée avant l’enregistrement. Associez-la ensuite à votre assistant.
Ce que l’assistant peut faire
Activé par défaut :- Trouver des biens par rue, ville, achat ou location, type de bien, pièces, budget ou numéro du bien figurant dans une annonce.
- Détails du bien : prix, pièces, surfaces, étage, année, état, chauffage, charges, animaux, description et disponibilité.
- Créneaux de visite libres dans l’agenda de l’agent responsable.
- Réserver des visites une fois que l’appelant a confirmé.
- Créer des prospects avec un profil de recherche une fois que l’appelant a donné son accord.
- Reconnaître l’appelant grâce à son numéro de téléphone.
- Notes d’appel : écrire une note sur un appel terminé dans le journal de l’agent. Elles sont prévues pour les automatisations, voir ci-dessous.
Quels biens l’assistant voit
Le réglage Biens dont l’assistant peut parler décide :- Publiés sur votre site web (par défaut) : les biens actifs publiés sur votre site web.
- Statut de commercialisation ouvert : les biens actifs qui ne sont ni vendus ou loués ni réservés, publiés ou non.
Visites
L’assistant réserve une visite dans l’agenda de l’agent responsable du bien. Un bien sans agent responsable utilise l’Agent par défaut des réglages. Sans l’un ni l’autre, le bien ne peut pas être réservé et l’assistant propose un rappel par l’équipe.- Créneaux : à partir de demain, tous les jours, week-end compris, pendant les Horaires de visite (08:00–18:00 par défaut) dans votre fuseau horaire. Les créneaux suivent une grille de 30 minutes et durent aussi longtemps que la Durée de la visite (30 minutes par défaut).
- Créneaux occupés : chaque entrée de l’agenda de cet agent compte comme occupée. Les entrées de journée entière bloquent toute la journée. Les entrées annulées ne comptent pas.
- Réservation : l’assistant demande le prénom et le nom, répète le bien, le jour et l’heure, puis attend un oui clair. Il vérifie une dernière fois que le créneau est libre, puis crée le rendez-vous, lié au bien et au contact. Il ne dit « réservé » qu’après la confirmation d’onOffice.
- Contacts : un contact portant le numéro de l’appelant est réutilisé. Plusieurs contacts avec un même numéro se distinguent par le nom. Sinon, un nouveau contact est créé, avec une adresse e-mail uniquement si l’appelant en a donné une.
- Numéros masqués : les appelants qui masquent leur numéro ne peuvent pas réserver. L’assistant propose un rappel.
Besichtigung par défaut). Sa note indique qui a réservé, sous votre marque.
Un délai dépassé ne prouve pas qu’une réservation a échoué. Les requêtes répétées sont protégées contre les doubles réservations. Si l’assistant signale un résultat inconnu, vérifiez l’agenda de l’agent avant de réserver à nouveau.
Prospects
Lorsqu’un appelant cherche un bien, l’assistant recueille le prénom, le nom, achat ou location et tout ce que l’appelant indique : ville, type de bien, pièces et budget. Après un oui clair, il enregistre l’appelant comme contact et ajoute un profil de recherche avec ces souhaits.- Un contact portant le même numéro est réutilisé au lieu d’être dupliqué.
- Aucune adresse e-mail n’est écrite sauf si l’appelant en a donné une. Il n’y a pas d’adresse fictive.
- Le profil ne contient que les critères que votre compte onOffice propose comme critères de recherche.
- Si onOffice refuse le profil, le contact reste et l’assistant indique que l’équipe ajoutera les souhaits.
Notes d’appel dans le Maklerbuch
Les notes d’appel sont désactivées pour les assistants. Utilisez le modèle d’automatisation Consigner les appels dans onOffice (New → Start from template, catégorie CRM) : après chaque appel entrant avec un résumé, onOffice est interrogé pour trouver les contacts portant le numéro de l’appelant, jusqu’à trois, et une note est écrite dans leur journal d’agent. La note commence par « Call with » et votre marque, puis le résumé et la durée de l’appel.- Activez les Notes d’appel pour la connexion sous Automatisations → Connexions : elles sont désactivées par défaut, et le modèle échoue tant que vous ne le faites pas. Utilisez une connexion créée à cet endroit, pas une connexion importée depuis l’outil d’agent, afin que l’assistant ne reçoive pas les notes d’appel.
- La Catégorie d’action et le Type d’action des notes d’appel (
TelefonatetEingangpar défaut) doivent exister dans onOffice. Sinon, la connexion s’enregistre quand même, mais les notes d’appel sont refusées avec une indication. - Les appelants absents d’onOffice ne reçoivent pas de note.
- Le lien de l’appel n’est pas écrit.
- Les modèles ne s’affichent pas dans les espaces de travail des clients d’un revendeur. Créez la même automatisation avec l’action onOffice · Notes d’appel ; le numéro de téléphone ne se saisit pas, il vient de l’appel.
Reconnaître les appelants
Lorsque le numéro de l’appelant correspond exactement à un contact actif, l’assistant le salue par son nom. Si plusieurs contacts partagent le numéro, il demande le nom de famille. Si le numéro est masqué ou inconnu, il traite l’appelant comme un nouveau contact. Les biens sont des données publiques et n’exigent aucune vérification. L’assistant ne lit jamais à voix haute les adresses e-mail, numéros de téléphone ou adresses de vos contacts.Réglages
Modifiez-les dans Automatisations → Connexions, ou supprimez l’outil et reconnectez-le. La réservation, les prospects et les notes d’appel s’activent sous Modifier sur l’outil.Tester sans risque
Les réservations, les prospects et les notes sont réels. Testez avec un bien de test, un agenda que vous pouvez nettoyer et votre propre numéro de téléphone, puis supprimez le rendez-vous de test et le contact de test dans onOffice. Les simulations de texte n’appellent pas onOffice.Canaux
La recherche et les détails des biens fonctionnent sur tous les canaux. La reconnaissance, les visites et les prospects utilisent le numéro de téléphone que porte la conversation : le téléphone, WhatsApp et le SMS en ont un. Le chat web et l’e-mail n’en ont pas, l’assistant propose donc un rappel au lieu de réserver.Automatisations
Chaque opération est disponible comme action sous onOffice · …. Connectez onOffice dans Automatisations → Connexions, ou importez sa connexion Agent Tools. Une automatisation déclenchée par un appel ou une conversation par texte connaît le numéro de l’interlocuteur grâce à cet appel lui-même, jamais grâce aux données du déclencheur ni à une saisie d’étape. Notes d’appel n’a donc pas de champ pour le numéro. Les exécutions lancées autrement (webhook, planification) n’ont pas de numéro : la réservation et les prospects répondent qu’il n’est pas disponible, et les notes d’appel n’écrivent rien. Une exécution manuelle n’a un numéro que si ses données désignent un appel ou une conversation de votre espace de travail. Les déclencheurs pour les nouveaux biens ou contacts ne sont pas encore disponibles.API, MCP, CLI & SDK
POST /api/v1/tools/integrations/onoffice · MCP connect_integration · CLI famulor connect-integration onoffice.
L’outil démarre avec la recherche de biens, les visites et les prospects activés. client.api.connectIntegration nécessite famulor-sdk 0.2.12 ou une version ultérieure. Mettez à jour la CLI avec npm install --global famulor avant d’utiliser connect-integration.
estate_rule (published ou open), default_agent, viewing_type, viewing_minutes, viewing_hours, log_action_kind, log_action_type et timezone.
Dépannage
- « onOffice did not accept the API token, secret or rights. » Vérifiez les deux valeurs, vérifiez que l’utilisateur API est actif et qu’il a les droits ci-dessus, et saisissez le nouveau jeton et le nouveau secret si vous les avez régénérés dans onOffice.
- « onOffice rejected the signature. » Le jeton et le secret sont inversés ou le secret a été copié de façon incomplète. Le jeton compte 32 caractères, le secret 64.
- « The server clock is out of sync with onOffice. » C’est temporaire. Réessayez plus tard.
- Les recherches ne trouvent rien alors que les biens existent. Vérifiez que les droits de lecture couvrent tous les enregistrements et pas « uniquement les siens », et que le bien correspond à Biens dont l’assistant peut parler.
- « Check the appointment type. » Saisissez le Type de rendez-vous pour les visites exactement comme le type d’action pour les rendez-vous est nommé dans onOffice.
- « The action kind or type for call notes does not exist. » Saisissez la Catégorie d’action et le Type d’action comme ils sont nommés dans onOffice.
- « The default agent was not found. » Saisissez le nom d’utilisateur ou l’ID d’un utilisateur qu’onOffice répertorie pour l’utilisateur API.