Connectez votre assistant IA
Connectez Claude, ChatGPT ou un autre client MCP à votre portail client. L'assistant peut lire vos projets, factures, tickets de support, l'état du site et vos fichiers. Sur les formules Pro et Ultra, il peut aussi ouvrir des tickets ou envoyer des demandes de modification, mais seulement après que vous avez confirmé l'aperçu exact.
Outils et limites
Chaque formule fixe ses propres limites. Le serveur applique le nombre de clés, les requêtes par minute par clé et les unités mensuelles pour l'ensemble du compte.
Basic
GratuitLecture seule. Aucune écriture sur cette formule
Consulter les projets, factures, tickets de support, l'état du site, les fichiers du projet et le rapport mensuel.
Pro
3,000,000 Toman / moisLecture et écritures confirmées
Tous les outils de lecture, plus les écritures confirmées : ouvrir et répondre aux tickets de support, envoyer des demandes de modification et des messages Farr, téléverser des fichiers, créer et mettre à jour des brouillons de contenu, et accepter ou refuser des propositions. Chaque écriture est d'abord prévisualisée et n'est appliquée qu'après votre accord.
Ultra
5,000,000 Toman / moisTout ce qui est dans Pro, plus les actions en masse et les webhooks
Tout ce qui est dans Pro, plus les actions en masse sur les tickets (bulk_ticket_reply, bulk_ticket_close et bulk_actions, jusqu'à 20 tickets par appel), les webhooks (webhook_list, webhook_create et webhook_delete) et les rapports mensuels planifiés (scheduled_reports et scheduled_reports_get).
Sécurité : aucune opération de paiement ou de propriété
L'API de l'assistant ne propose aucun outil pour régler des factures, transférer des fonds, modifier la propriété du compte ou gérer les clés. Les factures y sont en lecture seule. Vous effectuez les paiements directement dans le portail client.
Comment créer une clé d'assistant
Créez une clé dans le portail client en trois étapes.
1. Se connecter au portail
Connectez-vous au portail client et ouvrez Accès assistant dans le menu.
2. Créer une clé
Cliquez sur "Créer une clé". Entrez un nom de 3 à 60 caractères (par exemple "Claude Code - portable"), choisissez les autorisations et la durée de validité. Une nouvelle authentification est requise.
3. Copier la clé immédiatement
La clé complète n'est affichée qu'une seule fois, immédiatement après sa création. Le serveur ne conserve qu'un hachage SHA-256 du secret. En cas de perte, révoquez-la et créez-en une nouvelle.
Comment connecter Claude & ChatGPT
Connectez-vous via le transport HTTP Streamable MCP, avec une clé Bearer ou par authentification OAuth.
Claude Code et autres clients MCP
Dans un outil acceptant une URL de serveur et des en-têtes, comme le fichier .mcp.json de Claude Code, ajoutez cette entrée en remplaçant la variable par votre clé :
{
"mcpServers": {
"sajjad-portal": {
"type": "http",
"url": "https://sajjad.blog/api/client/mcp",
"headers": {
"Authorization": "Bearer <YOUR_AGENT_KEY>"
}
}
}
}ChatGPT et assistants web
Ajoutez cette adresse en tant que connecteur personnalisé et authentifiez-vous lorsque demandé (OAuth). Aucune clé n'est requise par cette voie. Les intitulés des menus peuvent varier selon l'assistant.
Ce que signifie "Aperçu puis confirmation" pour les écritures
Une modification n'est jamais appliquée dès le premier appel.
Lorsqu'un assistant appelle un outil d'écriture, le serveur enregistre la requête exacte et renvoie un aperçu accompagné d'un jeton de confirmation à usage unique valable 10 minutes. La modification n'est effectuée que lorsque l'assistant appelle l'outil de confirmation avec ce jeton, après votre accord explicite. Chaque jeton ne fonctionne qu'une seule fois, pour la clé et le compte émetteurs, avec les mêmes arguments. Chaque action préparée est journalisée.
Référentiel des outils certifiés
Les principaux outils proposés par le point de terminaison client, ainsi que l'outil de confirmation utilisé après un aperçu. Un outil hors de votre formule est refusé avec un message plan_required.
| Nom de l'outil | Type d'accès | Description de la fonctionnalité |
|---|---|---|
| projects_list | Lecture | Lister jusqu'à 50 de vos projets : code, nom, statut, avancement et date d'échéance. |
| invoices_list | Lecture | Lister jusqu'à 25 factures avec date d'échéance, total, montant réglé, solde et statut. Utilisez openOnly pour filtrer les impayées. Les brouillons et liens de paiement sont toujours exclus. |
| tickets_list | Lecture | Lister jusqu'à 50 de vos tickets de support avec statut, priorité et heure de dernière réponse. |
| ticket_get | Lecture | Obtenir l'historique des échanges d'un ticket de support (jusqu'à 100 messages). Les notes internes sont exclues. |
| ticket_create | Écriture confirmée | Préparer un nouveau ticket de support avec priorité basse ou normale. Il n'est créé qu'après confirmation de l'aperçu. |
| ticket_reply | Écriture confirmée | Préparer une réponse à un ticket ouvert. Les tickets fermés ne peuvent pas recevoir de réponse. Envoyé uniquement après confirmation. |
| change_request_create | Écriture confirmée | Préparer une demande de modification sur un projet. Appliquée uniquement après confirmation de l'aperçu. |
| site_status | Lecture | Afficher l'état du domaine, visiteurs et pages vues (24h et 7j), taux de disponibilité et erreurs non résolues du site connecté. Données issues de la dernière synchronisation télémétrique. |
| files_list | Lecture | Lister les fichiers du stockage de projet, jusqu'à 100 par page, éventuellement dans un dossier. |
| file_link | Lecture | Générer un lien de téléchargement pour un fichier stocké. Le lien expire au bout de 15 minutes. |
| report_monthly | Lecture | Obtenir le récapitulatif mensuel (jusqu'à 12 mois) : projets, tickets ouverts et fermés, instantané du site, factures dues et lien PDF expirant après 15 minutes. |
Foire aux questions
Questions courantes sur les assistants clients, la sécurité et les limites d'utilisation.
Mon assistant IA peut-il régler des factures automatiquement ?
Non. L'API de l'assistant ne comporte aucun outil pour payer des factures ou transférer de l'argent. Les factures sont uniquement consultables et le règlement s'effectue par vous-même sur le portail client.
Que se passe-t-il lorsque j'atteins mon quota mensuel d'unités ?
Chaque formule dispose d'un budget mensuel d'unités pour l'ensemble du compte. Une lecture coûte 1 unité et un aperçu d'écriture 3 unités. Lorsque l'utilisation du compte atteint le budget de la formule pour le mois, les appels suivants renvoient une erreur quota_exceeded dans le résultat de l'outil (HTTP 200, pas 429) jusqu'au changement de mois calendaire UTC.
Comment révoquer une clé d'assistant compromise ?
Ouvrez Accès assistant dans le portail client, sélectionnez Révoquer la clé et confirmez. Toute requête ultérieure avec cette clé sera immédiatement rejetée. Les assistants connectés via OAuth peuvent être déconnectés depuis la même page.
Dois-je exécuter un pont local pour connecter ChatGPT ?
Non. Le point de terminaison est une URL HTTPS standard : le client transmet des requêtes JSON-RPC via POST et reçoit du JSON. Les assistants hébergés dans le cloud s'y connectent directement sans logiciel local.
Prêt à activer votre assistant ?
Choisissez un forfait pour commencer ou accédez à votre portail client pour générer une clé d'assistant.