topic Webex Calling Webhook Determine telephony_calls Event Types in Webex for Developers

Webex Calling Webhook Determine telephony_calls Event Types

shdr — Thu, 21 Nov 2024 10:02:28 GMT

I’m working with Webex webhooks and I'm trying to identify the event type for telephony_calls. Could anyone provide guidance on how to determine or capture the specific event type related to telephony_calls? Any help or examples would be greatly appreciated!

Thanks in advance!

Re: Webex Calling Webhook Determine telephony_calls Event Types

dtibbe — Thu, 21 Nov 2024 11:56:52 GMT

Have you checked the list at https://developer.webex.com/docs/api/guides/webhooks?

Re: Webex Calling Webhook Determine telephony_calls Event Types

sandiban — Thu, 21 Nov 2024 12:39:27 GMT

Hi @shdr,
With the page link that David already shared in his reply, search for the keyword "telephony_calls" and you'd get the details regarding how to use this resource type while creating a webhook through API.
Basically you can create a Webhook on "telephony_calls" resource for the events - "created", "updated" and "deleted".
Or, even you can keep the event as "all" also which would definitely work for all these 3 types of telephony call events.

Also please make a note, Webex telephony_calls webhook will work only for Webex Calling users. Therefore, you should definitely have Calling license before trying this webhook type.
And one last thing - "telephony_calls" webhook resource doesn't work under Org level.
So, you can't specify the "owned_by" value as "Org" while trying to create the Webhook from here - https://developer.webex.com/docs/api/v1/webhooks/create-a-webhook

Hope this helps!
In case of any further queries, please let us know.

Regards!
Sandip

Re: Webex Calling Webhook Determine telephony_calls Event Types

shdr — Sun, 24 Nov 2024 12:01:26 GMT

Thanks for the helpful response, dtibbe, Sandip!

To clarify further, I understand that the "telephony_calls" resource can be used with events like "created", "updated", and "deleted", each corresponding to specific call states:

Created: Triggered when a call is started (originated) or received. Filters include personality, state, address, personId, and callType.
Updated: Triggered when a call is updated (e.g., answered, forwarded, resumed). Filters include the same options as "created".
Deleted: Triggered when a call is disconnected (deleted). Similarly, the same filters are applicable.

However, I noticed that for the "updated" event type, I did not receive a disconnected state in the data returned. This raises some questions:

How do the "created", "updated", and "deleted" events align with the specific eventType values (e.g., 'answered', 'disconnected', etc.) in the data returned?
If I want to capture specific events like "answered" and "disconnected" with minimal parsing, which event should I register for?
Is there any detailed documentation explaining the relationship between these event options, the filters, and the data returned?

Thank you again for your assistance—this is helping a lot!

Re: Webex Calling Webhook Determine telephony_calls Event Types

shdr — Sun, 24 Nov 2024 11:10:40 GMT

Sorry but I didn't get disconnected on update updated event like the documentation say.

Re: Webex Calling Webhook Determine telephony_calls Event Types

sandiban — Mon, 25 Nov 2024 11:42:58 GMT

Hello @shdr,
Could you kindly extend the discussion over devsupport@webex.com for further analysis.
You can send a email on this provided ID with the Webhook details that you created and also kindly share the callId that didn't work expectedly.
We'll look at it further.
Tracking the queries over here would be little tough.

Regards!
Sandip