Assistant IA

La source Assistant IA permet de relier votre assistant IA principal à Relancia. Vous pouvez ainsi générer automatiquement des réponses, des messages ou des résumés.

Cette page vous guide pas à pas, depuis la création du compte chez le fournisseur d’IA jusqu’au premier test dans Relancia.

Ce que cette source permet de faire

• générer un message de relance personnalisé
• rédiger une réponse à un client
• résumer un échange avec un contact
• adapter le ton d’un message selon le contexte

Ce dont vous avez besoin

Avant de commencer, préparez :

• un compte chez un fournisseur d’IA (OpenAI, Anthropic, Mistral, etc.)
• une carte bancaire enregistrée pour les services payants
• l’accès à la console de votre fournisseur

Choisir un fournisseur d’IA

Relancia fonctionne avec les principaux fournisseurs d’IA. Voici les plus utilisés :

Pour un artisan qui démarre, OpenAI avec gpt-4o-mini est un bon compromis entre qualité et coût.

Comprendre le parcours en 4 étapes

Pour brancher une IA dans Relancia, vous allez suivre ce parcours :

1. Créer un compte chez le fournisseur
2. Générer une clé d’API
3. Ajouter des crédits ou un moyen de paiement
4. Copier la clé et le modèle dans Relancia

Tutoriel complet avec OpenAI

Cette section détaille la procédure avec OpenAI. Les autres fournisseurs suivent le même principe.

Étape 1 : créer un compte OpenAI

1. allez sur platform.openai.com
2. cliquez sur Sign up en haut à droite
3. créez un compte avec votre email
4. confirmez votre email

Étape 2 : ajouter un moyen de paiement

1. une fois connecté, ouvrez Settings dans le menu de gauche
2. cliquez sur Billing
3. cliquez sur Add payment method
4. entrez votre carte bancaire
5. cliquez sur Set payment method

OpenAI vous facturera à l’usage. Pour un artisan qui envoie quelques dizaines de relances par mois, le coût reste très faible (quelques euros par mois).

Étape 3 : créer une clé d’API

1. dans le menu de gauche, ouvrez API keys
2. cliquez sur Create new secret key
3. donnez un nom à la clé (par exemple Relancia)
4. choisissez les permissions : All pour commencer
5. cliquez sur Create secret key
6. copiez la clé affichée (elle commence par sk-...)

La clé ne s’affiche qu’une seule fois. Copiez-la immédiatement et stockez-la en lieu sûr.

Étape 4 : ajouter des crédits (optionnel)

Pour éviter les surprises sur votre facture, vous pouvez configurer une limite de dépenses :

1. dans Settings > Billing, ouvrez l’onglet Usage limits
2. dans Hard limit, entrez un montant maximum (par exemple 20 $)
3. dans Email notifications, activez les alertes
4. cliquez sur Save

Tutoriel avec Anthropic (alternative)

Si vous préférez Claude d’Anthropic :

1. allez sur console.anthropic.com
2. créez un compte
3. ajoutez un moyen de paiement dans Settings > Billing
4. ouvrez Settings > API Keys
5. cliquez sur Create Key
6. copiez la clé (elle commence par sk-ant-...)

Les modèles recommandés sont claude-3-5-sonnet-20241022 (performant) ou claude-3-haiku-20240307 (rapide et économique).

Tutoriel avec Mistral (alternative européenne)

Si vous préférez Mistral, hébergé en Europe :

1. allez sur console.mistral.ai
2. créez un compte
3. ajoutez un moyen de paiement dans Workspace > Billing
4. ouvrez Workspace > API Keys
5. cliquez sur Create new key
6. copiez la clé

Les modèles recommandés sont mistral-large-latest ou mistral-medium-latest.

Récupérer l’URL de l’API

Chaque fournisseur expose son API à une URL différente :

• OpenAI : https://api.openai.com/v1
• Anthropic : https://api.anthropic.com/v1
• Mistral : https://api.mistral.ai/v1
• Google : https://generativelanguage.googleapis.com/v1

Étape 1 : ouvrir la source dans Relancia

Une fois votre clé d’API créée :

1. connectez-vous à app.relancia.pro
2. dans le menu de gauche, ouvrez Sources
3. cliquez sur Ajouter un service
4. dans la liste, choisissez Assistant IA

Étape 2 : remplir les informations

• Modèle utilisé : le nom du modèle (par exemple gpt-4o-mini, claude-3-5-sonnet-20241022, mistral-large-latest)
• URL du site : l’URL de l’API du fournisseur
• Nom de votre outil : un nom court pour le reconnaître (par exemple OpenAI principal)

Étape 3 : ajouter la clé privée

Dans la zone Clés privées :

• Clé privée IA : collez votre clé d’API

Cette clé est sensible. Elle donne accès à votre compte IA et à votre facturation. Ne la partagez jamais.

Étape 4 : enregistrer et tester

1. dans Relancia, cliquez sur Enregistrer
2. cliquez sur Tester
3. Relancia fait un appel test à l’API
4. si la clé et le modèle sont corrects, le statut passe à Prêt

Comment vérifier que cela fonctionne vraiment

Pour tester l’IA dans un vrai cas d’usage :

1. ouvrez la page Relances
2. créez une relance avec un bloc Générer réponse IA
3. configurez le bloc avec une consigne simple
4. testez la relance
5. vérifiez que la réponse générée est cohérente

Que faire si la source reste en À vérifier

Vérifiez les points suivants dans l’ordre :

• la Clé privée IA est correcte (régénérez-la si vous avez un doute)
• le Modèle utilisé est correctement orthographié (avec la version si nécessaire)
• l’URL du site correspond bien à celle de votre fournisseur
• votre compte dispose de crédits ou d’un moyen de paiement valide
• la clé n’a pas été révoquée

Que faire si l’API retourne une erreur 401

• vérifiez que la clé est correcte
• vérifiez que la clé n’a pas expiré
• vérifiez que la clé dispose des bonnes permissions

Que faire si l’API retourne une erreur 429

• cela signifie que vous avez atteint la limite de votre fournisseur
• attendez quelques minutes, ou passez à un plan supérieur
• vérifiez votre consommation dans la console du fournisseur

Que faire si l’API retourne une erreur 404

• vérifiez l’orthographe du Modèle utilisé
• vérifiez que vous avez accès à ce modèle (certains modèles sont réservés à certains plans)

Bonnes pratiques

• ne partagez jamais votre clé d’API
• vérifiez les coûts d’utilisation de votre fournisseur d’IA
• configurez des limites de dépenses chez votre fournisseur
• testez l’IA sur quelques cas avant de l’utiliser en production
• choisissez un modèle adapté à votre usage (mini pour les cas simples, gros pour les cas complexes)
• surveillez votre consommation mensuelle

Aller plus loin

• Autre IA : pour brancher une IA secondaire
• Ancienne IA : pour garder une IA héritée
• Bonnes pratiques : pour bien utiliser l’IA dans vos relances

Documentation officielle des fournisseurs

Pour aller plus loin, voici les liens directs vers les consoles et documentations des principaux fournisseurs :

• Console OpenAI : pour gérer vos clés, vos crédits et vos usages
• Documentation OpenAI : référence complète de l’API
• Tarification OpenAI : pour estimer vos coûts
• Console Anthropic : pour gérer Claude
• Documentation Anthropic : référence de l’API
• Console Mistral : pour gérer Mistral
• Documentation Mistral : référence de l’API
• Google AI Studio : pour Gemini

Accès rapides à votre console

Une fois votre fournisseur configuré, voici les chemins utiles :

• API Keys : pour gérer vos clés d’API
• Billing : pour gérer votre moyen de paiement et vos limites
• Usage : pour suivre votre consommation
• Models : pour voir la liste des modèles disponibles