Intégrer le téléphone dans votre logiciel

Ce que fait l’intégration

Avant de commencer

• Un compte Callizy avec un abonnement actif, et un utilisateur Callizy pour chaque personne qui appellera.
• Accès au code de votre site ou de votre logiciel web.

1. 1

   Dans le portail développeurs

   Créez votre compte développeur

   2 min

   Sur callizy.ca/fr/developers, cliquez Créer un compte : votre courriel et un mot de passe, ou Google. Confirmez votre courriel, puis remplissez Complétez votre profil.

2. 2

   Créez une application

   1 min

   Dans Apps, cliquez Créer une app. Nom de l’application : par exemple « Mon CRM ». Origines autorisées (CORS) : l’adresse de votre logiciel, par exemple https://monapp.com ; séparez-en plusieurs par une virgule. Laissez la Redirect URI telle quelle, puis Créer une app.

3. 3

   Copiez la clé

   10 s

   Sur la carte de l’application, cliquez l’ID : le client_id est copié. C’est la clé d’intégration du widget.

4. 4

   Dans votre logiciel

   Ajoutez le script

   1 min

   Collez ces deux balises avant la fin de la page, juste avant </body>, avec votre client_id. Une bulle apparaît en bas à droite.

   <script src="https://sdk.callizy.ca/v1/widget.js"></script><script>Callizy.init({ clientId: 'VOTRE_CLIENT_ID' });</script>Copier
5. 5

   Connectez un utilisateur

   30 s

   L’utilisateur clique la bulle, puis Connecter Callizy. Il se connecte à Callizy dans la fenêtre qui s’ouvre et autorise votre application. Il peut appeler tout de suite.

6. 6

   Appelez depuis une fiche client

   1 min

   Sur votre bouton d’appel, appelez Callizy.call avec le numéro, puis Callizy.open pour ouvrir le panneau. Lancez-le toujours depuis un clic : le navigateur n’ouvre le micro que sur un geste de l’utilisateur.

   Callizy.call('+15145550123'); Callizy.open();Copier

Les réglages

Ils se changent à tout moment, sans rien reconnecter.

Apparence

Dans Callizy.init : position (bottom-right ou bottom-left), locale (fr ou en), theme (dark ou light), primaryColor pour la couleur de votre marque, offset pour éloigner la bulle du bord.

Votre propre bouton

hideBubble: true masque la bulle ; Callizy.open() ouvre le widget depuis votre bouton.

Onglets

defaultTab choisit l’onglet du départ et disabledTabs masque les autres, parmi dial, history et sms.

Fiche déjà remplie

Callizy.setContext({ phone, name }) remplit le clavier et affiche le nom du client : l’utilisateur n’a plus qu’à appeler.

Durée de la connexion

persistence : session, par défaut, garde la connexion tant que l’onglet est ouvert ; local la garde après la fermeture du navigateur ; none la perd à chaque rechargement.

Événements

Callizy.on écoute call.incoming, call.started, call.ended, sms.sent, sms.received, auth.connected et auth.disconnected. Par exemple, à call.incoming, ouvrez la fiche du client dans votre logiciel.

Ça ne marche pas ?

Questions fréquentes