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

1

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).

2

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.

3

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.

4

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”).

5

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.

6

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.

7

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)

1

Rédiger un objet standardisé

Commencez l’objet par un préfixe (ex. [Support][Bug][Prod]) pour faciliter le tri automatique dans vos outils.

2

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.

3

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.

4

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é.

5

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

1

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.

2

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.

3

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.

4

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).

5

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.

6

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

1

Accéder aux paramètres du projet

Ouvrez la page des paramètres du projet depuis le header du projet (ou menu de configuration).

2

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.

3

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.

4

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.

5

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.

6

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)

1

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.

2

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.

3

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).

4

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.

5

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.
  • Utilisez l’adresse inbound dans vos formulaires publics pour alimenter le chat et créer des tickets automatiquement.
  • Prévoyez des validations anti-spam et des limites de taille si le flux est public.
  • Avantage : centralise les demandes externes.
  • Inconvénient : attention à la confidentialité et au spam; limiter les pièces jointes.

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.