3.8.5.4 URL-gebaseerde gespreksaansturing
Deze functies maken URL-gebaseerde interactie mogelijk en zorgen voor een naadloze integratie met externe software, zoals CRM- en enterprise-systemen. De applicatie ondersteunt twee complementaire mechanismen: het ontvangen van command-URL’s voor externe gespreksaansturing en het verzenden van webhookmeldingen om gespreksgebeurtenissen door te sturen naar externe diensten.
Deze URL-commando’s kunnen ook lokaal op een Mac worden geactiveerd via AppleScript. Hiermee kunnen macOS-gebruikers gesprekken direct starten, beantwoorden of beëindigen via kleine scripts.
Functie | Richting | Doel |
|---|---|---|
URL-commando’s toestaan | Externe applicatie (bijv. CRM) Enreach Contact Desktop Client | Maakt het mogelijk voor externe applicaties om gespreksacties aan te sturen via HTTP-requests. De URL-commando’s moeten exact overeenkomen met het formaat dat door de Enreach Contact Desktop Client wordt verwacht. |
URL-oproepmeldingen | Enreach Contact Desktop Client Externe applicatie (bijv. CRM) | De client informeert automatisch andere applicaties wanneer gesprekken starten, actief worden of eindigen. De geconfigureerde URL’s moeten het formaat volgen dat door de ontvangende externe applicatie wordt vereist, zodat de verwerking correct verloopt. |
Hiermee wordt het mogelijk om gesprekken vanuit andere applicaties aan te sturen en systemen automatisch gesynchroniseerd te houden.
Alle applicaties moeten op dezelfde computer (pc of Mac) draaien.
URL-commando’s toestaan
Met URL-commando’s toestaan kunnen andere systemen gesprekken in de applicatie aansturen door eenvoudige webrequests (URL’s) te versturen.
Wanneer deze optie is ingeschakeld, opent de applicatie een lokale HTTP-listener op de opgegeven poort en wacht deze op inkomende command-URL’s. Deze commando’s kunnen gespreksacties op afstand activeren.
Optie | Uitleg |
|---|---|
Luisterport | De netwerkpoort die de applicatie gebruikt om commando’s te ontvangen. Het externe systeem moet requests naar deze poort sturen. |
Oproep starten | Dit veld definieert het commandosegment dat wordt gebruikt om via een URL-request een uitgaand gesprek te starten. Om een nummer te bellen, stuurt de externe applicatie een HTTP-request naar de listenerpoort, inclusief zowel het commandowoord als het bestemmingsnummer. Voorbeeld: http://localhost:5678/make/020123456 Wanneer deze URL wordt aangeroepen, start de applicatie onmiddellijk met het bellen van 020123456. |
Oproep beantwoorden | Dit veld definieert het commando dat wordt gebruikt om via een URL-request inkomende gesprekken te beantwoorden. Wanneer een gesprek overgaat, kan het externe systeem deze endpoint aanroepen om de applicatie automatisch het gesprek te laten beantwoorden. Voorbeeld: http://localhost:5678/answer Wanneer dit wordt uitgevoerd, beantwoordt de applicatie het huidige inkomende gesprek. |
Oproep beëindigen | URL-pad dat wordt gebruikt om het huidige gesprek te beëindigen. Voorbeeld: http://localhost:5678/end |
URL-oproepmeldingen
Met URL-oproepmeldingen informeert de applicatie automatisch andere systemen wanneer bepaalde gespreksgebeurtenissen plaatsvinden.
Wanneer ingeschakeld, stuurt de applicatie een notificatie (HTTP-request) naar een vooraf gedefinieerde URL. Deze notificaties kunnen informatie bevatten, zoals het nummer van de beller.
Optie | Uitleg |
|---|---|
Inkomende oproep | Stuurt een notificatie wanneer een nieuw gesprek wordt ontvangen. Er wordt een request verstuurd naar de geconfigureerde URL. Voorbeeld: https://example.com/incoming?callerid=$callerid |
Actief oproep | Stuurt een notificatie wanneer een gesprek wordt beantwoord. Voorbeeld: https://example.com/active?callerid=$callerid |
Oproep beëindigen | Stuurt een notificatie wanneer een gesprek wordt beëindigd. Voorbeeld: https://example.com/end?callerid=$callerid |