Configuration & gestion : clés API et emails entrants
Configuration & gestion : clés API et emails entrants
Tout ce qu’il faut configurer pour que le chat contextuel fonctionne correctement (gestion des clés et des emails entrants)
Regroupe la configuration nécessaire pour que le chat “Chat avec le code” puisse recevoir des tickets par email et utiliser une clé OpenAI adaptée au projet.
Ce que couvre cette page
Adresse email inbound
Affichage clair de l’adresse inbound du projet et action rapide pour la copier afin d’envoyer des tickets entrants.
Aide & navigation API
Accès direct à l’aide “Automatiser par API” depuis le chat et navigation vers la gestion des clés API.
Clés OpenAI du projet
Comprendre quand le chat utilise la clé OpenAI du projet, comment la définir, et alternatives si elle manque.
Sécurité & bonnes pratiques
Conseils pour stocker et manipuler les clés, éviter les fuites, et expirations.
Résolution des problèmes
Étapes de dépannage si la copie échoue, si l’email inbound n’apparaît pas, ou si le chat demande une clé.
Scénarios multi-rôles
Différences d’actions selon votre rôle (propriétaire / éditeur / contributeur).
Introduction
Cette page explique, pas à pas et pour chaque scénario courant, comment afficher et copier l’adresse email inbound d’un projet (pour envoyer des tickets), comment accéder à l’aide API depuis le chat et naviguer vers la gestion des clés API, et comment gérer la clé OpenAI utilisée par le chat. Vous trouverez des workflows détaillés, des astuces de sécurité, des cas limites et un FAQ pour les questions fréquentes.
Avant de commencer
Si vous administrez plusieurs projets, notez l’adresse inbound et la clé OpenAI associées à chaque projet : elles sont spécifiques au projet et déterminent le contexte et les permissions du chat.
Workflow 1 — Afficher et copier l’adresse inbound email du projet
Ouvrir l’onglet Chat du projet
Depuis la page du projet, rendez-vous sur l’onglet “Chat avec le code” (ou équivalent). Vérifiez que vous êtes bien sur le bon projet (nom visible en haut).
Repérer l’icône ou le bouton email dans l’en-tête
Dans l’en-tête du composant chat, cliquez sur le petit bouton/icone email (souvent présenté comme un popover). Ce popover affiche l’adresse inbound si elle est configurée.
Vérifier l’adresse affichée
Lisez l’adresse inbound affichée (format type projet+xxxxx@…). Confirmez que le projet affiché correspond bien à l’adresse.
Copier l’adresse
Cliquez sur le bouton “Copier” à côté de l’adresse. Après le clic, un message de confirmation doit apparaître (ex. “Adresse copiée”).
Coller dans votre client mail ou système de tickets
Ouvrez votre client de messagerie ou outil de ticketing et collez l’adresse dans le champ destinataire. Envoyez un email test avec un objet clair (ex. “[Ticket] Problème X”) et un contenu décrivant le problème.
Vérifier la réception dans le chat ou dashboard
Selon la configuration du projet, le ticket doit apparaître dans le chat (ou dans l’interface de gestion des tickets). Patientez quelques minutes et vérifiez les logs/messages entrants.
Si la copie échoue
- Essayez le raccourci clavier (Ctrl/Cmd+C) après avoir sélectionné l’adresse.
- Vérifiez les permissions du navigateur pour accéder au presse-papiers.
- Si toujours impossible, sélectionnez manuellement le texte, copiez, puis collez.
Adresse inbound manquante
Si aucun email inbound n’est affiché dans le popover, l’adresse n’a pas été configurée pour ce projet. Contactez un propriétaire du projet ou l’administrateur pour l’activer. Sans adresse inbound, vous ne pourrez pas envoyer de tickets par e‑mail.
Format et contenu de vos emails de ticket
Dans l’objet, commencez par un tag (ex. [Ticket]) et dans le corps fournissez : résumé, étapes pour reproduire, logs ou captures d’écran (si possible). Cela aide le chat et les agents à classer et répondre automatiquement.
Workflow 2 — Envoyer un ticket entrant proprement (préparation et bonnes pratiques)
Rédiger un objet standardisé
Commencez l’objet par un préfixe (ex. [Support][Bug][Prod]) pour faciliter le tri automatique dans vos outils.
Inclure les métadonnées essentielles
Dans le corps, ajoutez : environnement (prod/staging), version, étapes pour reproduire, priorité, contact. Si possible, collez des extraits de logs en format texte.
Limiter les pièces jointes lourdes
Si vous joignez des fichiers volumineux, placez-les sur un service de stockage et fournissez le lien plutôt que d’envoyer des pièces jointes >10–20 Mo.
Vérifier le destinataire et envoyer
Assurez-vous d’avoir collé l’adresse inbound exacte (ne modifiez pas le suffixe) puis envoyez. Conservez une copie du mail envoyé pour traçabilité.
Contrôler le traitement du ticket
Surveillez le chat/projet pour la création automatique du ticket et la réponse. Si rien n’apparaît après plusieurs minutes, suivez les étapes de dépannage (voir FAQ).
Workflow 3 — Accéder à l’aide API depuis le chat et aller gérer vos clés API
Ouvrir le popover d’aide API dans le chat
Dans l’entête du chat, cliquez sur le bouton marqué “Automatiser par API” (ou icône correspondante). Un popover présente l’intérêt d’exposer votre code via API et propose un lien vers la gestion des clés.
Lire la description et les bullets
Lisez les points clés du popover (ex. bénéfices, cas d’usage). Cela clarifie pourquoi vous pourriez avoir besoin d’une clé API pour des intégrations.
Cliquer sur 'Gérer les clés' ou 'Voir la documentation'
Utilisez le bouton du popover pour naviguer vers la page de gestion des clés API ou la documentation. Vous serez dirigé vers la section “Clés API” dans vos paramètres.
Créer ou copier une clé (si vous avez les droits)
Sur la page des clés API, suivez l’interface pour créer une nouvelle clé si nécessaire : donnez-lui un nom descriptif, définissez une expiration si souhaité et copiez-la immédiatement (elle est affichée en clair une seule fois).
Stocker la clé en sécurité
Collez la clé dans votre gestionnaire de mots de passe ou dans une variable d’environnement sécurisée. Ne la partagez pas dans des canaux non sécurisés.
Retourner au chat et utiliser la clé si demandé
Si le chat vous demande une clé ou si une intégration la requiert, fournissez la clé stockée via le mécanisme prévu (entrée dédiée). Évitez de coller la clé directement dans le champ de conversation publique.
Nommer vos clés de façon descriptive
Choisissez des noms qui indiquent l’usage (ex. “CI/CD Deployments”, “Webhook Processor”, “Chat — Support projet X”) pour pouvoir révoquer facilement les clés inutilisées.
Workflow 4 — Gérer la clé OpenAI du projet (propriétaire / mainteneur) — définition ou mise à jour
Accéder aux paramètres du projet
Ouvrez la page des paramètres du projet depuis le header du projet (ou menu de configuration).
Trouver la section 'Clé OpenAI' ou 'Intégrations LLM'
Repérez la zone destinée à la clé OpenAI du projet. Le libellé peut indiquer “clé OpenAI du projet” ou similaire.
Saisir ou remplacer la clé
Collez la clé dans le champ prévu et sauvegardez. Si une ancienne clé existait, vous serez informé qu’elle sera remplacée.
Vérifier le statut après enregistrement
Après sauvegarde, effectuez un test rapide depuis le chat : lancez une requête simple pour vérifier que le chat utilise la clé du projet et répond correctement.
Si vous n’êtes pas propriétaire
Si vous n’avez pas les droits nécessaires pour modifier cette clé, demandez au propriétaire de projet de la mettre à jour ou d’accorder les droits nécessaires.
Rotation et expiration
Planifiez une rotation périodique (ex. tous les 90 jours) et utilisez la date d’expiration si supportée pour limiter l’exposition en cas de compromission.
Clé affichée une seule fois
Quand vous créez une nouvelle clé API (ou une clé OpenAI de projet), l’interface peut l’afficher uniquement au moment de la création. Copiez-la immédiatement : il ne sera peut-être plus possible de la récupérer ensuite en clair.
Workflow 5 — Que faire si le chat demande une clé OpenAI (utilisateur final)
Vérifier si le projet dispose déjà d’une clé
Avant toute chose, vérifiez dans l’en-tête ou dans la page projet si une clé de projet est définie : si oui, normalement le chat l’utilise automatiquement.
Comprendre la demande du chat
Le chat peut demander une clé si : la clé du projet est absente, expirée ou a rencontré une erreur. L’interface vous indiquera généralement pourquoi elle en a besoin.
Fournir une clé personnelle temporaire (si autorisé)
Si vous avez l’autorisation, copiez votre clé personnelle (ou celle créée pour l’usage) depuis la page “Clés API” et collez-la dans le champ sécurisé demandé par le chat (ne la publiez pas dans le flux de conversation).
Demander au propriétaire de définir la clé du projet
Si vous ne pouvez pas fournir de clé, demandez au propriétaire du projet de configurer la clé OpenAI du projet afin que tous les membres en bénéficient.
Après fourniture, tester et révoquer si nécessaire
Une fois la clé fournie et testée, si elle était destinée à un usage temporaire, pensez à la révoquer ou la remplacer pour des raisons de sécurité.
- Utilisez l’adresse inbound pour signaler bugs ou demandes internes.
- Privilégiez des objets standardisés et incluez identifiants internes pour faciliter le routage.
- Avantage : tickets directement associés au projet, traçabilité.
- Inconvénient : nécessite que l’adresse inbound soit activée pour le projet.
Avant : les emails de support arrivaient dans une boîte générique et nécessitaient une saisie manuelle dans l’outil du projet.
Après : en utilisant l’adresse inbound projet, les tickets arrivent directement dans le chat/projet, sont enrichis et peuvent être traités automatiquement.
Séparer les usages
Créez une adresse inbound dédiée pour les envois automatisés (CI, formulaires) et une autre pour les échanges humains si vous voulez appliquer des règles de traitement différentes.
Sauvegarde et suivi des clés
Conservez toujours une copie fiable de la clé nouvellement créée dans un gestionnaire de mots de passe. Documentez qui a accès à quelle clé et pourquoi.
Ne partagez jamais une clé en clair dans une conversation
Évitez de coller des clés secrètes dans le corps d’un chat public ou d’un ticket visible par tous : utilisez les champs dédiés et stockez les clés dans un coffre fort numérique.
Frequently Asked Questions
Comparaison : clé OpenAI du projet vs clé personnelle
- Clé OpenAI du projet : partageable à tous les membres du projet, configuration centralisée, idéal pour usages partagés et production.
- Clé personnelle/temporaire : utile pour tests ou contributions ponctuelles, meilleure traçabilité individuelle mais nécessite prudence et révocation après usage.
Accédez à la gestion des clés API
Créez, copiez et gérez vos clés API en toute sécurité depuis la page dédiée aux clés. N’oubliez pas de les stocker dans un gestionnaire sécurisé après création.