Guide de configuration OpenAI SIP

L’intégration OpenAI SIP apporte les capacités de GPT-4o Realtime à votre système téléphonique, permettant des conversations vocales à latence ultra-faible avec une IA avancée. Ce guide couvre la configuration de la plateforme SIP d’OpenAI.

Pourquoi choisir OpenAI SIP? #

Intégration GPT-4o Realtime #

• Latence ultra-faible – Réponses quasi instantanées propulsées par l’API GPT-4o Realtime
• Conversations naturelles – Compréhension avancée du langage et conscience du contexte
• Audio en continu (streaming) – Traitement audio en temps réel sans délais de transcription
• Contexte riche – Toutes les capacités de GPT-4o, y compris le raisonnement et les connaissances

Technologie WebRTC #

OpenAI SIP utilise des connexions WebRTC de navigateur à navigateur, offrant un audio de haute qualité avec une infrastructure minimale.

Limitations importantes #

Avant de continuer, comprenez ces limitations clés :

Entrant seulement #

• ✓ Appels entrants pris en charge
• ✗ Appels sortants NON pris en charge
• ✗ Campagnes vocales NON disponibles

Agents naturels seulement #

• Fonctionne avec les agents de type « Naturel »
• Les agents structurés ou de type flux de travail ne sont pas compatibles
• L’agent doit adopter une approche conversationnelle

Aucun enregistrement serveur #

• Les appels utilisent des connexions WebRTC directes de navigateur
• Aucun enregistrement d’appel côté serveur disponible
• Transcriptions disponibles depuis l’API OpenAI
• Utilisez ElevenLabs SIP si des enregistrements sont requis

Provisionnement au niveau du projet #

• La configuration s’applique à l’ensemble du projet OpenAI
• Tous les numéros de téléphone partagent les mêmes paramètres
• Contrôle moins granulaire qu’avec ElevenLabs

Prérequis #

Éléments requis #

• Compte OpenAI avec accès API
• ID de projet OpenAI
• Clé API OpenAI avec les permissions appropriées
• Numéro de téléphone d’un fournisseur SIP
• Compte VoxPria avec les fonctionnalités SIP activées

Obtenir les identifiants OpenAI #

1. Connectez-vous à la plateforme OpenAI
2. Accédez à Paramètres → Organisation
3. Créez ou sélectionnez un Projet
4. Notez votre ID de projet (dans les paramètres du projet)
5. Générez une clé API avec les permissions de l’API Realtime
6. Copiez les deux valeurs pour les utiliser dans VoxPria

Configuration étape par étape #

1. Configurer le webhook dans la plateforme OpenAI #

OpenAI nécessite un point de terminaison webhook pour notifier VoxPria des appels entrants.

Obtenir votre URL de webhook :

Votre URL de webhook unique est :

`

https://your-voxpria-domain.com/api/v1/sip/openai/webhook

`
Configurer dans OpenAI :

1. Allez à la plateforme OpenAI
2. Accédez à Paramètres du projet
3. Trouvez la section Realtime API ou Webhooks
4. Ajoutez un nouveau point de terminaison webhook
5. Entrez votre URL de webhook VoxPria
6. Sélectionnez les types d’événements : call.started, call.ended, call.updated
7. Enregistrez le secret du webhook – vous en aurez besoin pour VoxPria

2. Créer un trunk SIP OpenAI dans VoxPria #

Configurez la connexion à l’infrastructure SIP d’OpenAI.

1. Dans VoxPria, accédez à Numéros de téléphone → Trunks SIP
2. Cliquez sur Créer un trunk
3. Sélectionnez OpenAI comme type de fournisseur
4. Remplissez les détails du trunk :

Nom du trunk

• Nom descriptif comme « Trunk de production OpenAI »
• Aide à identifier lors de la gestion de plusieurs trunks

ID de projet OpenAI

• Collez votre ID de projet depuis la plateforme OpenAI
• Format : proj_xxxxxxxxxxxxxxxxxxxxx

Clé API OpenAI

• Collez votre clé API avec les permissions Realtime
• Format : sk-proj-xxxxxxxxxxxxxxxxxxxxx
• Gardez-la sécurisée – affichée seulement lors de la création

Secret du webhook

• Collez le secret du webhook provenant d’OpenAI
• Utilisé pour vérifier les requêtes webhook entrantes
• Essentiel pour la sécurité – voir la section sécurité ci-dessous

Serveur SIP

• Préconfiguré pour l’infrastructure d’OpenAI
• Aucun changement nécessaire

1. Cliquez sur Créer un trunk pour enregistrer

3. Importer des numéros de téléphone #

Ajoutez les numéros de téléphone de votre fournisseur SIP.

1. Allez à Numéros de téléphone dans VoxPria
2. Cliquez sur Importer un numéro
3. Entrez le numéro au format E.164 (p. ex. +12125551234)
4. Sélectionnez votre trunk OpenAI
5. Choisissez OpenAI comme moteur
6. Cliquez sur Importer

Notes importantes :

• Le numéro doit exister chez votre fournisseur SIP
• Le fournisseur doit acheminer les appels vers les points de terminaison SIP d’OpenAI
• Vérifiez auprès de votre fournisseur pour la configuration de l’acheminement

4. Provisionner votre projet OpenAI #

Contrairement à ElevenLabs, OpenAI nécessite un provisionnement au niveau du projet.

1. Dans VoxPria, allez à Trunks SIP
2. Trouvez votre trunk OpenAI
3. Cliquez sur Provisionner le projet
4. Attendez que le provisionnement se termine
5. Tous les numéros de téléphone de ce trunk sont maintenant actifs

Note : Ceci provisionne l’ensemble de votre projet OpenAI. Tout numéro supplémentaire importé plus tard utilisera automatiquement cette configuration.

5. Configurer votre fournisseur SIP #

Votre fournisseur SIP doit acheminer les appels vers les points de terminaison d’OpenAI.

Configuration typique :

1. Connectez-vous au tableau de bord de votre fournisseur SIP
2. Trouvez les paramètres d’acheminement de votre numéro de téléphone
3. Définissez la destination au domaine SIP d’OpenAI
4. Configurez l’authentification si nécessaire
5. Définissez le transport à TLS (recommandé)
6. Enregistrez la configuration

Consultez votre fournisseur :

Chaque fournisseur SIP possède des interfaces de configuration différentes. Les fournisseurs courants incluent :

• Twilio
• Telnyx
• Bandwidth
• Vonage

Consultez leur documentation pour les instructions de configuration d’acheminement spécifiques.

6. Assigner des agents naturels #

Connectez les numéros de téléphone à des agents compatibles.

1. Modifiez votre numéro de téléphone dans VoxPria
2. Sélectionnez un agent de type Naturel dans le menu déroulant
3. Important : Seuls les agents naturels/conversationnels fonctionnent avec OpenAI SIP
4. Configurez les paramètres facultatifs :

• Premier message – Salutation initiale
• Durée maximale – Limite de temps de l’appel
• Langue – Langue de la conversation

1. Cliquez sur Enregistrer les modifications

7. Tester votre configuration #

Vérifiez l’intégration complète.

Effectuer un appel test :

1. Utilisez votre téléphone mobile pour appeler votre numéro configuré
2. L’appel devrait se connecter via votre fournisseur SIP vers OpenAI
3. VoxPria reçoit le webhook et connecte votre agent
4. Ayez une conversation pour tester la latence et la qualité

Vérifier les journaux d’appels :

1. Accédez aux Journaux d’appels dans VoxPria
2. Trouvez votre appel test
3. Consultez la transcription provenant d’OpenAI
4. Vérifiez la présence de messages d’erreur

Configuration de la sécurité des webhooks #

La sécurité des webhooks est essentielle pour OpenAI SIP. Sans configuration adéquate, des parties non autorisées pourraient déclencher de faux appels.

Pourquoi la sécurité des webhooks est importante #

Sans vérification du secret du webhook :

• Quiconque connaît votre URL de webhook pourrait envoyer de faux événements d’appel
• Accès non autorisé potentiel à vos agents
• Atteinte à la sécurité et préoccupations liées à la confidentialité
• Frais d’utilisation frauduleux

Avec une vérification adéquate :

• Toutes les requêtes webhook sont signées cryptographiquement
• Les signatures invalides sont automatiquement rejetées
• Seules les requêtes OpenAI authentiques sont traitées
• Votre système reste sécurisé

Configurer le secret du webhook #

Lors de la création du trunk :

1. Lors de la création de votre trunk OpenAI, collez le secret du webhook
2. VoxPria le stocke de façon sécurisée
3. Tous les webhooks entrants sont validés à l’aide de HMAC-SHA256
4. Les requêtes invalides retournent un code HTTP 401 non autorisé

Mettre à jour le secret du webhook :

1. Modifiez votre trunk OpenAI dans VoxPria
2. Mettez à jour le champ du secret du webhook
3. Cliquez sur Enregistrer les modifications
4. Reprovisionnez le projet pour appliquer les changements

Vérifier la sécurité #

Tester la sécurité :

1. Essayez d’appeler sans secret configuré (devrait échouer)
2. Configurez le secret et testez à nouveau (devrait réussir)
3. Changez le secret dans OpenAI mais pas dans VoxPria (devrait échouer)
4. Mettez à jour VoxPria pour qu’il corresponde (devrait réussir)

Configuration avancée #

Options de gestion des appels #

Configurez comment vos agents gèrent les appels entrants.

Durée maximale d’appel :

• Définie en secondes (par défaut : 3600 = 1 heure)
• Empêche les appels excessivement longs
• Configurable par numéro de téléphone

Paramètres de langue :

• Langue principale de la conversation
• Affecte la précision de la reconnaissance vocale
• À définir selon votre public cible

Premier message :

• Salutation personnalisée à la connexion de l’appel
• Maintient un déroulement naturel de la conversation
• Testez différentes salutations pour de meilleurs résultats

Plusieurs numéros de téléphone #

Développez votre configuration OpenAI SIP avec plusieurs numéros.

Tous les numéros partagent la configuration :

• Provisionnement unique au niveau du projet
• Même point de terminaison webhook
• Identifiants API partagés
• Comportement d’agent cohérent

Différenciation :

• Assignez différents agents à différents numéros
• Utilisez des premiers messages personnalisés par numéro
• Configurez différentes durées maximales
• Suivez l’utilisation par numéro dans les journaux

Intégration API #

Gérez de façon programmatique les configurations OpenAI SIP.

Créer un trunk via l’API :
`bash

curl -X POST https://api.voxpria.com/v1/sip/trunks

-H « Authorization: Bearer YOUR_API_KEY »

-H « Content-Type: application/json »

-d ‘{

« name »: « My OpenAI Trunk »,

« provider »: « openai »,

« credentials »: {

« project_id »: « proj_xxxxxxxxxxxxx »,

« api_key »: « sk-proj-xxxxxxxxxxxxx »,

« webhook_secret »: « whsec_xxxxxxxxxxxxx »

}

}’

`
Importer un numéro via l’API :
`bash

curl -X POST https://api.voxpria.com/v1/phone-numbers/import

-H « Authorization: Bearer YOUR_API_KEY »

-H « Content-Type: application/json »

-d ‘{

« phone_number »: « +12125551234 »,

« trunk_id »: « trunk_abc123 »,

« engine »: « openai »,

« agent_id »: « agent_def456 »

}’

`

Dépannage #

Le webhook ne reçoit pas d’événements #

Symptômes : Les appels ne déclenchent pas VoxPria, aucune connexion à l’agent
Solutions :

• Vérifiez que l’URL du webhook est accessible publiquement (pas localhost)
• Vérifiez que le secret du webhook correspond entre OpenAI et VoxPria
• Assurez-vous que le certificat SSL est valide sur votre domaine
• Consultez les journaux de livraison des webhooks de la plateforme OpenAI
• Vérifiez que le pare-feu autorise le trafic HTTPS entrant

L’agent ne répond pas #

Symptômes : L’appel se connecte mais l’agent ne parle pas
Solutions :

• Confirmez que le type d’agent est « Naturel » (pas structuré ou flux de travail)
• Vérifiez que l’agent a une consigne système (system prompt) valide configurée
• Vérifiez que la clé API OpenAI a les permissions de l’API Realtime
• Consultez les journaux d’appels pour des messages d’erreur précis
• Testez d’abord l’agent dans l’interface VoxPria

Problèmes d’acheminement du fournisseur SIP #

Symptômes : Les appels échouent avant d’atteindre OpenAI
Solutions :

• Vérifiez que le fournisseur achemine les appels vers les points de terminaison SIP d’OpenAI
• Vérifiez les identifiants d’authentification avec le fournisseur
• Assurez-vous que les paramètres de transport correspondent (TLS préféré)
• Consultez les journaux d’appels du fournisseur pour les motifs de rejet
• Contactez le soutien du fournisseur pour vérifier l’acheminement

Échec de la validation de la signature du webhook #

Symptômes : Erreurs HTTP 401 dans les journaux webhook d’OpenAI
Solutions :

• Vérifiez que le secret du webhook correspond exactement au secret généré par OpenAI
• Vérifiez la présence d’espaces ou de caractères supplémentaires lors de la copie
• Régénérez le secret du webhook dans OpenAI si nécessaire
• Mettez à jour le trunk VoxPria avec le nouveau secret
• Reprovisionnez le projet après la mise à jour

Mauvaise qualité audio #

Symptômes : Audio saccadé, décalage ou interruptions de connexion
Solutions :

• Vérifiez que votre fournisseur SIP prend en charge WebRTC
• Vérifiez la qualité du réseau du côté de l’appelant
• Testez depuis différents emplacements/réseaux
• Consultez la page d’état d’OpenAI pour des problèmes de service
• Envisagez de passer à ElevenLabs si les problèmes persistent

Déconnexions prématurées des appels #

Symptômes : Les appels se terminent de façon inattendue en cours de conversation
Solutions :

• Vérifiez que le paramètre de durée maximale n’est pas trop court
• Vérifiez que les crédits API OpenAI sont suffisants
• Consultez les journaux d’appels pour le motif de déconnexion
• Testez avec des consignes d’agent plus simples
• Surveillez le tableau de bord d’utilisation de l’API OpenAI

Considérations de coûts #

Tarification OpenAI #

• API GPT-4o Realtime – Tarification audio à la seconde
• Coûts des requêtes API – Facturés à la minute de conversation
• Livraison des webhooks – Habituellement incluse dans la tarification API
• Consultez la tarification d’OpenAI pour les taux actuels

Coûts du fournisseur SIP #

• Location de numéro de téléphone – Frais mensuels variant selon le fournisseur et le pays
• Minutes entrantes – Frais à la minute pour les appels entrants
• Frais de configuration – Coûts d’activation ponctuels du fournisseur

Frais VoxPria #

• Accès à la fonctionnalité SIP – Inclus dans les forfaits admissibles
• Aucun frais par appel – VoxPria ne facture pas l’utilisation SIP
• Utilisation de l’agent – Les frais standards d’interaction avec l’agent s’appliquent

Meilleures pratiques #

Sécurité #

• Configurez toujours le secret du webhook – Ne sautez jamais cette étape
• Utilisez des secrets forts et uniques pour chaque environnement
• Faites régulièrement la rotation des clés API et des secrets
• Surveillez les journaux de webhook pour une activité suspecte
• Activez la liste blanche d’IP si le fournisseur le permet

Performance #

• Gardez les consignes d’agent concises pour des réponses plus rapides
• Testez minutieusement avant le déploiement en production
• Surveillez régulièrement les indicateurs de qualité des appels
• Utilisez les journaux d’appels de VoxPria pour repérer les problèmes tôt

Fiabilité #

• Mettez en place une surveillance de l’état du point de terminaison webhook
• Configurez des alertes pour les livraisons de webhook échouées
• Gardez l’acheminement du fournisseur SIP à jour
• Testez périodiquement les procédures de basculement
• Maintenez une documentation de la configuration actuelle

Conception des agents #

• Utilisez des consignes naturelles et conversationnelles
• Évitez les flux de travail structurés complexes
• Testez les conversations de façon exhaustive
• Optimisez pour les forces de GPT-4o
• Gardez le contexte concis pour une meilleure performance

Comparaison : OpenAI vs ElevenLabs #

Utilisez OpenAI SIP quand : #

• Vous avez besoin de réponses à latence ultra-faible
• Les capacités de GPT-4o Realtime sont essentielles
• Seuls les appels entrants sont requis
• Les transcriptions suffisent (aucun enregistrement nécessaire)
• Le budget permet des coûts API premium

Utilisez ElevenLabs SIP quand : #

• Vous avez besoin de capacités d’appels sortants
• Des campagnes vocales sont requises
• Les enregistrements d’appels sont essentiels
• Vous devez prendre en charge tous les types d’agents
• L’optimisation des coûts est importante

Prochaines étapes #

• Consultez la référence de l’API pour le contrôle programmatique
• Étudiez le guide de dépannage pour les problèmes courants
• Consultez les meilleures pratiques de sécurité pour le renforcement
• Explorez la FAQ pour des informations supplémentaires

Ressources supplémentaires #

• Documentation de l’API Realtime d’OpenAI
• Documentation de l’API VoxPria
• Guide de sécurité des webhooks
• Aperçu du protocole SIP

Besoin d’aide avec la configuration d’OpenAI SIP? Contactez le soutien VoxPria pour une assistance experte.