Letting Your User Know the Host Isn't Present
Last updated: November 18, 2024
In Zoom meetings, bots needs permission from the meeting host to start recording. And if the host is not connected to your app via OAuth, the bot will not be able to prompt anyone for permission and thus there will be no explicit recording_permission_denied or recording_permission_allowed event.
This can be particularly confusing, since there isn't an explicit event you can use to notify your user upon receiving.
Best practices to handle this
To handle this case where the host isn't present and the bot couldn't prompt anyone for recording permission, the recommended approach is:
Set the
automatic_leave.in_call_not_recording_timeoutparameter to a desired value (e.g. 5 minutes). This will make the bot leave the meeting after the specified time if recording permission is not granted.Listen for the
in_call_not_recordingwebhook event.If the bot does not transition to
in_call_recordingstate within a set time period (e.g. a minute before it times out based on the setin_call_not_recording_timeout), send a chat message to notify the user that the bot will leave the meeting soon due to lack of recording permission.
This approach allows you to automatically remove the bot from meetings where recording is not possible, while also notifying your users about the situation. This will also prevent any confusion later on if the user expected the bot to be able to record.