Problèmes courants et solutions pour les jonctions SIP de VoxPria. Trouvez des correctifs rapides pour les problèmes les plus fréquents que vous pourriez rencontrer.
Diagnostics rapides #
Vérification de l’état du système #
Avant de dépanner, vérifiez l’état du système :
- Consultez la page d’état de VoxPria
- Consultez la page d’état de votre fournisseur SIP
- Vérifiez votre connexion Internet
- Consultez les journaux d’appels pour des messages d’erreur
Signes et causes courants #
| Symptôme | Cause probable | Correctif rapide |
|———|————–|———–|
| L’importation échoue | Format invalide ou limite de débit | Vérifiez le format E.164, attendez 1 minute |
| Aucun appel entrant | Problème de provisionnement ou d’acheminement | Vérifiez les identifiants de la jonction, consultez l’état |
| Audio de mauvaise qualité | Problème de réseau ou de codec | Passez au TLS, testez la connexion |
| Agent silencieux | Problème de configuration | Vérifiez l’assignation de l’agent et l’invite |
| Erreurs de webhook | Mauvaise configuration de sécurité | Vérifiez le secret du webhook |
Problèmes de numéros de téléphone #
L’importation du numéro de téléphone échoue #
Symptômes :
- L’importation renvoie un message d’erreur
- Le numéro n’apparaît pas dans la liste
- Erreur « Numéro de téléphone invalide »
Solutions :
Vérifiez le format du numéro :
- Doit utiliser le format E.164 :
+[indicatif de pays][numéro] - ✓ Correct :
+12125551234 - ✗ Incorrect :
2125551234,+1-212-555-1234,(212) 555-1234
Vérifiez la configuration de l’API :
`bash
Pour ElevenLabs – Vérifiez la clé API #
Accédez à Paramètres → Intégrations #
Assurez-vous que la clé API ElevenLabs est configurée #
`
Vérifiez les limites de débit :
- Maximum de 10 importations par minute
- Si dépassé, attendez 60 secondes
- Vérifiez la réponse pour les en-têtes de limite de débit
Confirmez la propriété auprès du fournisseur :
- Le numéro doit exister dans votre compte fournisseur
- Vérifiez que le numéro est actif et n’a pas été transféré ailleurs
- Vérifiez le statut du numéro dans le tableau de bord du fournisseur
Exemple de correctif :
`bash
Au lieu de ceci #
curl -X POST /phone-numbers/import
-d ‘{« phone_number »: « 2125551234 »}’ # Format incorrect
Faites ceci #
curl -X POST /phone-numbers/import
-d ‘{« phone_number »: « +12125551234 »}’ # Format correct
`
Provisionnement bloqué ou en échec #
Symptômes :
- Le statut affiche « provisionnement » indéfiniment
- Le bouton Provisionner ne fonctionne pas
- Erreur : « Échec du provisionnement »
Solutions :
Pour les numéros ElevenLabs :
- Vérifiez que les identifiants de la jonction sont corrects
- Vérifiez que le tableau de bord ElevenLabs affiche le numéro
- Essayez de supprimer et de réimporter
- Assurez-vous d’utiliser
sip.rtc.elevenlabs.io(pas l’ancienne adresse) - Vérifiez que le forfait inclut les fonctionnalités SIP
Pour les numéros OpenAI :
- Provisionnez au niveau de la jonction, pas par numéro
- Vérifiez que l’identifiant de projet OpenAI est correct
- Vérifiez que la clé API dispose des permissions Realtime
- Assurez-vous que le secret du webhook est configuré
- Provisionnez le projet entier via les paramètres de la jonction
Forcer le reprovisionnement :
- Modifiez le numéro de téléphone
- Cliquez sur « Reprovisionner »
- Attendez 30 secondes
- Actualisez la page pour vérifier le statut
Vérifiez les journaux :
`bash
Via l’API – Vérifiez le statut de provisionnement #
curl -X GET /phone-numbers/{phone_id}
-H « Authorization: Bearer YOUR_API_KEY »
Cherchez les champs « status » et « error_message » #
`
Le numéro apparaît mais les appels ne se connectent pas #
Symptômes :
- Numéro importé et provisionné
- Le statut affiche « actif »
- Les appels entrants n’atteignent pas l’agent
Solutions :
Vérifiez l’assignation de l’agent :
- Allez à la liste des numéros de téléphone
- Cliquez sur Modifier pour votre numéro
- Confirmez qu’un agent est sélectionné
- Enregistrez si nécessaire
Vérifiez l’acheminement SIP :
- Connectez-vous à votre fournisseur SIP
- Vérifiez que l’acheminement du numéro pointe vers la bonne destination
- Pour ElevenLabs : vérifiez les paramètres de terminaison
- Pour OpenAI : vérifiez l’acheminement vers les points de terminaison OpenAI
Testez avec le fournisseur :
- Certains fournisseurs ont des numéros de test
- Effectuez un appel test via l’interface du fournisseur
- Vérifiez les journaux d’appels du fournisseur
- Vérifiez l’enregistrement SIP
Problèmes de connexion et d’audio #
Les appels entrants ne se connectent pas #
Symptômes :
- Les appels sonnent mais ne répondent jamais
- Déconnexion immédiate
- « Échec de l’appel » dans les journaux
Solutions :
Vérifiez les identifiants de la jonction :
- Allez à Jonctions SIP
- Modifiez votre jonction
- Vérifiez le nom d’utilisateur et le mot de passe
- Mettez à jour si nécessaire
- Cliquez sur « Reprovisionner tous les numéros »
Vérifiez les paramètres de transport :
- Assurez-vous que le transport correspond aux exigences du fournisseur
- TLS (port 5061) recommandé
- TCP (port 5060) en secours
- Doit correspondre aux deux extrémités
Pour ElevenLabs :
`
Serveur : sip.rtc.elevenlabs.io
Port : 5061 (TLS) ou 5060 (TCP)
Transport : TLS recommandé
ANCIENNE ADRESSE (À NE PAS UTILISER) : sip.elevenlabs.io
`
Pour OpenAI :
- Vérifiez que l’URL du webhook est accessible publiquement
- Vérifiez que le secret du webhook est configuré
- Testez le webhook avec curl :
`bash
curl -X POST YOUR_WEBHOOK_URL
-H « Content-Type: application/json »
-d ‘{« test »: « data »}’
`
Vérifiez le pare-feu :
- Autorisez le trafic SIP entrant (ports 5060-5061)
- Autorisez les ports média RTP (généralement 10000-20000)
- Vérifiez les groupes de sécurité de votre fournisseur infonuagique
- Vérifiez qu’aucun pare-feu d’entreprise ne bloque
Échec des appels sortants (ElevenLabs seulement) #
Symptômes :
- Les appels de campagne ne se connectent pas
- Les appels API renvoient des erreurs
- Erreur « Sortant non activé »
Solutions :
Activer le sortant :
- Modifiez le numéro de téléphone dans VoxPria
- Cochez la case « Sortant activé »
- Enregistrez les modifications
Vérifiez les crédits :
- Connectez-vous au tableau de bord ElevenLabs
- Vérifiez le solde du compte
- Ajoutez des crédits si nécessaire
- Vérifiez que la facturation est à jour
Vérifiez les capacités du numéro :
- Tous les numéros ne prennent pas en charge le sortant
- Vérifiez dans le tableau de bord ElevenLabs
- Un type de numéro différent pourrait être nécessaire
Testez d’abord un seul appel :
`bash
Ne commencez pas par des campagnes #
Testez un seul appel sortant via l’API #
curl -X POST /calls/create
-d ‘{
« from »: « +12125551234 »,
« to »: « +13035559876 »,
« agent_id »: « agent_abc123 »
}’
`
Mauvaise qualité audio #
Symptômes :
- Audio haché ou robotique
- Écho ou rétroaction
- Réponses retardées
- L’audio se coupe
Solutions :
Passez au TLS :
- Modifiez votre jonction
- Changez le transport pour TLS
- Mettez à jour le port à 5061
- Reprovisionnez les numéros
- Testez à nouveau
Vérifiez les paramètres de codec :
- VoxPria utilise G.711 (par défaut)
- Vérifiez que le fournisseur prend en charge G.711
- Vérifiez les incompatibilités de codec dans les journaux
Testez le réseau :
`bash
Vérifiez la latence vers le serveur SIP #
ping sip.rtc.elevenlabs.io
Devrait être < 100 ms pour une bonne qualité #
> 200 ms peut causer des problèmes #
`
Vérifiez la bande passante :
- Minimum : 100 Kbps par appel simultané
- Recommandé : 200 Kbps par appel
- Testez à partir de : fast.com ou speedtest.net
L’emplacement compte :
- Testez à partir d’emplacements différents
- Plus proche du fournisseur = meilleure qualité
- Envisagez un CDN ou des emplacements en périphérie
Propre au fournisseur :
- Vérifiez l’état du réseau du fournisseur
- Passez en revue les bonnes pratiques du fournisseur
- Contactez le soutien du fournisseur si le problème persiste
Audio à sens unique ou silencieux #
Symptômes :
- L’appelant n’entend pas l’agent
- L’agent n’entend pas l’appelant
- Silence complet
Solutions :
Vérifiez le NAT/pare-feu :
- Configurez le SIP ALG si offert
- Ouvrez la plage de ports RTP (10000-20000)
- Utilisez STUN/TURN si derrière un NAT
Vérifiez les paramètres médias :
- Vérifiez la configuration de la jonction
- Assurez-vous que le chiffrement média correspond au fournisseur
- Vérifiez les paramètres SRTP si vous utilisez TLS
Testez à partir d’un réseau différent :
- Essayez à partir de données mobiles (contourner le réseau)
- Testez à partir d’un emplacement différent
- Isole un problème réseau d’un problème de configuration
Problèmes d’agent et de webhook #
L’agent ne répond pas #
Symptômes :
- L’appel se connecte mais l’agent est silencieux
- Aucun message d’accueil
- L’agent n’interagit pas
Solutions :
Vérifiez la configuration de l’agent :
- Vérifiez que l’agent est assigné au numéro
- Vérifiez que l’agent a une invite système
- Testez d’abord l’agent dans l’interface VoxPria
- Vérifiez le type d’agent (Natural pour OpenAI)
Vérifiez le premier message :
`bash
Assurez-vous que le premier message est configuré #
{
« config »: {
« first_message »: « Hello! How can I help you today? »
}
}
`
Passez en revue les journaux de l’agent :
- Accédez aux journaux d’appels
- Trouvez l’appel
- Vérifiez les messages d’erreur
- Cherchez les erreurs d’initialisation de l’agent
Pour les agents OpenAI :
- Doit être un agent de type « Natural »
- Les agents structurés/à flux de travail ne fonctionneront pas
- Vérifiez le type d’agent dans les paramètres de l’agent
Testez l’agent séparément :
- Utilisez l’interface Web de VoxPria
- Testez la conversation avec l’agent
- Vérifiez que les réponses fonctionnent
- Testez ensuite par téléphone
Le webhook OpenAI ne reçoit pas d’événements #
Symptômes :
- Les appels ne déclenchent pas VoxPria
- Aucune entrée dans les journaux d’appels
- Les journaux de livraison du webhook indiquent des échecs
Solutions :
Vérifiez l’URL du webhook :
`
Devrait être : https://your-domain.com/api/v1/sip/openai/webhook
PAS : http:// (doit utiliser HTTPS)
PAS : localhost ou 127.0.0.1
`
Vérifiez le secret du webhook :
- Doit correspondre entre OpenAI et VoxPria
- Sensible à la casse
- Aucun espace supplémentaire lors de la copie
- Mettez à jour dans les paramètres de la jonction VoxPria
Testez le webhook manuellement :
`bash
Depuis la plateforme OpenAI #
curl -X POST YOUR_WEBHOOK_URL
-H « X-OpenAI-Signature: test_signature »
-d ‘{« event »: « call.started »}’
Devrait renvoyer 200 OK #
`
Vérifiez le certificat SSL :
`bash
Vérifiez le SSL de votre domaine #
curl -v https://your-domain.com
Devrait montrer un certificat valide #
Aucune erreur SSL #
`
Vérifiez le pare-feu :
- Autorisez HTTPS (443) entrant
- Les plages d’adresses IP d’OpenAI doivent être autorisées
- Aucune limitation de débit sur le point de terminaison du webhook
Passez en revue les journaux OpenAI :
- Allez à la plateforme OpenAI
- Vérifiez les journaux de livraison du webhook
- Cherchez les messages d’erreur
- Notez les codes de réponse
Échec de la validation de la signature du webhook #
Symptômes :
- Erreurs HTTP 401 dans les journaux du webhook
- « Signature invalide » dans les journaux VoxPria
- Les événements ne sont pas traités
Solutions :
Mettez à jour le secret du webhook :
- Copiez le secret depuis la plateforme OpenAI
- Modifiez la jonction OpenAI dans VoxPria
- Collez le secret exactement (sans espaces)
- Enregistrez les modifications
- Reprovisionnez le projet
Régénérez le secret :
- Dans la plateforme OpenAI, régénérez le secret
- Mettez à jour VoxPria immédiatement
- Testez avec le nouveau secret
Vérifiez l’implémentation :
`javascript
// Correct signature verification
const crypto = require(‘crypto’);
function verifySignature(payload, signature, secret) {
const hmac = crypto.createHmac(‘sha256’, secret);
const computed = hmac.update(payload).digest(‘hex’);
return crypto.timingSafeEqual(
Buffer.from(signature),
Buffer.from(computed)
);
}
`
Problèmes de campagne #
Les appels de campagne ne partent pas #
Symptômes :
- La campagne affiche « en cours » mais aucun appel
- Aucune entrée dans les journaux d’appels
- Les destinataires ne reçoivent pas d’appels
Solutions :
Vérifiez les exigences relatives au numéro :
- Fonctionne seulement avec les numéros ElevenLabs
- Le sortant doit être activé
- Les numéros OpenAI ne prennent pas en charge les campagnes
Vérifiez la configuration de la campagne :
- Vérifiez que le numéro de téléphone est sélectionné
- Vérifiez que la liste des destinataires est téléversée
- Assurez-vous que la campagne est démarrée (pas en pause)
- Vérifiez que l’heure planifiée n’est pas passée
Passez en revue le format des destinataires :
`json
// Correct format
[
{
« phone »: « +13035559876 »,
« name »: « John Doe »
}
]
// Numbers must be E.164 format
`
Vérifiez les limites du compte :
- Vérifiez les limites d’appels simultanés
- Vérifiez le solde de crédits ElevenLabs
- Passez en revue les quotas quotidiens/mensuels
Testez un seul appel :
- Essayez d’abord un seul appel sortant
- Vérifiez que ça fonctionne
- Essayez ensuite une petite campagne (5 à 10 appels)
- Augmentez progressivement
Taux d’échec élevé des campagnes #
Symptômes :
- Plusieurs appels affichent le statut « échec »
- Faible taux de réponse
- Déconnexions fréquentes
Solutions :
Optimisation du moment :
- Évitez tôt le matin (avant 9 h)
- Évitez tard le soir (après 20 h)
- Respectez les fuseaux horaires
- Testez différents moments
Réputation du numéro :
- Les nouveaux numéros peuvent être signalés
- Bâtissez la réputation progressivement
- Commencez avec un faible volume
- Augmentez avec le temps
Vérifiez les numéros des destinataires :
- Vérifiez que les numéros sont valides
- Retirez les numéros déconnectés
- Vérifiez les fautes de frappe dans le format E.164
- Testez d’abord avec votre propre numéro
Ajustez les paramètres :
`json
{
« retry_failed »: true,
« retry_delay »: 3600,
« max_retries »: 2,
« call_timeout »: 30
}
`
Facturation et limites #
Erreur « Fonctionnalité non disponible » #
Symptômes :
- Impossible de créer des jonctions
- Limites d’importation restreintes
- L’API renvoie 403 Forbidden
Solutions :
Vérifiez le forfait :
- Vérifiez votre forfait VoxPria
- Assurez-vous que les fonctionnalités SIP sont incluses
- Mettez à niveau si nécessaire
Vérifiez les limites d’utilisation :
- Les forfaits gratuits peuvent avoir des limites de jonctions
- Les forfaits Pro ont des limites plus élevées
- Le forfait Entreprise a des limites personnalisées
Contactez le soutien :
- Si les fonctionnalités devraient être disponibles
- Fournissez les détails du compte
- Demandez l’activation de la fonctionnalité
Limite de débit dépassée #
Symptômes :
- Réponses HTTP 429
- Erreurs « Trop de requêtes »
- Les opérations expirent
Solutions :
Respectez les limites de débit :
- Importations de numéros : 10 par minute
- API générale : 1000 par heure
- Implémentez un recul exponentiel
Implémentez une logique de nouvelle tentative :
`javascript
async function importWithBackoff(number, maxRetries = 3) {
for (let i = 0; i < maxRetries; i++) {
try {
return await importNumber(number);
} catch (error) {
if (error.status === 429) {
const delay = Math.pow(2, i) * 1000; // Exponential
await sleep(delay);
continue;
}
throw error;
}
}
}
`
Opérations groupées :
- Utilisez l’importation en lot pour plusieurs numéros
- Ne bouclez pas des importations individuelles rapides
- Espacez les appels API
Outils de diagnostic #
Testez votre configuration #
Connectivité du serveur SIP :
`bash
Testez l’accessibilité #
nc -zv sip.rtc.elevenlabs.io 5061
Devrait afficher : Connection succeeded #
`
Connectivité API :
`bash
Testez l’API VoxPria #
curl -I https://api.voxpria.com/v1/health
Devrait renvoyer : HTTP 200 OK #
`
Test de webhook :
`bash
Testez votre point de terminaison de webhook #
curl -X POST https://your-domain.com/webhook
-H « Content-Type: application/json »
-d ‘{« test »: « data »}’
Devrait renvoyer : 200 OK #
`
Journalisation et surveillance #
Activez la journalisation détaillée :
- Allez à Paramètres → Développeur
- Activez la journalisation de débogage
- Reproduisez le problème
- Téléchargez les journaux
- Passez-les en revue pour trouver des erreurs
Surveillez la qualité des appels :
- Vérifiez régulièrement les journaux d’appels
- Suivez les taux de succès
- Surveillez les indicateurs de qualité audio
- Configurez des alertes pour les échecs
Passez en revue les journaux du fournisseur :
- La plupart des fournisseurs ont des relevés détaillés d’appels
- Comparez avec les journaux VoxPria
- Identifiez où les échecs se produisent
- Recoupez les horodatages
Obtenir de l’aide #
Avant de contacter le soutien #
Rassemblez ces renseignements :
- Détails de la jonction :
- Identifiant de la jonction
- Type de fournisseur
- Date de création
- Numéro de téléphone :
- Numéro complet (E.164)
- Date d’importation
- Statut actuel
- Détails de l’appel :
- Identifiant de l’appel
- Date et heure
- Durée
- Messages d’erreur
- Ce que vous avez essayé :
- Étapes déjà effectuées
- Résultats de chaque tentative
- Codes d’erreur, le cas échéant
- Environnement :
- Type de forfait VoxPria
- Fournisseur SIP
- Configuration réseau
Canaux de soutien #
Soutien VoxPria :
- Courriel : support@voxpria.com
- Tableau de bord : Aide → Contacter le soutien
- Communauté : community.voxpria.com
Soutien du fournisseur :
- ElevenLabs : support@elevenlabs.io
- OpenAI : help.openai.com
- Le soutien de votre fournisseur SIP
Problèmes urgents :
- Utilisez la priorité « Urgent »
- Incluez une évaluation de l’impact
- Fournissez les journaux d’appels
- Notez l’impact sur les affaires
Codes d’erreur courants #
Codes d’erreur SIP #
| Code | Signification | Solution |
|——|———|———-|
| 401 | Non autorisé | Vérifiez les identifiants |
| 403 | Interdit | Vérifiez les permissions |
| 404 | Introuvable | Vérifiez que le numéro existe |
| 408 | Délai dépassé | Problème de réseau/connectivité |
| 480 | Temporairement indisponible | Réessayez plus tard |
| 486 | Occupé | Destinataire occupé, réessayez |
| 503 | Service indisponible | Problème du fournisseur |
Codes d’erreur API #
| Code | Signification | Solution |
|——|———|———-|
| 400 | Mauvaise requête | Vérifiez le format de la requête |
| 401 | Non autorisé | Vérifiez la clé API |
| 403 | Interdit | Vérifiez le forfait/les permissions |
| 404 | Introuvable | La ressource n’existe pas |
| 409 | Conflit | La ressource existe déjà |
| 429 | Débit limité | Ralentissez les requêtes |
| 500 | Erreur serveur | Contactez le soutien |
Mesures préventives #
Bonnes pratiques #
Entretien régulier :
- Testez les jonctions mensuellement
- Vérifiez les numéros hebdomadairement
- Mettez à jour les identifiants régulièrement
- Surveillez les indicateurs de qualité des appels
Gestion de la configuration :
- Documentez votre configuration
- Conservez une copie de sauvegarde des identifiants (sécurisée)
- Notez les configurations qui fonctionnent
- Suivez les changements
Surveillance :
- Configurez des alertes pour les échecs
- Surveillez les taux de succès
- Suivez la qualité audio
- Passez en revue les journaux régulièrement
Tests :
- Testez après tout changement
- Utilisez des numéros de test pour les nouvelles configurations
- Validez avant la mise en production
- Documentez les résultats des tests
Éviter les erreurs courantes #
✗ À ne pas faire :
- Sauter la configuration du secret du webhook
- Utiliser l’ancienne adresse de serveur ElevenLabs
- Importer des numéros trop rapidement (limites de débit)
- Oublier de provisionner après l’importation
- Utiliser HTTP pour les webhooks de production
✓ À faire :
- Utilisez le transport TLS en production
- Configurez les secrets de webhook immédiatement
- Respectez les limites de débit
- Testez en profondeur avant la mise en ligne
- Gardez les identifiants sécurisés
Prochaines étapes #
- Consultez les Bonnes pratiques de sécurité pour le durcissement en production
- Consultez la Référence de l’API pour les options d’automatisation
- Visitez la FAQ pour d’autres questions
- Joignez le forum communautaire pour des conseils
Vous avez encore des problèmes? Contactez le soutien VoxPria avec vos renseignements diagnostiques pour une aide personnalisée.
