Dépannage
Isolez en toute sécurité les problèmes de publication, de connaissances, d'intégration, de voix, de connecteurs, de domaines, de facturation et d'API.
Isolez en toute sécurité les problèmes de publication, de connaissances, d'intégration, de voix, de connecteurs, de domaines, de facturation et d'API.
Commencez par un cas reproductible#
Avant de modifier les paramètres, notez :
- L'espace de travail/le site, la route publique ou le point de terminaison de l'API, ainsi que l'heure exacte avec le fuseau horaire.
- Le résultat attendu et le résultat obtenu.
- Le navigateur/l'appareil ou le canal du fournisseur externe.
- Si le problème touche l'aperçu du owner, la page de démonstration hébergée résiduelle, l'intégration, le connecteur et/ou l'API.
- Le texte d'état/d'erreur sans risque, l'en-tête de réponse
x-request-id, la dernière erreur du connecteur ou l'ID d'événement de livraison du fournisseur. - La dernière heure de bon fonctionnement connue et la plus petite modification récente.
N'incluez pas d'identifiants d'API/de fournisseur/de connecteur en clair, de secrets de webhook, de données privées de customers, d'en-têtes d'autorisation complets ni de contenu de conversation superflu.
Les modifications du site n'apparaissent pas#
- Vérifiez que l'URL du tableau de bord correspond bien au site et à l'espace de travail prévus.
- Vérifiez que l'action d'enregistrement a bien indiqué un succès.
- Les instructions et les connaissances indexées s'appliquent aux nouvelles conversations sans nouvelle publication. Si le widget lui-même est masqué, réactivez-le depuis le menu Mettre en ligne de la page de l'agent → Widget de site web (ou depuis la carte Sur votre site web de l'onglet Vue d'ensemble).
- Pour les paramètres d'Affichage (et le badge de marque), les modifications sont enregistrées automatiquement et actualisent déjà l'intégration en ligne : inutile de republier, ouvrez simplement une fenêtre de navigation privée.
- Ouvrez une véritable intégration (ou un slug hébergé résiduel, si vous en avez encore un) dans une fenêtre de navigation privée.
- Si seul un aperçu sur les réseaux sociaux est périmé, utilisez le cache/l'outil de débogage de cette plateforme.
Dépublier et modifier sont deux choses différentes. Un connecteur de messagerie connecté peut continuer à répondre même lorsque l'intégration est désactivée.
La réponse de l'agent est faible ou erronée#
Posez la même question dans le testeur du owner et dans une nouvelle conversation publique. Vérifiez que la source de connaissances concernée a été indexée, qu'elle contient une réponse explicite, qu'elle est à jour et qu'elle n'entre pas en conflit avec une autre source. Examinez les règles de langue/de persona pour détecter une limite qui empêcherait la réponse.
Lorsque la source ne contient pas de réponse, améliorez le comportement de repli/d'escalade plutôt que de demander à l'agent de deviner. Utilisez Sources de connaissances pour créer un jeu de validation avec des questions directes, des paraphrases et des cas limites.
Le lanceur d'intégration est absent ou bloqué#
Vérifiez que le site est publié, que l'intégration est activée, que le script contient le slug exact du site et que l'origine parente finale du navigateur (schéma, nom d'hôte et port compris) figure dans la liste d'autorisation. Dans les DevTools, inspectez la requête embed.js, les erreurs CSP, l'état du gestionnaire de consentement, la requête de l'iframe et la présence d'une seule racine data-maf-embed.
Si le texte fonctionne mais pas le microphone, vérifiez le HTTPS, l'autorisation du navigateur, l'autorisation allow de l'iframe et la Permissions Policy de l'hôte. Suivez la Présentation de l'intégration complète ainsi que Sécurité et CSP.
La voix ne fonctionne pas#
Distinguez le mode en échec : message vocal, appel en direct ou voix via un connecteur. Un parcours texte fonctionnel prouve uniquement que la clé du modèle de langage est valide.
Vérifiez séparément les clés des fournisseurs de transcription, de synthèse vocale (TTS) et de temps réel ; vérifiez ensuite les droits du forfait, le solde de credits, le quota de minutes en direct, l'autorisation du navigateur et les langues configurées. Testez un enregistrement court et clair avant d'étudier un fichier long ou bruité.
Le connecteur ne reçoit aucun message#
Utilisez le guide du canal et comparez les deux côtés. Vérifiez que le connecteur est activé, que les identifiants sont toujours valides, que l'URL de webhook/d'interaction/de skill du fournisseur est bien l'URL actuelle, que l'événement/la Page/le numéro/le bloc requis est abonné, que le mode de l'application inclut l'utilisateur de test et que la livraison HTTPS publique fonctionne.
Le succès de la vérification du webhook ne prouve pas l'abonnement aux événements à l'exécution ni les autorisations d'envoi. Comparez les journaux de livraison du fournisseur avec Dernier message et l'erreur enregistrée du connecteur. Testez le texte avant la voix.
Les domaines personnalisés ne sont pas proposés#
Nous ne vendons ni ne rattachons de domaines de customers. Placez l'agent sur le site que vous possédez déjà grâce à l'intégration. Les événements résiduels de module complémentaire de domaine Polar sont ignorés ou annulés et ne génèrent jamais de credits.
La requête API échoue#
Notez la méthode, le chemin versionné, le statut, le code d'erreur stable, l'en-tête de réponse x-request-id et les en-têtes de limite de débit pertinents. Classez ensuite le problème :
| Statut | Action la plus probable |
|---|---|
400 | Corrigez la structure JSON/du formulaire ou les détails de validation ; ne réessayez pas à l'identique |
401 | Utilisez un identifiant MAF valide, non expiré et non révoqué ; n'utilisez jamais une clé de fournisseur |
403 | Ajoutez le scope requis ou rétablissez l'accès au forfait/à la ressource |
404 | Vérifiez que l'ID appartient à l'espace de travail authentifié et que le chemin est correct |
409 | Résolvez le conflit d'état ou rejouez la même clé d'idempotence/le même payload |
415 | Envoyez le type de contenu documenté |
429 | Respectez les en-têtes retry-after/de réinitialisation avec une part d'aléa (jitter) ; ne bouclez pas en continu |
500 | Réessayez une requête sûre/idempotente et conservez l'ID de requête et l'heure |
Consultez Identifiants et jetons, Scopes et erreurs et Limites de débit. Ne résolvez jamais une erreur d'API en déplaçant un identifiant serveur dans du code navigateur.
La facturation ou l'utilisation semble incorrecte#
Distinguez l'accès à la plateforme, les credits mensuels, les credits achetés, le nombre de sites, les minutes en direct, le débit de l'API, les canaux de messagerie (Operate+) et le BYOK/les team members (Scale). Une recharge ne modifie que les credits. Les frais du fournisseur BYOK sont distincts de la facturation de Make Agent Fast.
En cas d'utilisation inattendue, circonscrivez la source probable avant d'enquêter : désactivez un connecteur, révoquez une clé, supprimez une origine d'intégration involontaire ou arrêtez une boucle de nouvelles tentatives de l'API. Conservez la plage horaire et les ID de requête/de fournisseur sans exposer de secrets.
Rassembler des informations sûres pour le support#
Si vous êtes toujours bloqué, utilisez le contrôle de feedback du guide le plus pertinent ou contactez le support depuis le tableau de bord en indiquant :
- L'identifiant du site/de l'espace de travail et la fonctionnalité concernée.
- L'horodatage exact avec le fuseau horaire et les étapes de reproduction.
- Le résultat attendu et le résultat obtenu.
- L'URL publique sans secret, le cas échéant.
- Le statut HTTP, le code d'erreur stable, le
x-request-idou l'ID d'événement du fournisseur. - Une capture d'écran expurgée ou un payload minimal dont les secrets et les données personnelles ont été retirés.
Indiquez ce que vous avez déjà vérifié. Cela évite de répéter des conseils de configuration et permet de délimiter clairement la source de la défaillance.