Setting up your Zoom application
In order to use Amelia and Zoom together you need to setup the Zoom application first so you can connect it with Amelia plugin. In the next steps we will explain you how to do that:
- Sign up or Sign in to Zoom – if this is your first time on Zoom you will need to Sign up by entering your email. After you have entered the email you will receive a message on it from Zoom to confirm your address and finish the process. Open the email and follow the link that Zoom has sent you, setup your password and skip steps with adding a new members for now. After that you will be redirected to your Zoom Profile.
- Visit Zoom App Marketplace – Enter https://marketplace.zoom.us/ in your browser to visit Zoom App Marketplace. Once you enter the page click Sign In and sign in with account that you have previously created on Zoom.
- Create your App – Once you have entered the marketplace click on Develop button and choose Build App option.
- Choose your App type – On this page you need to choose the first option JWT. Click “Create” and you will see a popup to give your App a name. Enter the name and click “Create” once again.
- Basic Information – Once you have added a name to your app you will be redirected to the Information page. Here we will enter just three mandatory information, you can add the rest later if you want since the rest fields are optional. In Basic Information add Company Name, and in Developer Contact Information add Name and Email address and click “Continue”.
- App Credentials – Once you have entered Basic Information the App Credentials will open. These information you need to paste to Amelia Settings in order to connect Amelia plugin with your Zoom app. Click “Copy” in the “API Key” field and open Amelia Settings. On the “Settings Page” you will see “Integration Settings”, open it and choose “Zoom” (the second tab). Paste “API Key” from Zoom to “Client Key” option in our Zoom Settings. Then go back to your Zoom App, copy the “API Secret” and paste it to “Client Secret” option in our Zoom Settings. Now click “Save” in the bottom right corner of Zoom Settings in Amelia plugin and our plugin and your Zoom application will be connected.
Beside the “Client Key” and “Client Secret” in Zoom Settings you will see three other options to set:
- Meeting Title – Here you can set what you want your meeting title to be. In order to have different meeting title each time that matches your meeting add the placeholder from email notifications page. Go to the Notifications page, open “Show Email Placeholders” option and copy the placeholder that you want and then paste it in this field (for example %service_name% like we’ve used on the picture above).
- Meeting Agenda – Works same as the option above. Copy one or multiple placeholders from the notifications page and paste it here in order to show details that match scheduled appointment or event (we have chosen %service_description% for this field).
- Create Meetings For Pending Appointments – Here you can choose whether you want your meetings to be created for Pending appointments or not. By default this option is disabled which means that meetings will be created only for the appointments with Approved status.
Once you have set these three options click “Save” and you will be one step closer to using Zoom with Amelia.
Connecting employees and events with Zoom host
Once you setup the Zoom Settings you would need to connect your employees/events with zoom hosts.
To connect employees, go to the Employees page, open Employee and you will see option “Zoom User”. Open the dropdown and you will see the user that you have created while creating the Zoom application.
It is possible to connect each employee with different zoom user so they can have separate Zoom accounts for the meetings. To set this go back to your Zoom account. Click on the “User Management” in the left sidebar and then click on the “Users”.
Then click on “+Add Users” button to add a new user.
The popup for adding user will appear. Enter the email address in the first field and choose Basic as User Type and click “Add”. Now go back to Amelia plugin and in the Employee modal in “Zoom user” field you will see a new user for connecting.
To connect event with Zoom you will see the same option in the Add Event modal.
Services and Zoom
In Amelia, you can have services with or without Zoom integration. For services that require Zoom, you need to enable this option in the Settings tab of the Service modal, under Integrations.
Setting up notifications with Zoom link
In order to send a Zoom link to both, your customers and your employees you need to add a placeholder for Zoom link in the notification templates.
Go to the Notifications page, click on “Show email placeholders” button and modal will show with all currently allowed placeholders. Scroll down to the bottom of the modal and you will see the placeholders for Zoom. For appointments you will have two placeholders:
- %zoom_host_url% – this is the placeholder that you need to paste to employees’ appointment notifications.
- %zoom_join_url% – this is the placeholder that you need to paste to customers’ appointment notifications.
For events, once you click on one of the event booking notifications you will see four different placeholders at the bottom of the list:
- %zoom_host_url_date% – this is the placeholder that you need to paste in employees’ event notifications if you want to show the url with date.
- %zoom_host_url_date_time% – this is the placeholder that you need to paste in employees’ event notifications if you want to show the url with date and time
- %zoom_join_url_date% – this is the placeholder that you need to paste in customers’ event notifications if you want to show the url with date.
- %zoom_join_url_date_time% – this is the placeholder that you need to paste in customers’ event notifications if you want to show the url with date and time.