Webhooks
Prévenir automatiquement un de vos logiciels quand un événement se produit sur votre central.
Réservé aux administrateurs
Propriétaires et administrateurs du compte, ou membres de niveau Admin sur Magic IP.
Réservé à l'offre Premium
Les webhooks sont disponibles avec une licence Premium ou Pro+. Sans elle, l'écran propose Mettre à niveau : voir Abonnement et licences.
Un webhook envoie une requête web à l'adresse de votre choix dès qu'un événement se produit : un appel commence, un appel se termine, un fax arrive. Votre logiciel (CRM, outil interne, automatisation) reçoit l'information en temps réel, sans rien interroger.
Deux chemins mènent au même écran : Magic IP › Configuration › Modules › Webhook ou Magic IP › Configuration › Paramètres Généraux › Webhooks.
Pour qui ?
Un webhook s'adresse à la personne qui gère le logiciel destinataire. Elle doit vous fournir l'URL à appeler et vous dire quel événement l'intéresse.
Ajouter un webhook
Cliquez sur Ajouter. Le panneau Ajouter un webhook s'ouvre.
Saisissez un Nom, par exemple « CRM Integration ».
Choisissez le Déclencheur : l'événement qui envoie la requête (voir le tableau).
Saisissez l'URL fournie par votre logiciel, 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.
Si votre logiciel l'exige, ajoutez des Données personnalisées (optionnel) : cliquez sur Ajouter une donnée, puis renseignez la Clé et la Valeur. Elles sont jointes à chaque envoi, par exemple pour identifier votre compte.
Cliquez sur Enregistrer.
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é. |
Gérer vos webhooks
- L'interrupteur de la colonne Activé coupe ou relance un webhook sans le supprimer.
- Cliquez sur un webhook pour le modifier dans Modifier le webhook.
API publique
Vous développez votre propre intégration ? L'API publique de la plateforme permet aussi de recevoir les événements d'appels par webhook, avec un jeton d'accès. La documentation est sur interfone.be/developpeurs.