Connecter vos plateformes

Elles ne représentent pas toutes le même effort, et il vaut mieux le savoir avant de commencer.

Plateforme	Ce dont elle a besoin	Effort
Apple App Store	Une clé d'API App Store Connect avec un accès Admin ou App Manager : Issuer ID, Key ID, fichier .p8	La délicate, 10 minutes
Google Play	Connexion Google, choix des applications, plus l'autorisation Reply to reviews dans la Play Console	Quelques minutes
Google Business Profile	Connexion Google en tant que propriétaire ou gestionnaire de l'établissement, choix des établissements	Quelques minutes
Facebook, Instagram, TikTok	Pas encore disponible	Bientôt disponible

Tout se passe dans Integrations, dans AI Review Sensor. Les connexions appartiennent à AI Review Sensor seul : les autres sensors ScaleSensor connectent leurs propres sources avec leurs propres identifiants.

Vous choisissez quelles applications ou quels établissements ajouter. Connectez-en un, laissez-le se synchroniser, puis ajoutez le suivant. Il est bien plus facile de savoir d'où vient quoi quand la boîte de réception ne se remplit pas de toutes les sources à la fois.

Ajoutez une deuxième application sur une plateforme que vous avez déjà connectée et l'on vous propose l'identifiant que vous avez enregistré (pour Apple, Use a saved API key ; pour Google, le compte avec lequel vous vous êtes déjà connecté), au lieu de vous redemander la même clé ou le même consentement.

Une seule clé par équipe est plus facile à faire tourner qu'une copie de celle-ci dans chaque connecteur. Les identifiants enregistrés sont listés par nom, avec le Key ID ou l'e-mail partiellement masqué. La clé privée et les jetons eux-mêmes ne sont plus jamais affichés, pas même à vous.

La première récupération ramène les avis les plus récents de chaque application (jusqu'à 100) pour que la boîte de réception ne soit pas vide pendant que vous explorez. C'est une tranche, pas tout votre historique.

Ensuite, chaque connecteur est vérifié toutes les 30 minutes environ. Les nouveaux avis sont classifiés et traduits à leur arrivée, et rédigés si votre mode d'automatisation est AI Drafts ou Auto-send.

Vous n'avez pas à attendre le minuteur. Sync now récupère immédiatement. Si une synchronisation ne trouve rien de nouveau, elle le dit (« Up to date ») plutôt que de revendiquer un succès qu'elle n'a pas eu.

Les connecteurs deviennent obsolètes pour des raisons ordinaires : une clé est révoquée dans App Store Connect, un compte Google perd son accès, ou les autorisations changent côté plateforme.

Dans ce cas, utilisez Reconnect sur le connecteur. Pour un compte Google, la reconnexion relance la connexion et rassemble de nouveau toutes les applications de ce compte, avec une synchronisation de test pour confirmer que tout fonctionne. Chaque avis déjà collecté reste rattaché.

Supprimer puis rajouter fonctionne aussi, et jette l'historique. Reconnectez d'abord, à chaque fois.

Deux choses différentes, délibérément.

Disconnect arrête la synchronisation des nouveaux avis depuis cette source. Vos données existantes restent intactes, et vous pouvez vous reconnecter plus tard sans vous identifier de nouveau.

Delete retire l'application et tous ses avis et brouillons d'AI Review Sensor. Supprimer un compte entier (l'identifiant enregistré) retire aussi toutes les applications qui en dépendent. Les données de facturation sont conservées ; les données d'avis, non. Celle-là est irréversible, et seul l'Owner peut le faire.

Si vous ne savez pas laquelle vous voulez, déconnectez. C'est l'option réversible.

L'Owner, les Managers et les Developers peuvent connecter et gérer les intégrations. Le rôle Sales & Marketing ne le peut pas : il est limité à la boîte de réception, aux analyses et aux réponses, ce qui correspond généralement à ce que vous voulez pour les personnes qui répondent aux clients toute la journée. Les suppressions définitives sont réservées à l'Owner.

Vous avez aussi besoin d'un accès suffisant côté plateforme. Vous ne pouvez pas nous accorder un accès que vous n'avez pas vous-même.

Quand une synchronisation ou une réponse échoue, le connecteur et l'avis affichent une raison en langage clair. Voici ce que chacune signifie et ce qu'il faut faire :

Ce que vous voyez	Ce que cela signifie	Ce qu'il faut faire
La connexion a expiré	La plateforme n'accepte plus l'accès enregistré	Reconnect le connecteur, puis renvoyez la réponse
Pas autorisé à lire les avis ou à répondre	Le compte ou la clé n'a pas l'autorisation sur la plateforme	Vérifiez son accès sur la plateforme (par exemple Reply to reviews dans la Play Console), puis reconnectez
L'avis ou l'application est introuvable	L'avis a été supprimé, ou l'application n'est plus publiée ou plus visible pour ce compte	Vérifiez que l'application est toujours publiée et visible pour le compte connecté
La plateforme limite notre rythme de publication	Une limite de débit côté plateforme	Rien. Nous réessayons automatiquement ; relancez une réponse dans quelques minutes
La plateforme est injoignable	Une panne réseau ou de la plateforme	Rien. Nous réessayons automatiquement
La fenêtre de réponse est fermée	La plateforme n'accepte plus de réponse pour cet élément	Rien ne peut être envoyé pour cet élément

Pour une application Apple, un message concernant la vitrine (storefront) signifie que l'application n'est pas listée dans l'App Store de ce pays, ou que le flux d'avis d'Apple pour cette vitrine n'a pas pu être chargé. Vérifiez la vitrine que vous avez choisie pour l'application.

Si les erreurs reviennent sans cesse, reconnectez le connecteur. Si cela ne règle rien, écrivez à [email protected].