Erreurs courantes

Ce guide présente les erreurs les plus fréquentes que vous pouvez rencontrer en utilisant Conviro, ainsi que la façon de les résoudre.

HTTP 401 -- Unauthorized

Signification : Votre clé API ou votre jeton de session est invalide ou a expiré.

Causes et solutions :

• La clé API est incorrecte -- vérifiez la clé dans Dashboard -> Settings -> API Keys
• La clé API a été révoquée -- générez une nouvelle clé et mettez à jour votre intégration
• La session a expiré -- déconnectez-vous du tableau de bord, puis reconnectez-vous
• En-tête Authorization manquant -- assurez-vous que votre requête API contient Authorization: Bearer sk_your_key

HTTP 403 -- Forbidden

Signification : Vous n'avez pas l'autorisation d'accéder à cette ressource.

Causes et solutions :

• Domaine non autorisé -- ajoutez le domaine de votre site dans Dashboard -> Assistants -> Your Bot -> Channels -> Allowed Domains
• Limite du forfait atteinte -- vous essayez d'utiliser une fonctionnalité qui n'est pas disponible dans votre forfait actuel (par exemple WhatsApp avec Starter)
• Restriction de rôle -- votre rôle d'équipe (Agent) n'a peut-être pas les droits pour cette action ; demandez à un Admin ou à un Owner
• Le bot est inactif -- activez le bot dans Dashboard -> Assistants

HTTP 404 -- Not Found

Signification : La ressource demandée n'existe pas.

Causes et solutions :

• Mauvais endpoint -- consultez la documentation API sur /developers pour connaître les URL correctes
• Ressource supprimée -- le chatbot, la session ou le contact a été supprimé
• Faute de frappe dans l'ID -- vérifiez l'ID de la ressource dans l'URL de votre requête

HTTP 429 -- Too Many Requests (limitation de débit)

Signification : Vous avez dépassé la limite de débit de l'API prévue par votre forfait.

Causes et solutions :

• Vérifiez les en-têtes de limite de débit dans la réponse :

X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

• Réduisez la fréquence des requêtes -- ajoutez des délais ou regroupez les opérations
• Passez à un forfait supérieur -- les forfaits supérieurs offrent des limites de débit plus élevées
• Mettez les réponses en cache -- évitez d'envoyer plusieurs fois la même requête

Limites de débit par forfait :

Erreurs CORS

Signification : Le navigateur bloque une requête cross-origin.

Symptôme : La console du navigateur affiche une erreur du type Access to XMLHttpRequest has been blocked by CORS policy.

Causes et solutions :

• Domaine du widget non autorisé -- ajoutez votre domaine à la liste Allowed Domains
• Contenu mixte -- si le widget est chargé en HTTPS, assurez-vous que votre site utilise HTTPS (et non HTTP)
• Interférence d'un proxy ou d'un CDN -- vérifiez si votre CDN supprime les en-têtes CORS

Échecs de livraison des webhooks

Signification : Conviro a envoyé un webhook, mais votre serveur n'a pas répondu avec un code de statut 2xx.

Causes et solutions :

• Le serveur est hors service -- vérifiez que votre endpoint webhook fonctionne et qu'il est accessible
• Délai dépassé -- Conviro attend une réponse pendant 10 secondes. Assurez-vous que votre endpoint répond rapidement
• Problème de certificat SSL -- votre endpoint doit disposer d'un certificat SSL valide (les certificats auto-signés ne sont pas acceptés)
• Blocage par le pare-feu -- autorisez la plage d'adresses IP de Conviro dans votre pare-feu
• Mauvaise URL -- vérifiez l'URL du webhook dans Dashboard -> Settings -> Webhooks

Politique de nouvelle tentative : Conviro réessaie les webhooks en échec 3 fois avec un délai exponentiel (1 min, 5 min, 30 min). Après 3 échecs, le webhook est marqué comme défaillant et vous recevez une notification par e-mail.

Consultez les journaux de livraison dans Dashboard -> Settings -> Webhooks -> Delivery Log.

Limite de messages atteinte

Signification : Vous avez utilisé tous vos messages du mois.

Causes et solutions :

• Free/Starter -- les conversations sont suspendues jusqu'au prochain cycle de facturation. Passez à un forfait supérieur pour obtenir plus de messages.
• Pro/Growth -- activez la facturation du dépassement dans Dashboard -> Settings -> Billing pour acheter automatiquement des blocs de messages supplémentaires.
• Vérifiez votre consommation -- suivez votre consommation dans Dashboard -> AI Usage.

Conseils généraux

• En cas d'erreurs côté client, vérifiez toujours la console du navigateur (F12).
• Pour les erreurs d'API, examinez le corps de la réponse -- il contient généralement un message d'erreur explicite.
• Consultez la page de statut de Conviro pour connaître les incidents ou les maintenances en cours.
• Si vous ne parvenez pas à résoudre le problème, contactez [email protected] en indiquant les détails de l'erreur, l'ID de requête (si disponible) et les étapes pour reproduire le problème.