Comment intégrer le Webphone Bitcall à votre site web ou à votre CRM
Comment intégrer le Webphone Bitcall à votre site web ou à votre CRM
Ajoutez un téléphone SIP/WebRTC complet à votre site web, votre SaaS ou votre CRM en quelques lignes de code.
De quoi s’agit-il
Le Webphone Bitcall peut être intégré sous forme de widget ou d’élément autonome. Vos agents ou utilisateurs peuvent ainsi :
passer des appels directement depuis votre tableau de bord ;
activer le « Click-to-Call » sur n’importe quel numéro de votre site ;
enregistrer les appels et les consigner directement dans votre base CRM grâce aux événements.
Ce dont vous aurez besoin
Un compte Bitcall actif.
Votre clé API (dans Settings -> API).
Un site web avec accès au
<head>ou au<body>HTML.
Intégration pas à pas
Étape 1 : ajouter le script
Incluez le script de chargement Bitcall dans votre HTML :
<script src="/webphone/loader.js"></script>Étape 2 : initialiser le téléphone
Ajoutez ce fragment JavaScript à votre page (généralement avant la balise de fermeture </body>) :
BitcallWebphone.init({
key: 'YOUR_API_KEY',
sip: {
username: 'agent_name',
domain: 'gateway.bitcall.io'
},
interceptTelLinks: true,
phoneSelectors: ['.phone-link']
});Champs de configuration :
key : votre clé API Bitcall unique.
sip.username : le nom d’utilisateur de l’agent (facultatif, pour le pré-remplissage).
interceptTelLinks : transforme automatiquement les liens
tel:en appels Bitcall.phoneSelectors : une liste de classes CSS que le téléphone surveille pour le « Click-to-Call ».
Événements disponibles pour les développeurs
Vous pouvez écouter ces événements pour synchroniser les données d’appel avec votre CRM :
callStarted : déclenché quand l’agent lance l’appel.
callIncoming : déclenché à l’arrivée d’un nouvel appel.
callAnswered : déclenché au début de la conversation.
callEnded : déclenché à la fin de l’appel (inclut la durée).
registered : confirme que le téléphone est prêt.
Exemple de code :
BitcallWebphone.on('callEnded', (data) => {
console.log("Call with " + data.number + " lasted " + data.duration + " seconds.");
// Save this to your CRM via AJAX here
});Fonctions avancées incluses
Plusieurs appels simultanés : gérez deux appels ou plus à la fois (permutation / fusion).
Enregistrement des appels : démarrez ou arrêtez l’enregistrement depuis l’interface ou l’API.
Lecture audio : diffusez des extraits préenregistrés pendant l’appel.
Tonalités DTMF : envoyez des tonalités pour naviguer dans des menus vocaux externes (SVI).
Support PWA : permettez aux utilisateurs d’« installer » le téléphone intégré comme une application autonome.
Mode fenêtre détachée : les utilisateurs peuvent ouvrir le téléphone dans une fenêtre séparée pour qu’il ne se ferme pas quand ils naviguent sur votre site.
Sécurité et bonnes pratiques
Origines autorisées : dans votre panel Bitcall, ajoutez à la liste blanche les domaines où le téléphone est autorisé à fonctionner.
Clés API : ne partagez jamais votre clé API Admin. Utilisez une clé client restreinte si possible.
Support mobile : le téléphone intégré fonctionne mieux sur les navigateurs récents. Assurez-vous que votre site utilise HTTPS, car les navigateurs bloquent l’accès à la caméra et au micro en HTTP.
Résultat attendu
Un widget téléphonique permanent apparaît sur votre site. Un clic sur n’importe quel numéro dans votre CRM déclenche automatiquement un appel via Bitcall, sans que l’agent quitte la page.
Pas d'article précédent
Comment utiliser le Webphone Bitcall dans votre navigateur
Sur cette page
Besoin d’aide supplémentaire ?
Vous ne trouvez pas ce que vous cherchez ? Notre équipe support est là pour vous aider.
Contactez-nous