Scheduled Zoom Phone calls, API for call ID availability

Before Creating a New Topic:

If you’re experiencing unexpected API/Zoom API Events (webhooks) behavior please search the forum with relevant keywords (e.x. error message) and follow the guidance outlined in those posts. Please also leverage the following support links:


Format Your New Topic as Follows:

Zoom Phone API - API - Zoom Developer Docs

Description:

We’re integrating Zoom Phone with Salesforce. Our business wants advisors to create a Salesforce Interaction before a multi-party phone call, then update that same Interaction with the completed call details and AI summary.

Error?
There is no error message as currently we are not able to achieve the same, we need clarity on below points:

1.Can Zoom Phone calls be scheduled or created through an API? If so, does the API return a call_id when the call is scheduled, before anyone places it?

2.If a call_id is only created when someone starts dialing, can we pass a Salesforce Interaction ID or other custom correlation value when starting the call and receive it in a webhook?

3.If custom correlation isn’t supported, does Zoom recommend matching a ringing event to a planned call using the Zoom caller/user, participant phone numbers, and scheduled start time?

4.For multi-party calls, do all call legs share a call_id or conference_id, or does each leg have a separate ID? What’s the recommended way to associate those legs with one Salesforce Interaction?

We reviewed the Phone Webhook documentation and see call IDs and caller/callee details in the events, but don’t see a way to include a Salesforce record ID or custom description.

Hi there!
Thank you for reaching out to us! I am happy to help here!

1.Can Zoom Phone calls be scheduled or created through an API? If so, does the API return a call_id when the call is scheduled, before anyone places it?

No, this is not supported t. Zoom Calls can not be scheduled or created via aPI

2.If a call_id is only created when someone starts dialing, can we pass a Salesforce Interaction ID or other custom correlation value when starting the call and receive it in a webhook?

The call_id gets created once the call starts, not when dialing. Custom correlation is not supported

3.If custom correlation isn’t supported, does Zoom recommend matching a ringing event to a planned call using the Zoom caller/user, participant phone numbers, and scheduled start time?

Yes, I would recommend something like similar.
Using the phone.callee_ringing or phone.caller_ringing

You can then map the data returned by that event with your integration

4.For multi-party calls, do all call legs share a call_id or conference_id, or does each leg have a separate ID? What’s the recommended way to associate those legs with one Salesforce Interaction?

For multi-party calls, you can leverage the Get call history endpoint Phone API - Phone - Zoom Developer Docs

To get all the call elements within the call