Ce qu’il vous faut
- Un site configuré chez nous, avec un forfait payant (Basique, Standard, Élite ou Entreprise). Si ce n’est pas encore fait, inscrivez-vous avec votre e-mail et indiquez l’adresse de votre site.
- Une clé API : dans votre tableau de bord, ouvrez Messageries et API, donnez un nom à la clé (par exemple « AstrBot ») et cliquez sur Créer une clé API. Copiez-la tout de suite : elle ne s’affiche qu’une seule fois.
- AstrBot (ou un autre outil) installé et connecté à votre messagerie. La documentation d’AstrBot explique comment l’installer et le connecter à Discord, Telegram, Slack, WeChat ou QQ.
Voici les trois valeurs que tous les outils demandent :
API Base URL: https://7x24hrs.com/v1
API Key: sk-7x24-…
Model: 7x24hrs-assistantLa configuration dans AstrBot
- Ouvrez le tableau de bord d’AstrBot et allez dans Providers. Dans l’onglet Chat Completion, cliquez sur + Add à côté de Provider Sources.
- Dans New model provider, choisissez OpenAI Compatible.
- Donnez-lui un ID facile à reconnaître, comme
7x24hrs. Collez votre clé dans API Key et indiquezhttps://7x24hrs.com/v1dans API Base URL. - Cliquez sur Save And Fetch Models. Sous Available Models, cliquez sur + à côté de
7x24hrs-assistant. Dans la fenêtre qui s'ouvre, laissez cochée uniquement Text sous Model capabilities (décochez Image, Audio et Tool use : l'assistant répond par texte) et cliquez sur Save. - Faites-en le modèle de votre bot : dans Config, choisissez-le comme modèle de chat par défaut (ou choisissez-le pour une seule conversation avec le sélecteur de modèle de Chat).
- Posez une question sur la page Chat d’AstrBot ou dans votre messagerie connectée. La réponse vient des données de votre site.
Laissez vides la persona et le prompt système d’AstrBot, ou faites-les courts : votre assistant suit les règles et le personnage définis dans le tableau de bord 7x24hrs et ne prend pas d’instructions dans le prompt système de la messagerie.
Dify, LobeChat et les autres outils
Tout outil doté d’un fournisseur « compatible OpenAI » ou « OpenAI personnalisé » fonctionne de la même façon : URL de base https://7x24hrs.com/v1, votre clé API et le modèle 7x24hrs-assistant.
- Dify : dans Settings → Model Provider, ajoutez OpenAI-API-compatible, saisissez le nom du modèle, votre clé et l’URL de base comme point de terminaison de l’API, puis utilisez le modèle dans votre application.
- LobeChat : dans les réglages, sous les modèles de langage, activez le fournisseur OpenAI, saisissez votre clé, indiquez l’URL de base comme adresse du proxy API, puis ajoutez
7x24hrs-assistantà la liste des modèles. - Votre propre code : appelez l’API avec n’importe quelle bibliothèque cliente OpenAI, en indiquant l’URL de base et la clé.
Pour tester l’API depuis un terminal :
curl https://7x24hrs.com/v1/chat/completions \
-H "Authorization: Bearer sk-7x24-…" \
-H "Content-Type: application/json" \
-d '{"model": "7x24hrs-assistant", "user": "visitor-42",
"messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'Avec "stream": true, la réponse arrive sous forme de server-sent events, comme chez OpenAI :
curl -N https://7x24hrs.com/v1/chat/completions \
-H "Authorization: Bearer sk-7x24-…" \
-H "Content-Type: application/json" \
-d '{"model": "7x24hrs-assistant", "stream": true,
"messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'Comment fonctionnent les réponses dans les messageries
| Bouton de chat sur votre site | Messagerie via l’API | |
|---|---|---|
| Répond à partir de | Les données de votre site, vos réponses types et votre personnage | Pareil |
| En cas de doute | Le dit et vous transmet le visiteur | Le dit et indique votre adresse de contact dans la réponse |
| Vous êtes prévenu | Par e-mail, Slack, Discord ou Telegram | Pareil, avec la mention « via l’API / AstrBot » |
| Répondre vous-même au visiteur | Depuis votre messagerie ou votre tableau de bord | Impossible d’ici : répondez par e-mail |
| Conversations comptées | Une par visiteur et par conversation | Pareil, sur le même quota mensuel |
Quels forfaits incluent les messageries ?
Tous les forfaits payants : Basique à $19 par mois pour 90 conversations, Standard à $59 pour 275, Élite à $199 pour 1 000 et Entreprise à $1,099 pour 6 000. Les conversations via l’API sont décomptées du même quota mensuel que celles du bouton de chat. Le forfait gratuit n’inclut pas les messageries : les clés créées avec lui sont mises en pause jusqu’à ce que vous choisissiez un forfait payant. Voir les tarifs.
Qu’est-ce qui compte comme une conversation ?
Un visiteur qui discute, quel que soit le nombre de questions qu’il pose, exactement comme avec le bouton de chat. Les outils qui envoient un champ user avec chaque requête nous permettent de distinguer les visiteurs ; sinon, une conversation est reconnue à son premier message.
Un prompt système dans AstrBot peut-il changer ce que dit l’assistant ?
Non. Les prompts système envoyés par la messagerie ne sont pas suivis. L’assistant garde vos règles : il répond uniquement à partir des données de votre site, dit quand il ne sait pas et ne promet rien que votre site ne dise pas. Son personnage est celui que vous définissez dans le tableau de bord.
Les images, messages vocaux ou appels d’outils sont-ils pris en charge ?
Pas encore. Le texte reçoit une réponse ; les images et autres pièces jointes sont retirées du message, et un message sans texte reçoit une erreur claire. Les définitions d’outils envoyées par le client sont ignorées.
Et si une clé fuite ?
Révoquez-la dans Messageries et API : elle cesse aussitôt de fonctionner. Créez-en ensuite une nouvelle et collez-la dans votre outil. Les clés ne sont conservées que sous forme d’empreinte : nous ne pouvons donc pas non plus vous réafficher une clé.