# Brancher l'agent sur votre logiciel

L'agent consulte votre logiciel pendant l'appel : dossier, commande, statut.

- Rôle : Gestionnaire
- Durée : 6 min
- Sur : Web, Mac
- Centre d’apprentissage : https://callizy.ca/fr/apprendre/logiciels-connectes
- Ouvrir cet écran dans Callizy : https://app.callizy.ca/fr/manager?view=ai-agents

## Avant de commencer

- Votre agent IA, déjà créé : voir [Créer et tester sa réceptionniste IA](https://callizy.ca/fr/apprendre/creer-sa-receptionniste).
- Un logiciel qui a une API : une adresse en https et une clé. Votre fournisseur ou votre développeur vous les donne.

## Pas à pas

7 étapes, environ 6 min.

### 1. Ouvrez l’onglet (10 s)

Ouvrez votre agent, onglet **Logiciels connectés**. Cliquez **Connecter un logiciel**, puis **Autre logiciel**.

Menu : Administration › Agents IA › votre agent › Logiciels connectés

### 2. Collez l’adresse (1 min)

**Adresse** : l’adresse de votre API. Mettez entre accolades ce que l’agent doit demander, par exemple https://api.monlogiciel.com/commandes/{numero}. {telephone} met le numéro de l’appelant : sans lui dans l’adresse, ce numéro ne part pas.

### 3. Collez la clé (20 s)

**Clé** : la clé donnée par votre logiciel. Elle ne sera plus affichée.

### 4. Dites quand l’utiliser (30 s)

**Quand l’utiliser** : par exemple « Quand l’appelant demande où en est son dossier ou sa commande. ». Ce champ est obligatoire.

### 5. Essayez (1 min)

Sous **Essayer**, entrez un **Numéro de téléphone d’un client** et une valeur pour chaque accolade. Cliquez **Essayer**, en bas : vous voyez **Ce que l’agent recevra**. L’essai interroge vraiment votre logiciel.

### 6. Enregistrez (20 s)

Cliquez **Enregistrer** : « Connexion enregistrée ». La ligne affiche **Utilisé** pour cet agent. Puis cliquez **Mettre à jour**, en haut de la fiche de l’agent.

### 7. Testez (1 min)

Sur la carte de l’agent, **Tester**, puis **Appelez-moi**. Posez votre question : l’agent consulte votre logiciel et répond.

## À retenir

- L’agent consulte votre logiciel seulement dans la situation de **Quand l’utiliser**.
- Il reçoit la réponse de votre logiciel telle quelle : elle ne doit contenir que ce qu’il peut dire à l’appelant.
- Votre logiciel a 5 secondes pour répondre. Sinon, l’agent s’excuse, prend les coordonnées et dit que l’équipe rappelle.
- **Retirer** supprime la connexion pour tous vos agents. Pour un seul agent, éteignez l’interrupteur : **Non utilisé**.

## Les réglages

- **Réglages avancés** : En bas du formulaire, **Réglages avancés** : le nom de l’action, les **Paramètres envoyés**, la phrase **API en panne ou trop lente** et, sous **Réglages techniques**, la **Méthode** et le **Délai (s)**, de 1 à 10.
- **Signature des requêtes (pour les développeurs)** : Callizy signe chaque requête. Pour que votre logiciel le vérifie : **Modifier**, **Réglages avancés**, puis **Créer un secret**, et donnez-le à votre développeur. Il ne sera plus affiché. En créer un nouveau remplace l’ancien.
- **Tester une connexion enregistrée** : Dans la liste, **Tester** : entrez le numéro d’un client, comme si ce client appelait votre agent.

## Ça ne marche pas ?

### Callizy affiche « Essai impossible »

1. Vérifiez l’adresse et la clé.
2. Lisez le **Détail** sous le résultat.

### Callizy affiche « Dites quand l’agent doit consulter l’API. »

1. Remplissez **Quand l’utiliser**.

### Callizy affiche « L’adresse doit commencer par https:// »

1. Votre API doit avoir une adresse sécurisée, en https.

### L’agent ne consulte pas le logiciel

1. La ligne doit afficher **Utilisé**.
2. Cliquez **Mettre à jour**, en haut de la fiche de l’agent.
3. Précisez **Quand l’utiliser**.

### Le logiciel ne reçoit pas le numéro de l’appelant

1. Ajoutez {telephone} dans l’**Adresse**, par exemple ?tel={telephone}.

## Questions fréquentes

### Quels logiciels puis-je brancher ?

Tout logiciel qui a une API en https, avec une clé. Le vôtre n’est pas prêt ? Sous la liste, **Écrivez-nous, on le branche pour vous.**

### L’agent peut-il modifier mes données ?

Au départ, il ne fait que lire. Ne changez la **Méthode** que si votre développeur vous le demande.

### Est-ce inclus dans mon forfait ?

Oui, dans tous les forfaits.

Mis à jour le 29 octobre 2026.