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

Le Widget SDK, pour les éditeurs de logiciels.

- Rôle : Gestionnaire
- Durée : 5 min
- Sur : Web
- Centre d’apprentissage : https://callizy.ca/fr/apprendre/widget-sdk
- Parcours intégrations · Leçon 8
- La page sur callizy.ca : https://callizy.ca/fr/produit/integrations

## Ce que fait l’intégration

Le Widget SDK ajoute un téléphone Callizy dans votre logiciel web : une bulle en bas de l’écran, qui ouvre un clavier, l’historique et les textos. Vos utilisateurs appellent et répondent sans quitter votre logiciel.

Chacun se connecte avec son propre compte Callizy, dans une fenêtre de Callizy. Votre logiciel ne voit jamais son mot de passe, et la page ne contient aucun secret.

## 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.

## Pas à pas

6 étapes, environ 5 min.

**Dans le portail développeurs**

### 1. 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. 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. 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.

**Dans votre logiciel**

### 4. 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>
```

### 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. 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();
```

## À retenir

- Une application par logiciel ; son client_id est la seule clé dans la page.
- Chaque utilisateur se connecte avec son propre compte Callizy.
- Sans Callizy.open(), l’appel part, mais l’utilisateur ne voit que la bulle et n’a pas de bouton pour raccrocher.

## Les réglages

- **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 ?

### Callizy.call() ne fait rien

1. L’utilisateur n’est pas encore connecté : le widget montre l’écran de connexion. Écoutez auth.connected.
2. Lancez l’appel depuis un clic, pas au chargement de la page.

### L’appel part, mais on ne s’entend pas

1. Lancé sans clic, l’appel peut partir sans micro ni son : appelez depuis un bouton.

### La connexion est refusée

1. L’adresse de votre logiciel doit être dans **Origines autorisées (CORS)**, avec https://.
2. L’application est **EN PAUSE** ? Dans son menu, cliquez **Activer**.

### Callizy affiche « L’URI de redirection n’est pas valide. Elle doit commencer par http:// ou https:// »

1. Remettez la valeur par défaut : https://api.callizy.ca/oauth/callback/.

## Questions fréquentes

### Faut-il un serveur ?

Non : deux balises dans la page suffisent. Le widget ne demande aucun secret.

### Le widget peut-il porter ma marque ?

La couleur, oui, avec primaryColor. Pour un téléphone sans aucune trace de Callizy, demandez le widget marque blanche : **Réglages** › **Développeurs**, onglet **Widget marque blanche**, **Demander l’accès**.

### Que se passe-t-il si je supprime l’application ?

Sa clé ne fonctionne plus : le widget ne peut plus connecter personne.

Mis à jour le 29 octobre 2026.