Comment envoyer vos événements d'appel vers un autre logiciel ?
Votre CRM ou votre outil interne est prévenu en temps réel quand un appel sonne, est décroché ou se termine. Rien à exporter ni à interroger : chaque événement part tout seul vers l'adresse de votre choix.
Réservé aux administrateurs
Cette page se règle par un administrateur du compte, ou par un membre de niveau Admin sur Magic IP.
Un webhook s'adresse à la personne qui gère le logiciel destinataire : elle vous fournit l'adresse à appeler et vous dit quel événement l'intéresse.
Ajouter un webhook
Ouvrez Magic IP › Configuration › Modules, puis la tuile Webhook. La même page s'ouvre aussi depuis la tuile Webhooks des Paramètres Généraux.
Cliquez sur « Ajouter »
La liste montre vos webhooks, leur déclencheur et leurs envois du mois.
Webhooks
Donnez un nom et choisissez le déclencheur
Le Nom sert à le reconnaître dans la liste. Le Déclencheur est l'événement qui envoie la requête : voir le tableau plus bas.
Envoi
Saisissez l'adresse de votre logiciel
Dans URL, collez l'adresse fournie, en https://. Choisissez le Type de requête (GET, POST ou PUT) et le nombre de Tentatives de réessai (1 à 5) si votre logiciel ne répond pas.
Ajoutez des données personnalisées, si besoin
Si votre logiciel l'exige, cliquez sur Ajouter une donnée sous Données personnalisées (optionnel), puis remplissez la Clé et la Valeur. Elles sont jointes à chaque envoi, par exemple pour identifier votre compte.
Cliquez sur « Enregistrer »
Le message Configuration du webhook enregistrée confirme. Le webhook apparaît dans la liste avec le statut Actif.
Les déclencheurs
| Déclencheur | Envoyé quand |
|---|---|
| Création d'appel | Un appel commence (le téléphone sonne). |
| Réponse à l'appel | Quelqu'un décroche. |
| Pont d'appel | Deux interlocuteurs sont mis en relation. |
| Fin d'appel | L'appel se termine. |
| CDR (journal d'appels) | Le détail de l'appel terminé est disponible. |
| Parking | Un appel est mis en parking ou repris. |
| Fax entrant / Fax sortant | Un fax est reçu ou envoyé. |
| Notifications | Le central émet une notification système. |
| Objet (création/modification/suppression) | Un élément de la configuration est créé, modifié ou supprimé. |
Bon à savoir
- Fonction Premium : les webhooks sont ouverts à toutes les licences jusqu'au 31 décembre 2026, puis réservés aux licences Premium ou Pro+.
- Suivre les envois : la colonne Envois du mois compte les envois et signale ceux en échec. L'icône Journal des envois, au bout de la ligne, liste chaque envoi avec son code de réponse ; cliquez sur un envoi pour lire ce que votre logiciel a répondu.
- Suspendre sans supprimer : l'interrupteur au bout de la ligne passe le webhook en Désactivé.
- Modifier ou supprimer : cliquez sur la ligne. Le volet permet de changer les champs puis d'Enregistrer, ou de Supprimer après la confirmation Supprimer ce webhook et son journal ?.
- Vous développez votre propre intégration ? L'API de la plateforme permet aussi de recevoir les événements d'appel, avec un jeton d'accès : voir interfone.be/developpeurs. Pour un simple envoi à la fin de chaque appel sur un numéro, voir aussi Comment déclencher une action à la fin d'un appel ?
Votre logiciel n'a pas répondu ou a refusé les envois trop souvent : le webhook a été coupé. Survolez le badge pour lire la raison, puis regardez dans le Journal des envois ce que votre logiciel a répondu.
Le webhook fonctionne, mais ses envois ne sont ni journalisés ni comptés. Contactez-nous pour le mettre à jour.