Connecter une application

La page Intégrations connecte Ringhum aux outils que votre équipe utilise déjà. Une fois une application connectée, Ringhum lui envoie les appels, messages, réservations et commandes au fur et à mesure. Certaines applications renvoient aussi des informations, comme les créneaux occupés d'un calendrier ou les commandes d'un appelant depuis votre boutique. Vous connectez chaque application une fois pour tout l'espace de travail, et chaque assistant de l'espace de travail l'utilise.

Avant de commencer

• Seuls le Propriétaire et les Admins de l'espace de travail peuvent connecter, modifier ou déconnecter des applications. Les membres et lecteurs peuvent voir la page, et les cartes affichent Demandez à un admin de connecter cette application.
• La plupart des applications sont disponibles sur tous les forfaits. Google Agenda (synchronisation bidirectionnelle) et Calendly font partie des forfaits Team et Scale. Sur les autres forfaits, leurs cartes affichent un cadenas de forfait au lieu de Connecter.
• Vous avez besoin d'un compte sur l'autre application, et généralement de droits d'administration pour y créer une clé API ou un webhook.

Le catalogue d'applications

Ouvrez Intégrations dans la barre latérale. Utilisez le champ de recherche ou les boutons de catégorie pour trouver une application. Le bouton Connecté n'affiche que les applications que vous avez déjà connectées.

Si votre outil n'est pas listé, vous pouvez généralement le connecter via Zapier, Make ou n8n, ou avec votre propre point de terminaison webhook sous Développeurs. Le bouton Webhooks et API en haut de la page vous y emmène.

Trois façons de se connecter

Chaque application utilise l'un des trois types de connexion. La carte et la fenêtre de connexion vous indiquent lequel.

Deux groupes fonctionnent différemment. La carte Flux calendrier (ICS) vous donne un lien à coller dans votre application de calendrier ; vous ne connectez rien. Les canaux hôteliers (Booking.com, Airbnb, Vrbo) se configurent par chambre : leurs cartes ont un bouton Configurer sur Chambres qui ouvre Chambres et tarifs.

Connecter une application avec une clé ou une URL de webhook

1. Ouvrez Intégrations et trouvez l'application.
2. Cliquez sur Connecter sur sa carte. La fenêtre Connecter s'ouvre avec une courte description indiquant où trouver les identifiants dans l'autre application. De nombreuses applications ont aussi un lien Documentation.
3. Remplissez les champs, par exemple une clé API, un sous-domaine, un identifiant de liste ou de projet, ou une URL de webhook.
4. Sous Envoyer, cochez les événements que l'application doit recevoir. Voir Choisir ce qui est envoyé.
5. Si la fenêtre affiche l'interrupteur Uniquement les appels à traiter, décidez si l'application doit entendre parler de chaque appel ou seulement de ceux nécessitant une action.
6. Cliquez sur Connecter.

Ringhum vérifie la connexion avant d'enregistrer quoi que ce soit. Si la vérification échoue, rien n'est enregistré et la fenêtre affiche Connexion impossible avec le motif donné par l'autre application, par exemple une clé rejetée. Corrigez le champ et réessayez.

Remarque : les identifiants sont stockés chiffrés et ne sont utilisés que depuis nos serveurs.

Connecter une application en vous connectant

1. Cliquez sur Connecter sur la carte. Vous êtes redirigé vers l'autre service.
2. Connectez-vous et approuvez l'accès demandé.
3. Vous revenez sur Intégrations avec un message de confirmation.

Certaines applications par connexion nécessitent une étape supplémentaire. Pour Google Sheets, cliquez sur Paramètres sur la carte et collez l'identifiant du tableur. Tant que vous ne le faites pas, les livraisons sont ignorées avec le message « Ajoutez l'identifiant du tableur dans les paramètres de l'intégration ». Google Drive fonctionne immédiatement et enregistre les fichiers dans Mon Drive, sauf si vous ajoutez un identifiant de dossier sous Paramètres.

Tester la connexion

Une carte connectée affiche un badge de statut : Connecté, Erreur ou En pause. Elle affiche aussi l'heure de la dernière livraison et les événements que l'application reçoit.

• Envoyer un test (applications de messagerie et d'automatisation) publie un message de test, afin que vous le voyiez arriver dans le canal ou le flux de travail.
• Tester (toutes les autres applications) vérifie que les identifiants fonctionnent encore.

Le résultat apparaît sous forme de message en haut de l'écran. Pour Zapier et Make, envoyez un événement de test avant de mapper les champs, afin que le flux de travail puisse apprendre la structure des données.

Gérer une connexion

Une carte connectée comporte tout ou partie de ces boutons :

• Paramètres (applications avec des champs à remplir) rouvre la fenêtre pour modifier les identifiants ou les événements. Cliquez sur Enregistrer les paramètres. La connexion est revérifiée avant l'enregistrement du changement.
• Reconnecter (applications par connexion) répète la connexion, par exemple après un changement de mot de passe ou l'expiration de l'accès.
• Mettre en pause arrête toutes les livraisons sans perdre les paramètres. Reprendre les relance.
• Déconnecter supprime la connexion et les identifiants enregistrés.

Dépannage

Le bouton Connecter est absent. Vous n'êtes peut-être pas Propriétaire ou Admin, l'application peut nécessiter un forfait supérieur (la carte affiche un cadenas de forfait), ou une application par connexion peut afficher Configuration nécessaire, ce qui signifie qu'elle n'est pas disponible pour le moment. Contactez le support si ce badge persiste.

Une bannière indique « Les connecteurs natifs sont désactivés pour cet espace de travail ». Les applications CRM, service d'assistance, tâches, tableurs, marketing, analytique et e-commerce sont désactivées pour votre espace de travail. Les applications de messagerie, d'automatisation et de calendrier fonctionnent toujours. Contactez le support pour les réactiver.

Mon appel de test n'est pas apparu dans Slack ou mon CRM. Les mises à jour d'appels, éléments de boîte de réception et commandes provenant d'appels de test ne sont pas envoyés aux applications connectées. Passez un vrai appel au numéro.

La carte affiche Erreur. Cliquez sur la ligne de dernière livraison de la carte pour voir ce qui s'est mal passé. Voir Dépannage des livraisons.