Een gesprek starten, beëindigen of doorschakelen via de We Are Voip APIv2

Via het API endpoint /action/conversation kan je een nieuw gesprek starten, een aan-de-gang-zijnde gesprek beëindigen, een gesprek doorschakelen, of een lijst van aan-de-gang-zijnde gesprekken bekomen.

Om een gesprek te starten maak je een POST request naar het endpoint :

curl -X POST -H "Authorization : Bearer <jwtToken>"-H "Content-Type: application/json" -d "{"myCall":{"origin":471,"destination":"0470123456"}}" https://pbxonline.be/api/v2/x.x/action/conversation

waarbij de parameter “origin” het ID is van een SIP-account, en de parameter “destination” het telefoonnummer dat moet worden gebeld.

Dit is een click-to-dial opzet, wat inhoudt dat eerst de SIP-client (telefoontoestel of softphone of…) gaat rinkelen (origin) en bij aannemen wordt deze SIP-client verbonden met het te bellen telefoonnummer (destination).

Om een gesprek te beëindigen maak je een DELETE request naar het endpoint :

curl -X DELETE -H "Authorization : Bearer <jwtToken>"-H "Content-Type: application/json" -d "{"ID":2719}" https://pbxonline.be/api/v2/x.x/action/conversation

waarbij de parameter “ID” het ID is van een aan-de-gang-zijnde gesprek.

Om een gesprek door te schakelen maak je een PUT request naar het endpoint :

curl -X PUT -H "Authorization : Bearer <jwtToken>" -H "Content-Type: application/json" -d "{"2719":{"destination":6}}" https://pbxonline.be/api/v2/x.x/action/conversation

waarbij je als key het ID van een aan-de-gang-zijnde conversatie opgeeft (hier:2719) en als parameter “destination” de extensie waarnaar moet worden doorgeschakeld.