Webhooks
Een van uw softwarepakketten automatisch verwittigen wanneer er iets gebeurt op uw centrale.
Alleen voor beheerders
Eigenaars en beheerders van het account, of leden met niveau Admin op Magic IP.
Alleen met het Premium-abonnement
Webhooks zijn beschikbaar met een Premium- of Pro+-licentie. Zonder die licentie biedt het scherm Upgraden aan: zie Abonnement en licenties.
Een webhook stuurt een webverzoek naar het adres van uw keuze zodra er een gebeurtenis plaatsvindt: een oproep begint, een oproep eindigt, er komt een fax binnen. Uw software (CRM, interne tool, automatisering) krijgt de informatie in realtime, zonder zelf iets op te vragen.
Twee wegen leiden naar hetzelfde scherm: Magic IP › Configuratie › Modules › Webhook of Magic IP › Configuratie › Algemene Instellingen › Webhooks.
Voor wie?
Een webhook is bedoeld voor wie de ontvangende software beheert. Die persoon moet u de URL bezorgen en zeggen in welke gebeurtenis hij geïnteresseerd is.
Een webhook toevoegen
Klik op Toevoegen. Het paneel Webhook toevoegen wordt geopend.
Vul een Naam in, bijvoorbeeld "CRM Integration".
Kies de Trigger: de gebeurtenis die het verzoek verstuurt (zie de tabel).
Vul de URL in die uw software u bezorgt, met https://.
Kies het Type verzoek (GET, POST of PUT) en het aantal Nieuwe pogingen (1 tot 5) als uw software niet antwoordt.
Vereist uw software het, voeg dan Aangepaste gegevens (optioneel) toe: klik op Gegevens toevoegen en vul de Sleutel en de Waarde in. Ze worden bij elke verzending meegestuurd, bijvoorbeeld om uw account te identificeren.
Klik op Opslaan.
De triggers
| Trigger | Verzonden wanneer |
|---|---|
| Oproep aangemaakt | Een oproep begint (het toestel rinkelt). |
| Oproep beantwoord | Iemand neemt op. |
| Oproep gekoppeld | Twee gesprekspartners worden met elkaar verbonden. |
| Einde oproep | De oproep eindigt. |
| CDR (oproeplogboek) | Het detail van de beëindigde oproep is beschikbaar. |
| Parking | Een oproep wordt geparkeerd of opnieuw opgenomen. |
| Inkomende fax / Uitgaande fax | Een fax wordt ontvangen of verzonden. |
| Meldingen | De centrale verstuurt een systeemmelding. |
| Object (aanmaken/wijzigen/verwijderen) | Een element van de configuratie wordt aangemaakt, gewijzigd of verwijderd. |
Uw webhooks beheren
- De schakelaar in de kolom Ingeschakeld zet een webhook uit of weer aan zonder hem te verwijderen.
- Klik op een webhook om hem te wijzigen in Webhook bewerken.
Publieke API
Ontwikkelt u uw eigen integratie? Via de publieke API van het platform kunt u de oproepgebeurtenissen ook per webhook ontvangen, met een toegangstoken. De documentatie staat op interfone.be/developpeurs.