{"id":15634,"date":"2026-07-10T00:32:42","date_gmt":"2026-07-10T05:32:42","guid":{"rendered":"https:\/\/voxpria.com\/docs\/troubleshooting-2\/"},"modified":"2026-07-10T00:32:42","modified_gmt":"2026-07-10T05:32:42","password":"","slug":"troubleshooting","status":"publish","type":"docs","link":"https:\/\/voxpria.com\/fr\/docs\/troubleshooting\/","title":{"rendered":"D\u00e9pannage"},"content":{"rendered":"<h2>D\u00e9pannage<\/h2>\n<p>Solutions aux probl\u00e8mes courants lors de l&rsquo;utilisation de l&rsquo;API REST de VoxPria.<\/p>\n<h3>401 Non autoris\u00e9<\/h3>\n<div style=\"background: #f8d7da; border-left: 4px solid #dc3545; padding: 15px; margin: 20px 0;\">\n<strong>Erreur :<\/strong> \u00ab Invalid or expired API key \u00bb\n<\/div>\n<h4>Solutions :<\/h4>\n<ul>\n<li>\u2705 V\u00e9rifiez que votre cl\u00e9 API est correcte (aucun espace superflu)<\/li>\n<li>\u2705 Assurez-vous d&rsquo;utiliser le format <code class=\"\" data-line=\"\">Authorization: Bearer YOUR_KEY<\/code><\/li>\n<li>\u2705 V\u00e9rifiez que la cl\u00e9 n&rsquo;a pas \u00e9t\u00e9 r\u00e9voqu\u00e9e<\/li>\n<li>\u2705 Confirmez que le format de la cl\u00e9 est <code class=\"\" data-line=\"\">agl_sk_...<\/code><\/li>\n<li>\u2705 Cr\u00e9ez une nouvelle cl\u00e9 API au besoin<\/li>\n<\/ul>\n<h4>Testez votre cl\u00e9 :<\/h4>\n<pre style=\"background: #1e293b; color: #e2e8f0; padding: 20px; border-radius: 8px;\">\ncurl -X GET \"https:\/\/app.voxpria.com\/api\/v1\/credits\" \n  -H \"Authorization: Bearer YOUR_API_KEY\"\n<\/pre>\n<h3>403 Interdit<\/h3>\n<div style=\"background: #f8d7da; border-left: 4px solid #dc3545; padding: 15px; margin: 20px 0;\">\n<strong>Erreur :<\/strong> \u00ab Insufficient permissions for this endpoint \u00bb\n<\/div>\n<h4>Solutions :<\/h4>\n<ul>\n<li>\u2705 V\u00e9rifiez que votre cl\u00e9 API poss\u00e8de les port\u00e9es requises<\/li>\n<li>\u2705 Pour d\u00e9clencher des appels : la port\u00e9e <code class=\"\" data-line=\"\">calls:write<\/code> est requise<\/li>\n<li>\u2705 Pour g\u00e9rer les campagnes : <code class=\"\" data-line=\"\">campaigns:write<\/code> est requise<\/li>\n<li>\u2705 Cr\u00e9ez une nouvelle cl\u00e9 avec les bonnes port\u00e9es au besoin<\/li>\n<\/ul>\n<h3>429 Trop de requ\u00eates<\/h3>\n<div style=\"background: #fff3cd; border-left: 4px solid #ffc107; padding: 15px; margin: 20px 0;\">\n<strong>Erreur :<\/strong> \u00ab Rate limit exceeded \u00bb\n<\/div>\n<h4>Solutions :<\/h4>\n<ul>\n<li>\u2705 Mettez en place un recul exponentiel (exponential backoff)<\/li>\n<li>\u2705 V\u00e9rifiez l&rsquo;en-t\u00eate <code class=\"\" data-line=\"\">X-RateLimit-Reset<\/code> pour conna\u00eetre le d\u00e9lai de nouvelle tentative<\/li>\n<li>\u2705 R\u00e9duisez la fr\u00e9quence des appels API<\/li>\n<li>\u2705 Contactez le soutien pour des limites plus \u00e9lev\u00e9es<\/li>\n<\/ul>\n<h4>Exemple de recul exponentiel :<\/h4>\n<pre style=\"background: #1e293b; color: #e2e8f0; padding: 20px; border-radius: 8px;\">\nasync function retryWithBackoff(fn, maxRetries = 3) {\n  for (let i = 0; i < maxRetries; i++) {\n    try {\n      return await fn();\n    } catch (error) {\n      if (error.response?.status === 429 &#038;&#038; i < maxRetries - 1) {\n        const delay = Math.pow(2, i) * 1000; \/\/ 1s, 2s, 4s\n        await new Promise(resolve => setTimeout(resolve, delay));\n      } else {\n        throw error;\n      }\n    }\n  }\n}\n<\/pre>\n<h3>400 Mauvaise requ\u00eate<\/h3>\n<div style=\"background: #f8d7da; border-left: 4px solid #dc3545; padding: 15px; margin: 20px 0;\">\n<strong>Erreur :<\/strong> \u00ab Invalid request parameters \u00bb\n<\/div>\n<h4>Causes courantes :<\/h4>\n<ul>\n<li>\u274c Champs obligatoires manquants (agentId, toNumber)<\/li>\n<li>\u274c Format de num\u00e9ro de t\u00e9l\u00e9phone invalide (doit \u00eatre E.164 : +1234567890)<\/li>\n<li>\u274c Charge utile JSON invalide<\/li>\n<li>\u274c Types de donn\u00e9es incorrects (cha\u00eene au lieu de nombre)<\/li>\n<\/ul>\n<h4>Solutions :<\/h4>\n<ul>\n<li>\u2705 Validez les num\u00e9ros de t\u00e9l\u00e9phone : <code class=\"\" data-line=\"\">^+[1-9]d{1,14}$<\/code><\/li>\n<li>\u2705 V\u00e9rifiez que tous les champs obligatoires sont pr\u00e9sents<\/li>\n<li>\u2705 V\u00e9rifiez que le JSON est valide<\/li>\n<li>\u2705 Consultez la documentation API pour les exigences du point de terminaison<\/li>\n<\/ul>\n<h3>500 Erreur interne du serveur<\/h3>\n<div style=\"background: #f8d7da; border-left: 4px solid #dc3545; padding: 15px; margin: 20px 0;\">\n<strong>Erreur :<\/strong> \u00ab Internal server error \u00bb\n<\/div>\n<h4>Solutions :<\/h4>\n<ul>\n<li>\u2705 R\u00e9essayez la requ\u00eate apr\u00e8s quelques secondes<\/li>\n<li>\u2705 Mettez en place une logique de nouvelle tentative avec recul<\/li>\n<li>\u2705 Consultez la page d&rsquo;\u00e9tat de VoxPria pour v\u00e9rifier les pannes<\/li>\n<li>\u2705 Contactez le soutien si l&rsquo;erreur persiste<\/li>\n<\/ul>\n<h3>Les appels ne se connectent pas<\/h3>\n<h4>V\u00e9rifiez :<\/h4>\n<ul>\n<li>\u2705 Le num\u00e9ro de t\u00e9l\u00e9phone est valide et au format E.164<\/li>\n<li>\u2705 Le num\u00e9ro n&rsquo;est pas sur une liste d&rsquo;exclusion d&rsquo;appels<\/li>\n<li>\u2705 Le compte dispose de suffisamment de cr\u00e9dits<\/li>\n<li>\u2705 L&rsquo;agent est actif et correctement configur\u00e9<\/li>\n<li>\u2705 Les restrictions de fuseau horaire et d&rsquo;heures d&rsquo;appel<\/li>\n<\/ul>\n<h3>Les webhooks ne sont pas re\u00e7us<\/h3>\n<h4>V\u00e9rifiez :<\/h4>\n<ul>\n<li>\u2705 L&rsquo;URL du webhook est accessible publiquement (HTTPS)<\/li>\n<li>\u2705 Le point de terminaison renvoie rapidement un statut 200<\/li>\n<li>\u2705 Aucun pare-feu ne bloque les adresses IP de VoxPria<\/li>\n<li>\u2705 Le webhook est actif dans le tableau de bord<\/li>\n<li>\u2705 Les \u00e9v\u00e9nements sont correctement abonn\u00e9s<\/li>\n<\/ul>\n<h4>Tester un webhook localement :<\/h4>\n<pre style=\"background: #1e293b; color: #e2e8f0; padding: 20px; border-radius: 8px;\">\n# Utilisez ngrok pour exposer votre serveur local\nngrok http 3000\n\n# Mettez \u00e0 jour l'URL du webhook avec l'URL ngrok\n# D\u00e9clenchez un appel test\n# V\u00e9rifiez la console ngrok pour les webhooks entrants\n<\/pre>\n<h3>R\u00e9ponse JSON invalide<\/h3>\n<h4>Solutions :<\/h4>\n<ul>\n<li>\u2705 V\u00e9rifiez que le type de contenu de la r\u00e9ponse est <code class=\"\" data-line=\"\">application\/json<\/code><\/li>\n<li>\u2705 Assurez-vous d&rsquo;analyser la r\u00e9ponse correctement<\/li>\n<li>\u2705 Recherchez les r\u00e9ponses d&rsquo;erreur dans un format diff\u00e9rent<\/li>\n<li>\u2705 Journalisez le corps brut de la r\u00e9ponse \u00e0 des fins de d\u00e9bogage<\/li>\n<\/ul>\n<h3>Probl\u00e8mes propres \u00e0 l&rsquo;environnement<\/h3>\n<h4>D\u00e9veloppement vs production :<\/h4>\n<ul>\n<li>\u2705 Utilisez des cl\u00e9s API distinctes par environnement<\/li>\n<li>\u2705 N&rsquo;utilisez pas de cl\u00e9s de production en d\u00e9veloppement<\/li>\n<li>\u2705 Testez d&rsquo;abord avec de petits lots<\/li>\n<li>\u2705 Surveillez de pr\u00e8s l&rsquo;utilisation des cr\u00e9dits<\/li>\n<\/ul>\n<h3>Obtenir de l&rsquo;aide<\/h3>\n<p>Si le probl\u00e8me persiste :<\/p>\n<div style=\"background: #d4edda; border-left: 4px solid #28a745; padding: 15px;\">\n<strong>\ud83d\udce7 Contactez le soutien :<\/strong><\/p>\n<ul style=\"margin: 10px 0 0 20px;\">\n<li><strong>Courriel :<\/strong> <a href=\"mailto:support@voxpria.com\">support@voxpria.com<\/a><\/li>\n<li><strong>Documentation :<\/strong> <a href=\"https:\/\/app.voxpria.com\/docs\">app.voxpria.com\/docs<\/a><\/li>\n<li><strong>\u00c9tat du syst\u00e8me :<\/strong> Consultez la page d&rsquo;\u00e9tat du syst\u00e8me<\/li>\n<\/ul>\n<\/div>\n<h4>\u00c0 inclure dans votre demande de soutien :<\/h4>\n<ul>\n<li>Le point de terminaison API que vous appelez<\/li>\n<li>La charge utile de la requ\u00eate (retirez les donn\u00e9es sensibles)<\/li>\n<li>La r\u00e9ponse d&rsquo;erreur compl\u00e8te<\/li>\n<li>L&rsquo;horodatage de l&rsquo;incident<\/li>\n<li>L&rsquo;identifiant de cl\u00e9 API (les 8 derniers caract\u00e8res seulement)<\/li>\n<li>Le langage de programmation ou le cadriciel utilis\u00e9<\/li>\n<\/ul>\n<div style=\"background: #d1ecf1; border-left: 4px solid #17a2b8; padding: 15px;\">\n<strong>\ud83d\udca1 Astuces :<\/strong><\/p>\n<ul style=\"margin: 10px 0 0 20px;\">\n<li>Activez la journalisation d\u00e9taill\u00e9e pendant le d\u00e9veloppement<\/li>\n<li>Utilisez le bac \u00e0 sable API (API playground) pour tester les points de terminaison<\/li>\n<li>Consultez la documentation API pour les mises \u00e0 jour<\/li>\n<li>Joignez-vous \u00e0 notre communaut\u00e9 de d\u00e9veloppeurs<\/li>\n<li>Surveillez le journal des modifications (changelog) pour les changements majeurs<\/li>\n<\/ul>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>D\u00e9pannage Solutions aux probl\u00e8mes courants lors de l&rsquo;utilisation de l&rsquo;API  [&#8230;]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[101],"doc_tag":[],"class_list":["post-15634","docs","type-docs","status-publish","hentry","doc_category-rest-api-for-developers-fr"],"year_month":"2026-08","word_count":721,"total_views":"11","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":[],"doc_category_info":[{"term_name":"API REST pour d\u00e9veloppeurs","term_url":"https:\/\/voxpria.com\/fr\/docs-category\/rest-api-for-developers-fr\/"}],"doc_tag_info":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v26.8 (Yoast SEO v28.0) - https:\/\/yoast.com\/product\/yoast-seo-premium-wordpress\/ -->\n<title>D\u00e9pannage - Ai voice automation system - Voxpria<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/voxpria.com\/fr\/docs\/troubleshooting\/\" \/>\n<meta property=\"og:locale\" content=\"fr_FR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"D\u00e9pannage\" \/>\n<meta property=\"og:description\" content=\"D\u00e9pannage Solutions aux probl\u00e8mes courants lors de l&rsquo;utilisation de l&rsquo;API [...]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/voxpria.com\/fr\/docs\/troubleshooting\/\" \/>\n<meta property=\"og:site_name\" content=\"Ai voice automation system - Voxpria\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Dur\u00e9e de lecture estim\u00e9e\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/voxpria.com\\\/fr\\\/docs\\\/troubleshooting\\\/\",\"url\":\"https:\\\/\\\/voxpria.com\\\/fr\\\/docs\\\/troubleshooting\\\/\",\"name\":\"D\u00e9pannage - Ai voice automation system - Voxpria\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/voxpria.com\\\/fr\\\/#website\"},\"datePublished\":\"2026-07-10T05:32:42+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/voxpria.com\\\/fr\\\/docs\\\/troubleshooting\\\/#breadcrumb\"},\"inLanguage\":\"fr-FR\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/voxpria.com\\\/fr\\\/docs\\\/troubleshooting\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/voxpria.com\\\/fr\\\/docs\\\/troubleshooting\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/voxpria.com\\\/fr\\\/home\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Docs\",\"item\":\"https:\\\/\\\/voxpria.com\\\/fr\\\/docs\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"D\u00e9pannage\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/voxpria.com\\\/fr\\\/#website\",\"url\":\"https:\\\/\\\/voxpria.com\\\/fr\\\/\",\"name\":\"Ai voice automation system - Voxpria\",\"description\":\"Ai voice automation system\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/voxpria.com\\\/fr\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"fr-FR\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/voxpria.com\\\/fr\\\/#organization\",\"name\":\"VoxPria\",\"url\":\"https:\\\/\\\/voxpria.com\\\/fr\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https:\\\/\\\/voxpria.com\\\/fr\\\/wp-content\\\/uploads\\\/2026\\\/02\\\/voxpria-logo.png\"},\"description\":\"VoxPria est une plateforme d'agents vocaux IA qui automatise les appels t\u00e9l\u00e9phoniques entrants et sortants \u2014 ventes, soutien, prise de rendez-vous et qualification de prospects \u2014 dans n'importe quelle langue, 24\\\/7.\",\"foundingLocation\":{\"@type\":\"Place\",\"address\":{\"@type\":\"PostalAddress\",\"addressLocality\":\"Montr\u00e9al\",\"addressRegion\":\"QC\",\"addressCountry\":\"CA\"}},\"areaServed\":\"Worldwide\",\"contactPoint\":{\"@type\":\"ContactPoint\",\"contactType\":\"sales\",\"email\":\"support@voxpria.com\",\"availableLanguage\":[\"en\",\"fr\"]}},{\"@type\":\"SoftwareApplication\",\"@id\":\"https:\\\/\\\/voxpria.com\\\/fr\\\/#software\",\"name\":\"VoxPria\",\"applicationCategory\":\"BusinessApplication\",\"applicationSubCategory\":\"AI Voice Agent \\\/ Call Automation\",\"operatingSystem\":\"Web, Cloud\",\"url\":\"https:\\\/\\\/voxpria.com\\\/fr\\\/\",\"publisher\":{\"@id\":\"https:\\\/\\\/voxpria.com\\\/fr\\\/#organization\"},\"offers\":{\"@type\":\"Offer\",\"price\":\"0\",\"priceCurrency\":\"USD\",\"description\":\"Free tier \u2014 no credit card required\"},\"featureList\":[\"AI voice agents\",\"Outbound & inbound calling\",\"Campaign manager\",\"Flow builder\",\"CRM\",\"WhatsApp\",\"Appointment booking\",\"SIP trunks\",\"REST API\"]}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"D\u00e9pannage - Ai voice automation system - Voxpria","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/voxpria.com\/fr\/docs\/troubleshooting\/","og_locale":"fr_FR","og_type":"article","og_title":"D\u00e9pannage","og_description":"D\u00e9pannage Solutions aux probl\u00e8mes courants lors de l&rsquo;utilisation de l&rsquo;API [...]","og_url":"https:\/\/voxpria.com\/fr\/docs\/troubleshooting\/","og_site_name":"Ai voice automation system - Voxpria","twitter_card":"summary_large_image","twitter_misc":{"Dur\u00e9e de lecture estim\u00e9e":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/voxpria.com\/fr\/docs\/troubleshooting\/","url":"https:\/\/voxpria.com\/fr\/docs\/troubleshooting\/","name":"D\u00e9pannage - Ai voice automation system - Voxpria","isPartOf":{"@id":"https:\/\/voxpria.com\/fr\/#website"},"datePublished":"2026-07-10T05:32:42+00:00","breadcrumb":{"@id":"https:\/\/voxpria.com\/fr\/docs\/troubleshooting\/#breadcrumb"},"inLanguage":"fr-FR","potentialAction":[{"@type":"ReadAction","target":["https:\/\/voxpria.com\/fr\/docs\/troubleshooting\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/voxpria.com\/fr\/docs\/troubleshooting\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/voxpria.com\/fr\/home\/"},{"@type":"ListItem","position":2,"name":"Docs","item":"https:\/\/voxpria.com\/fr\/docs\/"},{"@type":"ListItem","position":3,"name":"D\u00e9pannage"}]},{"@type":"WebSite","@id":"https:\/\/voxpria.com\/fr\/#website","url":"https:\/\/voxpria.com\/fr\/","name":"Ai voice automation system - Voxpria","description":"Ai voice automation system","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/voxpria.com\/fr\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"fr-FR"},{"@type":"Organization","@id":"https:\/\/voxpria.com\/fr\/#organization","name":"VoxPria","url":"https:\/\/voxpria.com\/fr\/","logo":{"@type":"ImageObject","url":"https:\/\/voxpria.com\/fr\/wp-content\/uploads\/2026\/02\/voxpria-logo.png"},"description":"VoxPria est une plateforme d'agents vocaux IA qui automatise les appels t\u00e9l\u00e9phoniques entrants et sortants \u2014 ventes, soutien, prise de rendez-vous et qualification de prospects \u2014 dans n'importe quelle langue, 24\/7.","foundingLocation":{"@type":"Place","address":{"@type":"PostalAddress","addressLocality":"Montr\u00e9al","addressRegion":"QC","addressCountry":"CA"}},"areaServed":"Worldwide","contactPoint":{"@type":"ContactPoint","contactType":"sales","email":"support@voxpria.com","availableLanguage":["en","fr"]}},{"@type":"SoftwareApplication","@id":"https:\/\/voxpria.com\/fr\/#software","name":"VoxPria","applicationCategory":"BusinessApplication","applicationSubCategory":"AI Voice Agent \/ Call Automation","operatingSystem":"Web, Cloud","url":"https:\/\/voxpria.com\/fr\/","publisher":{"@id":"https:\/\/voxpria.com\/fr\/#organization"},"offers":{"@type":"Offer","price":"0","priceCurrency":"USD","description":"Free tier \u2014 no credit card required"},"featureList":["AI voice agents","Outbound & inbound calling","Campaign manager","Flow builder","CRM","WhatsApp","Appointment booking","SIP trunks","REST API"]}]}},"knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/voxpria.com\/fr\/wp-json\/wp\/v2\/docs\/15634","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/voxpria.com\/fr\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/voxpria.com\/fr\/wp-json\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/voxpria.com\/fr\/wp-json\/wp\/v2\/comments?post=15634"}],"version-history":[{"count":0,"href":"https:\/\/voxpria.com\/fr\/wp-json\/wp\/v2\/docs\/15634\/revisions"}],"wp:attachment":[{"href":"https:\/\/voxpria.com\/fr\/wp-json\/wp\/v2\/media?parent=15634"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/voxpria.com\/fr\/wp-json\/wp\/v2\/doc_category?post=15634"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/voxpria.com\/fr\/wp-json\/wp\/v2\/doc_tag?post=15634"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}