Video interview providers

Configure Zoom, Microsoft Teams, Google Meet, or Jitsi and verify the generated interview link.

When an interview uses Video, Harly selects one connected provider and stores the resulting link on the interview. With automatic selection, the preference order is Zoom, Microsoft Teams, Google Meet, then Jitsi. You can also select a provider explicitly or paste an external meeting URL.

Provider setup

Provider	Credential model	Where to configure
Zoom	OAuth connection	Settings → Integrations → Zoom
Microsoft Teams	Microsoft/Outlook OAuth connection	Settings → Integrations → Microsoft Teams
Google Meet	Shared Google Calendar OAuth connection	Settings → Integrations → Google Meet
Jitsi Meet	Workspace base URL, default https://meet.jit.si	Settings → Integrations → Jitsi Meet

Zoom

Create a Zoom OAuth app and register this callback:

https://harly.example.com/api/integrations/zoom/callback

Then open Settings → Integrations → Zoom. Enter the Zoom Client ID and Client Secret in the card or provide ZOOM_CLIENT_ID and ZOOM_CLIENT_SECRET on the server, choose Connect, and authorize the workspace account. Use the connection to schedule a test video interview.

Rotate the provider secret in Zoom and Harly together.

Microsoft Teams

1. Configure Microsoft OAuth

   Set MICROSOFT_CLIENT_ID and MICROSOFT_CLIENT_SECRET on the Harly server. Register this callback in the Microsoft app:

   https://harly.example.com/api/integrations/outlook/callback
   
2. Connect Teams

   Open Settings → Integrations → Microsoft Teams, choose Connect Microsoft, and authorize an account with access to the Outlook calendar.

3. Test the meeting link

   Use Test connection, then schedule a video interview. Teams creates the meeting through the Outlook connection; calendar selection lives on the Outlook Calendar integration.

Google Meet

1. Configure Google OAuth

   Set GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET on the Harly server and register ${HARLY_URL}/api/integrations/google/callback in Google Cloud.

2. Connect Meet

   Open Settings → Integrations → Google Meet, choose Connect Google, and authorize the Google Calendar account.

3. Select a calendar and test

   Select a writable calendar under Google Calendar, test the connection, and schedule a video interview. Meet uses the same Google Calendar connection.

Jitsi Meet

Jitsi does not require an OAuth client or API key. Open Settings → Integrations → Jitsi Meet, enter your self-hosted instance URL or keep the public https://meet.jit.si default, enable it, and test by scheduling a video interview. Use HTTPS in production. Public Jitsi rooms are open to anyone with the link; for sensitive interviews, prefer a self-hosted instance with a lobby.

Jitsi is used automatically only when Zoom, Teams, and Google Meet are not connected.

Sync behavior

Editing or canceling an interview attempts to update the provider object. If a provider fails, Harly preserves the local interview and reports a provider warning. Retry the sync from the interview instead of creating a second interview.

Do not paste private provider tokens into the interview location field. Use the integration settings so credentials remain protected and auditable.