Clés pour connecter d’autres logiciels

• Une clé fonctionne seulement avec le compte de clinique dans lequel elle a été créée.
• Aujourd’hui, un logiciel muni d’une clé peut afficher la liste des appels de votre clinique et lire le détail d’un appel, y compris son résumé et les liens vers sa transcription et son enregistrement. Il peut aussi lancer un appel avec l’un de vos agents IA et vérifier comment il s’est passé. Consultez Lancer des appels depuis votre propre logiciel.
• Une clé agit au nom de la personne qui l’a créée. Si le compte AlloMia de cette personne est désactivé, la clé cesse de fonctionner.
• Seules les clés créées par la personne qui a créé le compte de la clinique peuvent lancer des appels. Une clé créée par quelqu’un d’autre peut lire les appels, mais AlloMia la refuse quand elle lance un appel. Consultez Propriétaire ou Utilisateur : qui peut faire quoi.
• Une clé donne accès aux détails des appels des patients. Traitez-la comme un mot de passe.

• Entendez-vous avec la clinique sur la personne qui crée et supprime les clés. C’est souvent la personne qui a créé le compte de la clinique, puisque seules ses clés peuvent lancer des appels.
• Vérifiez que vous êtes dans la bonne clinique : son nom s’affiche en haut du menu de gauche. Consultez Passer d’une clinique à l’autre.
• Une clinique peut avoir jusqu’à 5 clés à la fois. Les clés n’expirent pas : une clé fonctionne jusqu’à ce que vous la supprimiez.

1. Dans le menu de gauche, sous Organisation, cliquez sur Paramètres (Organization Settings si votre tableau de bord s’affiche en anglais).
2. Cliquez sur l’onglet Clés API. Restez dans l’onglet Clés API qui s’y trouve.
3. Cliquez sur Ajouter une clé.
4. Dans Nom de la clé API, nommez la clé d’après le logiciel qui l’utilisera, par exemple « Système de rendez-vous ». Utilisez de 3 à 50 caractères.
5. Cliquez sur Créer une clé API.
6. La fenêtre Nouvelle clé API créée affiche la clé. Cliquez sur Copier dans le presse-papiers, puis collez la clé tout de suite dans les paramètres de l’autre logiciel ou dans votre gestionnaire de mots de passe.

C’est la seule fois où la clé complète s’affiche. Ensuite, la liste n’en montre que les premiers caractères. Si vous perdez une clé, créez-en une nouvelle et supprimez l’ancienne.

• Les clés commencent par sk-.
• L’autre logiciel envoie la clé dans l’en-tête Authorization de chaque requête à https://allomia.com : Authorization: Bearer sk-…
• Une requête sans clé, avec une mauvaise clé ou avec une clé supprimée reçoit le code HTTP 401 avec l’erreur Unauthorized.

1. Allez dans Paramètres, puis dans l’onglet Clés API.
2. Dans la ligne de la clé, cliquez sur l’icône de corbeille (Supprimer la clé API).
3. Dans la fenêtre Confirmer la suppression, cliquez sur Supprimer la clé API.

La clé cesse de fonctionner tout de suite pour tous les systèmes qui l’utilisent, et c’est irréversible. Pour remplacer une clé sans interruption, créez la nouvelle clé, mettez-la dans l’autre logiciel, puis supprimez l’ancienne.

• Utilisez une clé par système. Vous pourrez ainsi supprimer une clé sans arrêter les autres.
• Gardez les clés dans un gestionnaire de mots de passe ou dans les paramètres secrets de l’autre logiciel. Ne les envoyez jamais par courriel ou par clavardage, et ne les mettez jamais dans du code que d’autres peuvent voir.
• Quand un système n’est plus utilisé, ou quand une personne qui a créé des clés quitte la clinique, supprimez ces clés. Retirer un collègue du compte de la clinique ne supprime pas les clés qu’il a créées.
• Si quelqu’un d’autre a pu voir une clé, supprimez-la et créez-en une nouvelle.

Le deuxième onglet dans Clés API, Clés API externes, ne crée pas de clés AlloMia. Il conserve, chiffrées, des clés pour les autres logiciels de votre clinique, afin qu’un partenaire logiciel qui gère votre compte AlloMia puisse les utiliser quand il configure des connexions pour votre clinique. La plupart des cliniques n’en ont jamais besoin.

Si votre partenaire vous demande d’y ajouter une clé, cliquez sur Ajouter une clé, inscrivez le Nom de la clé exactement comme votre partenaire vous le donne et la Valeur de la clé API, puis cliquez sur Ajouter une clé. La valeur ne s’affiche plus ensuite. Pour la remplacer, cliquez sur l’icône de crayon dans sa ligne (Modifier la clé API), inscrivez la nouvelle valeur et cliquez sur Enregistrer les modifications. N’y mettez pas de clés AlloMia.

• Ajouter une clé est grisé : la clinique a déjà 5 clés (« Nombre maximum de clés API atteint »). Supprimez-en une que vous n’utilisez plus.
• Code HTTP 401 Unauthorized : la clé est erronée ou a été supprimée, ou le compte de la personne qui l’a créée a été désactivé. Créez une nouvelle clé.
• Code HTTP 403 « Insufficient permissions » au lancement d’un appel : la clé n’a pas été créée par la personne qui a créé le compte de la clinique. Demandez à cette personne d’en créer une.
• Vous avez fermé la fenêtre avant de copier la clé : elle ne peut plus s’afficher. Supprimez-la et créez-en une nouvelle.