Documentation pour les développeursSIP
Introduction
Bienvenue au service de téléphonie SIP de Speaqr. Notre serveur SIP te permet de passer des appels téléphoniques avec traduction en temps réel, brisant les barrières linguistiques dans les communications téléphoniques.Le service utilise la technologie SIP sur TLS pour garantir des communications sécurisées, ainsi que SRTP pour le chiffrement audio et le codec μ-law (PCMU) pour une compatibilité universelle avec les systèmes de téléphonie.Avec notre service SIP, tu pourras intégrer les capacités de traduction de Speaqr directement dans ton standard, softphone ou tout système compatible avec SIP, permettant des appels multilingues sans besoin d'interprètes physiques.Pour utiliser le service SIP tu as besoin de justificatifs d'accès valides. Pour les obtenir, contacte-nous via le formulaire de souscription.Conditions préalables
Avant de configurer ton client SIP, assure-toi de remplir les conditions suivantes :Client SIP compatible
Ton client SIP doit prendre en charge le SIP sur TLS pour une signalisation sécurisée, le SRTP (SDES) pour le chiffrement audio et le codec μ-law (PCMU) qui est obligatoire pour la compatibilité avec le service.Exemples de clients compatibles : Tout softphone ou standard prenant en charge PJSIP.Références d'accès
Tu recevras un nom d'utilisateur (par exemple, nouveau-utilisateur), un mot de passe et le domaine du serveur :sip.speaqr.ai.Connexion au réseau
Assure-toi que les ports 5061/TCP (pour TLS) et 10000-20000/UDP (pour SRTP) sont ouverts sur ton réseau ou pare-feu.Certificats TLS
Tu n'as pas besoin de générer des certificats supplémentaires. Notre serveur utilise un certificat TLS valide. Assure-toi que ton client accepte les certificats de confiance standard.Configuration du client
Configure ton softphone ou standard pour se connecter àsip.speaqr.ai avec les paramètres suivants :Données du compte
• Nom d'utilisateur : nouveau-utilisateur (fourni par l'administrateur)• Mot de passe : Ton mot de passe fourni
• Domaine/Serveur :
sip.speaqr.ai:5061Configuration du protocole
• Transport : TLS• Port : 5061
• Chiffrement des médias : SRTP (SDES)
• Codecs : Activez uniquement PCMU (μ-law) ; désactivez les autres codecs
Options de réseau
• Enregistrer sur le serveur : Active l'option d'enregistrement (REGISTER)• STUN (si tu es derrière un NAT) : Utilise un serveur STUN comme
stun.l.google.com:19302En-têtes SIP personnalisés
Configure la capacité d'envoyer des en-têtes SIP personnalisés (consulte la documentation de ton client pour les ajouter).Exemple :X-Origin: nouveau-utilisateur, X-Destination: destinationServices disponibles
Le serveur propose deux services via l'application ARI loopback. Utilisez les méthodes suivantes pour interagir avec eux :Service de bouclage
Envoyez l'audio au serveur et recevez l'audio traité (intervenu) par Speaqr.Comment l'utiliser
Marque l'extensionloopback dans ton client SIP.En-têtes SIP requis
•X-Origin: Ton identifiant (ex. nouveau-utilisateur)•
X-Destination: Un identifiant pour la destination (peut être toute valeur pertinente, ex. test)Comportement
Le serveur répond à l'audio traité par l'application Speaqr, basé sur ton email (obtenu depuis la base de données) et les en-têtes.Service d'appel
Passez un appel à un numéro de téléphone physique, avec l'audio intercepté par Speaqr.Comment l'utiliser
Compose l'extensioncall sur ton client SIP.En-têtes SIP requis
•X-Origin : Ton identifiant (ex. nouveau-utilisateur)•
X-Destination : Le numéro de téléphone physique que tu souhaites appeler (format international, ex. +1234567890)•
X-Dial : Optionnel, pour spécifier un numéro ou une destination supplémentaire (ex. +1234567890)Comportement
L'appel se connecte au numéro spécifié, avec l'audio traité par Speaqr.Dépannage
Si tu rencontres des difficultés lors de la configuration ou de l'utilisation du service SIP, consulte les solutions suivantes :Le compte ne s'enregistre pas
• Vérifie que le nom d'utilisateur, le mot de passe et le port (5061/TLS) sont corrects• Assure-toi que le pare-feu autorise le port 5061/TCP
• Si tu es derrière un NAT, activez STUN ou contacte l'administrateur
Pas d'audio
• Confirme que SRTP est activé et que les ports RTP (10000-20000/UDP) sont ouverts• Assure-toi que seul PCMU est activé comme codec
Erreur lors de l'utilisation des services loopback ou call
• Vérifie que les en-têtes X-Origin et X-Destination sont correctement configurés• Assure-toi que ton compte est enregistré avant de composer
• Contacte l'administrateur si l'application ARI ne répond pas
Ce site web utilise des cookies
Les cookies de ce site web sont utilisées pour personnaliser le contenu et analyser le trafic.
Tu pouvez trouver les détails de celles-ci dans la section Politique de confidentialité