La configuration prend environ 20 minutes, en trois allers-retours : créer des éléments dans Intercom, les connecter dans Grio, puis activer les notifications dans Intercom. Les écrans d’Intercom sont cités en anglais, tels qu’ils apparaissent.
Avant de commencer
Un administrateur Intercom
Il faut les droits d’administration pour créer une app, un coéquipier et un workflow.
Un siège Intercom
Pour le coéquipier Grio. Il doit avoir l’accès Inbox pour répondre.
Un agent Grio CX
Déjà configuré avec votre base de connaissances. Votre interlocuteur Grio peut vous aider.
Partie 1 — Dans Intercom
1
Ajoutez le coéquipier Grio
Dans Intercom, allez dans Settings → Teammates et invitez un nouveau coéquipier.
- Nom : ce que vos clients verront sur les réponses de Grio, par exemple Grio CX ou le nom de votre support.
- E-mail : une adresse que votre entreprise contrôle, par exemple
grio@votreentreprise.com. - Siège : attribuez-lui un siège avec l’accès Inbox.
2
Créez une app privée
Allez dans Settings → Integrations → Developer Hub et cliquez sur New app.
- App name :
Grio CX - Workspace : l’espace de votre entreprise
3
Donnez ses permissions à l'app
Dans votre nouvelle app, ouvrez Authentication → Edit et cochez :
- Read and write conversations
- Read and write tags
- Read admins
- Read users and companies
- Read and list articles (permet à Grio de répondre à partir de votre centre d’aide)
4
Copiez deux valeurs
Gardez-les pour la partie 2 :
Partie 2 — Dans Grio
1
Ouvrez les connexions de votre agent
Dans Grio, allez dans Agents, ouvrez l’agent qui répondra dans Intercom, puis cliquez sur Add connection → Helpdesks → Intercom.
2
Connectez
- Région : où votre espace Intercom est hébergé (Europe, États-Unis ou Australie). En cas de doute, regardez l’adresse de votre Intercom :
app.eu.intercom.compour l’Europe,app.au.intercom.compour l’Australie, sinon les États-Unis. - Jeton d’accès et Secret client : collez les deux valeurs de la partie 1.
3
Choisissez qui écrit et qui prend le relais
- Écrit en tant que : le coéquipier créé dans la partie 1.
- Transmet à : l’équipe (ou la personne) qui reprend les conversations que Grio ne peut pas traiter.
- Répondre à partir de votre centre d’aide : laissez activé pour que Grio utilise vos articles Intercom.
- Fermer une fois résolu : laissez activé pour que Grio ferme les conversations une fois que le client confirme.
Partie 3 — De retour dans Intercom
1
Laissez Intercom prévenir Grio
Dans Developer Hub, ouvrez votre app → Webhooks.
- Collez l’URL du webhook venant de Grio.
- Cochez ces six sujets :
- Cliquez sur Save.
En moins d’une minute, Grio affiche Intercom a joint l’agent.
2
Envoyez des conversations à Grio
Allez dans Workflows et créez un workflow qui attribue les conversations au coéquipier Grio. Par exemple : quand un client ouvre une nouvelle conversation → attribuer à Grio CX.
3
Essayez
Ouvrez votre Messenger comme un client et posez une question à laquelle votre centre d’aide répond. Grio répond en une quinzaine de secondes.Demandez ensuite à parler à une personne : Grio ajoute une note pour votre équipe et lui attribue la conversation.
Au quotidien
Chaque conversation traitée par Grio apparaît aussi dans Grio, en lecture seule, avec son résumé, son sentiment et le raisonnement de l’agent. Les réponses se font toujours dans Intercom.
En cas de problème
Grio ne répond jamais
Grio ne répond jamais
Vérifiez trois choses :
- Les six sujets du webhook sont cochés et l’URL est enregistrée (partie 3, étape 1).
- La conversation est attribuée au coéquipier Grio (partie 3, étape 2).
- Le coéquipier Grio a un siège avec l’accès Inbox (partie 1, étape 1).
« This admin does not have Inbox access »
« This admin does not have Inbox access »
Donnez au coéquipier Grio un siège avec l’accès Inbox dans Settings → Teammates.
La connexion échoue dans Grio
La connexion échoue dans Grio
Vérifiez que la Région correspond à votre espace Intercom et que le jeton d’accès a été copié en entier. Si Grio indique que le jeton ne peut pas lire vos coéquipiers, ajoutez Read admins aux permissions de l’app (partie 1, étape 3).
Grio reste sur « En attente de la première notification d'Intercom »
Grio reste sur « En attente de la première notification d'Intercom »
Envoyez un message dans le Messenger sur une conversation attribuée à Grio. La première notification arrive avec lui.
Grio a cessé de fonctionner
Grio a cessé de fonctionner
Si le jeton d’accès a été révoqué ou l’app désinstallée, Grio met la connexion en pause et demande de nouveaux identifiants. Créez un nouveau jeton d’accès (partie 1, étape 4) et collez-le dans Add connection → Intercom.