Résoudre les problèmes de dépôt de message vocal

Vous lancez une campagne de messages vocaux et tombez sur un code d’erreur incompréhensible ? Pas de panique. Les codes d’erreur VMS de Voice Partner sont conçus pour vous guider vers une solution rapide.

Ces erreurs peuvent survenir pour des raisons variées : données manquantes, limites techniques ou problèmes d’autorisation. Dans ce guide, nous passons en revue tous les codes d’erreur possibles, leurs causes et, surtout, comment les corriger pour que vos messages vocaux arrivent à destination sans accroc.

Qu’est-ce qu’un code d’erreur VMS ?

Un code d’erreur VMS est un message retourné par la plateforme Voice Partner lorsque le dépôt d’un message vocal échoue. Ces codes permettent d’identifier précisément la source du problème, que ce soit un numéro de téléphone manquant, un fichier audio introuvable ou un émetteur non autorisé.

Par exemple, si vous essayez d’envoyer un message vocal à 600 numéros en une seule requête, vous recevrez le code PHONE_NUMBER_SIZE_ERROR. Ce code vous indique clairement que la limite de 500 numéros par envoi a été dépassée.

Pourquoi ces erreurs surviennent-elles ?

Les erreurs VMS peuvent provenir de plusieurs sources :

• Des données incomplètes ou mal formatées : Un numéro de téléphone manquant, un token audio absent ou une URL de notification invalide.
• Des limites techniques : Trop de numéros dans une seule requête, crédits insuffisants, ou fichier audio introuvable.
• Des problèmes d’autorisation : Un émetteur non validé ou un numéro de destination bloqué.

Ces erreurs, si elles ne sont pas résolues, peuvent retarder vos campagnes ou empêcher vos messages d’être délivrés.

Liste complète des codes d’erreur VMS et leurs solutions

Voici la liste exhaustive des codes d’erreur que vous pourriez rencontrer, accompagnés de leurs causes probables et des solutions recommandées.

PHONE_NUMBER_REQUIRED

« Le numéro de téléphone est requis »

• Cause : Le champ phone_number est vide ou manquant dans votre requête API.
• Solution : Assurez-vous que le numéro de téléphone est bien renseigné au format international (exemple : +33612345678).

PHONE_NUMBER_SIZE_ERROR

« Le nombre de numéros est supérieur à 500 »

• Cause : Votre liste de numéros dépasse la limite autorisée de 500 numéros par requête.
• Solution : Segmentez votre liste en sous-ensembles de 500 numéros maximum et envoyez plusieurs requêtes.

TOKEN_AUDIO_REQUIRED

« Le token de l’audio est requis »

• Cause : Le token généré pour l’audio n’est pas fourni dans la requête.
• Solution : Générez un token valide via l’API Voice Partner et incluez-le dans votre requête.

NOTIFY_URL_INVALID

« L’URL de notification est invalide »

• Cause : L’URL fournie pour les notifications de statut est mal formatée ou inaccessible.
• Solution : Utilisez une URL HTTPS valide et vérifiez qu’elle est accessible depuis l’extérieur.

SENDER_NOT_AUTHORIZED

« L’émetteur n’est pas autorisé »

• Cause : Le numéro émetteur (sender) n’est pas enregistré ou approuvé par Voice Partner.
• Solution : Contactez le support Voice Partner pour faire valider votre émetteur.

SENDER_INVALID

« L’émetteur est invalide »

• Cause : Le format de l’émetteur est incorrect (exemple : caractères spéciaux non autorisés).
• Solution : Utilisez un émetteur alphanumérique (11 caractères maximum) ou un numéro de téléphone valide.

AUDIO_FILE_NOT_FOUND

« Le fichier audio est introuvable »

• Cause : Le fichier audio référencé n’existe pas ou a été supprimé.
• Solution : Vérifiez le chemin du fichier et réuploadez-le si nécessaire.

DESTINATION_INVALID

« Le numéro de téléphone n’est pas autorisé »

• Cause : Le numéro de destination est bloqué (liste noire, pays non supporté, etc).
• Solution : Vérifiez la conformité du numéro avec les règles de Voice Partner.

NOT_CREDIT

« Crédit insuffisant »

• Cause : Votre compte n’a plus assez de crédits pour envoyer le message.
• Solution : Rechargez votre compte via l’espace client Voice Partner.

PHONE_NUMBER_INVALID

« Numéro invalide »

• Cause : Le numéro est mal formaté (manque le +, trop court, etc.).
• Solution : Corrigez le format (exemple : +33612345678).

Bonnes pratiques pour éviter les erreurs VMS

Pour minimiser les risques d’erreur, voici quelques conseils pratiques :

• Préparez vos données : Vérifiez systématiquement les numéros de téléphone, les tokens et les URLs avant l’envoi.
• Testez en bac à sable : Envoyez un message test pour valider le processus.
• Surveillez vos crédits : Utilisez l’API pour vérifier votre solde avant une campagne.
• Consultez les logs : Les logs API de Voice Partner fournissent des détails précis sur les échecs.

Si vos problèmes persistent, n’hésitez pas à nous contacter par chat, email ou téléphone pour que nos experts techniques vous apportent leur aide.