Une fois que c'est fait, chaque job que tu marques comme "Terminé" dans ServiceTitan enverra automatiquement une demande d'avis au client, et l'avis reçu sera attribué au technicien qui a fait le job.

La configuration se passe en trois étapes, dans cet ordre :

Tu auras besoin de quatre infos : trois sont obligatoires. Garde un bloc-notes à portée de main.

Tu as besoin de deux autorisations activées sur ton compte ServiceTitan. Un administrateur doit les activer :

Sans ces droits, tu ne pourras pas accéder au portail développeur de ServiceTitan.

Tu as aussi besoin d'un compte Reviewflowz sur un plan qui inclut l'intégration et l'attribution des techniciens, et des crédits SMS si tu préfères envoyer des textos plutôt que des emails. Tu peux faire toute la configuration ci-dessous et ajouter la facturation après. Rien ne sera envoyé tant que tu n'actives pas la campagne.

Ton ID de locataire identifie ton compte ServiceTitan. Si tu gères plusieurs entreprises sur ServiceTitan, chacune a son propre ID et sa propre configuration.

Laisse cet onglet ouvert. Tu reviendras ici à la Partie 3 où tu pourras vérifier que c'est bien le bon ID sous "Valeur \"locataire\" autorisée".

Cette étape peut être déconcertante pour certains, donc lis bien avant de cliquer.

Aller sur developer.servicetitan.io et connecte-toi. Sur l'écran de connexion, choisis la colonne de droite pour les Clients ServiceTitan et clique sur Se connecter en tant qu'utilisateur d'Environnement de Production. Les autres options mènent à un espace de test.

Connecte-toi avec tes identifiants ServiceTitan. Les autres options de connexion ne fonctionneront pas ici.

Dans Mes Applications, clique sur Enregistrer une Nouvelle Application, réponds à la question de ServiceTitan et remplis le formulaire ainsi :

Le site web doit être complet avec https://. Sinon, le formulaire sera rejeté.

Détails de l'application : Donne un nom que tu reconnaîtras plus tard, par exemple Reviewflowz. La description et tout le reste n'affectent pas les capacités de l'application, réponds juste comme tu le souhaites. Clique sur Générer pour le GUID.

Descends jusqu'à APIs de Locataire, ajoute l'ID de locataire, puis clique sur Ajouter les Portées API.

Choisis ces cinq portées :

L'accès en lecture suffit. Ça permettra à Reviewflowz de faire son boulot sans rien écrire en retour. Manquer une portée peut désactiver une fonction, alors coche toutes les cases.

La première entreprise qu'on a connectée est passée sans la portée Emplacements, ce qui leur a coûté des contacts dès le premier jour. Coche les cinq.

Enregistre l'application. De retour dans Mes Applications, trouve ta ligne avec trois icônes sous Actions. Clique sur le crayon pour voir la Clé d'Application. Copie-la. C'est ton deuxième identifiant.

La clé d'application identifie l'application, pas ton compte. Elle reste la même même avec plusieurs locataires ou entre les environnements d'intégration et production.

Les ID et Secret Client n'existent pas encore. Ils sont créés lorsque tu accordes l'accès, donc cette étape vient après la Partie 2.

Dans ServiceTitan, va dans Paramètres, cherche Intégrations, et ouvre Accès à l'application API. C'est la même page où tu as récupéré ton ID de locataire dans la Partie 1, et elle montre toutes les applications qui ont déjà accès à tes données.

Clique sur Connecter une Nouvelle Application. Ton application apparaît dans la liste. Si elle est vide, l'application n'a pas ton ID de locataire, donc ajoute-le.

Sélectionne-la et clique sur Connecter. ServiceTitan te montre les portées demandées par l'application et tu dois les approuver. L'application obtient ensuite une page de détails, jette un œil pour confirmer que tout est correct. La Valeur \"locataire\" autorisée sera ton ID de locataire avec un bouton Copier à côté.

Retourne au portail développeur, dans Mes Applications. Clique sur l'icône de connexion, celle qui ressemble à un lien de chaîne. Ce sont les Connexions d'Application.

Les Connexions d'Application listent une ligne par locataire connecté. La ligne montre l'ID de Locataire/Réseau, l'ID Client, et un bouton Générer pour le Secret Client.

Copie l'ID Client. Clique sur Générer et copie le Secret aussitôt, car il n'apparaît qu'une seule fois. Traite-le comme un mot de passe : colle-le dans Reviewflowz et c'est tout. Il est stocké de manière sécurisée.

On vérifie les infos d'identification, puis on vérifie l'ID de locataire séparément, donc le message d'erreur indique laquelle des deux est incorrecte :

Quand ça fonctionne, la carte devient verte et indique le nombre de jobs que tu as terminés durant les 30 derniers jours. Ce chiffre prouve que nous pouvons effectivement lire tes données.

Nous importerons ensuite l'historique de tes jobs terminés. Ces jobs passés remplissent immédiatement ton tableau des techniciens. Aucune demande n'est envoyée pour eux. Seuls les jobs terminés après la connexion reçoivent une demande d'avis.

Passez cette étape si tu gères un seul emplacement.

Dans le panneau de paramètres de ServiceTitan, sous Emplacements, choisis la façon dont nous déterminons à quel emplacement chaque job appartient :

Configure aussi Se replier sur. C'est l'emplacement que nous utilisons quand ni l'unité d'affaires n'est reliée ni l'adresse ne place le client près de quoi que ce soit.

Si la liste des unités d'affaires est vide, complète un job dans ServiceTitan et appuie sur Actualiser la liste.

Avec la connexion faite, une campagne de brouillon est créée, appelée Demandes d'avis ServiceTitan. Elle ne fera rien tant que tu ne l'active pas.

À partir de là, tout roule. Un job terminé devient un contact dans Demandes, et la demande est envoyée après le temps prévu.

Nous vérifions ServiceTitan pour les jobs terminés toutes les 15 minutes. ServiceTitan n'offre pas de webhooks pour les nouvelles applications, donc l'interrogation est la méthode recommandée en attendant. Tu recevras probablement la demande dans les 15 minutes suivant la clôture du job, plus le délai défini.

Seul le statut Terminé déclenche une demande. Prévu, Libre, En cours, En attente et Annulé ne le font pas.

L'application n'apparaît pas dans Connecter une nouvelle application. Ton ID de locataire manque sur l'application. Accède au portail développeur, Mes Apps, modifie l'application, section Tenants.

Tout est connecté mais aucune demande n'est envoyée. Vérifie ces trois points dans l'ordre : la campagne est bien active, le statut du job dans ServiceTitan est bien "Terminé", et le job a été complété après que tu te sois connecté. Les jobs antérieurs ne servent qu'au reporting et ne reçoivent pas de demande.

Les branches apparaissent en tant que numéros. Il te manque la portée Unités d'affaires sur ton application. Ajoute-la dans le portail développeur, puis appuie sur Actualiser la liste sur ServiceTitan.

Les avis ne sont pas attribués aux techniciens. La portée Affectations des rendez-vous est manquante. Un job avec plusieurs techniciens crédite chacun d'entre eux, donc s'il manque un technicien, c'est parce que l'affectation dans ServiceTitan est incomplète, pas à cause de la portée.

Secret Client régénéré. Regénérer le Secret invalide l'ancien Secret. Colle le nouveau dans Reviewflowz, sinon la synchronisation s'arrêtera.