Een webhook-integratie instellen

Wildix kan gebeurtenissen over gesprekken, aanwezigheid en transcripties naar je eigen systeem sturen. Wat er uit gaat, en wat je endpoint moet kunnen.

Wildix kan gebeurtenissen over gesprekken, aanwezigheid en transcripties naar je eigen systeem sturen. Wat er uit gaat, en wat je endpoint moet kunnen.

Waar een webhook voor is

Een webhook laat iets gebeuren zonder dat er iemand naar een scherm kijkt: gesprekken wegschrijven in een registratiesysteem, een proces starten, een dashboard bijwerken. Wil je juist dat er een pagina opent voor de medewerker zodra de telefoon gaat, dan is dat een popup URL, en dat is aanzienlijk minder werk.

Controleer eerst Cloud Analytics

Webhooks steunen op Cloud Analytics, aan te zetten onder PBX > Features. Op een cloudsysteem staat het standaard aan, dus meestal zit het goed, maar het is het eerste om naar te kijken als er nooit iets binnenkomt.

Zo stel je het in

Ga in WMS naar PBX > Integrations > Cloud integrations, klik op Webhook integration en daarna op Add new integration. Kies hoe de gebeurtenissen worden verstuurd: rechtstreeks naar een URL van jou, of naar een AWS SQS-wachtrij als je liever een wachtrij ertussen hebt.

Vul het adres in en kies welke gebeurtenissen je wilt. Er wordt een Secret voor je gegenereerd, die je niet kunt wijzigen.

Er staat er misschien al een

Integrations Hub aanzetten voegt vanzelf een webhookintegratie toe. Een lijst waar al iets in staat is dus niet per se het werk van een collega, en hem weggooien om schoon te beginnen kan iets meenemen waar de hub op leunt. Kijk waar hij naartoe wijst voordat je eraan komt.

Waarop je je kunt abonneren

• Gespreksgebeurtenissen, met de gespreksgegevens inclusief adressen en poorten, locatie waar die bekend is, en het starten, pauzeren, hervatten en stoppen van opnames.
• Aanwezigheidsgebeurtenissen, zowel de eigen status van de gebruiker als de telefoniestatus: geregistreerd, rinkelend, in gesprek, of in gesprek terwijl er een tweede oproep binnenkomt.
• Analytics-gebeurtenissen, en dat is de interessante. Zodra een transcriptie of een samenvatting klaar is, kan de volledige tekst naar je toe.
• Gebeurtenissen voor conferenties, chat, SMS en WhatsApp.

Binnen elk type kies je losse gebeurtenissen in plaats van alles, en dat is de moeite waard: een druk systeem produceert er heel veel.

Wat jouw endpoint moet kunnen

• Bereikbaar zijn vanaf internet, via HTTPS met een geldig certificaat
• POST-verzoeken met een JSON-body accepteren
• Antwoorden met een 2xx-status, en snel: na vijf seconden verloopt het antwoord
• Ertegen kunnen dat dezelfde gebeurtenis vaker binnenkomt. Een mislukking wordt tot drie keer opnieuw geprobeerd, dus alles wat een record wegschrijft moet met dubbelingen omgaan
• De header x-signature controleren voordat je de inhoud vertrouwt. Het endpoint is openbaar, en dit is het bewijs dat de gebeurtenis van je eigen telefonie komt

Die vijf seconden zijn het waard om je ontwerp op te baseren. Neem de gebeurtenis aan, zet hem op een wachtrij, antwoord meteen, en doe het werk daarna.

Zien wat er werkelijk uitging

Onder Cloud integrations > Webhook zit in het blok Activity de knop View Traces. Open daar een webhook-ID en je leest de gebeurtenis zoals hij is verstuurd. Dat beslecht de gebruikelijke discussie of de telefooncentrale iets heeft gestuurd of dat de ontvangende kant het heeft laten vallen.

Het nummer laten matchen

Nummers komen in internationale notatie binnen. Slaat je database ze lokaal op, normaliseer dan voor je gaat matchen, anders wordt er nooit iets gevonden. De koppeling lijkt dan niet te werken, terwijl hij correct matcht op een notatie die je database niet gebruikt.

Weet je niet of je een webhook of een popup URL wilt, beschrijf dan wat er moet gebeuren, dan zeggen wij welke past.

Zie ook

• Welke integraties zijn beschikbaar