Integrations
Save a Cal.com key or connect a Google account once, then let any agent's calendar functions use it without pasting a secret into each one.
An integration is a saved connection to another service. You set it up once in Settings, Integrations, and agents pick it from a list. The secret stays in one place, is stored encrypted, and is never shown again.
Only owners and admins can see or change this page. Saved connections may not be available on every account: when they are not, the page says Not available on this deployment and the save buttons are off.
Cal.com
- Create an API key in your Cal.com settings.
- In Settings, Integrations, Add a Cal.com connection, enter a Name (a label such as "Main calendar", up to 80 characters) and the API key (at least 8 characters).
- Choose Save connection.
Dialgem keeps the key encrypted and lists only its last four characters afterwards. If a key is wrong or has been rotated, delete the connection and save a new one.
Google Calendar
Choose Connect a Google account and approve access on Google's screen. The connection is named Google Calendar (your address).
- Dialgem asks only to see when you are busy and to add events. It cannot read the details of your events or your email.
- Only a long-lived refresh token is kept, encrypted. Dialgem asks Google for a short access token each time an agent needs one.
- Connecting the same Google account again replaces its saved token rather than adding a second entry.
- If you decline on Google's screen, nothing is saved and the page tells you so.
Use a connection in an agent
Calendar functions take the saved connection instead of a raw key. See Functions and tools. In short:
| Function | Connection | Also needs |
|---|---|---|
| Cal.com: check availability, book, cancel, reschedule | A saved Cal.com connection, or a key pasted into the function | timezone, and for check and book an event_type_id |
| Google Calendar: check availability, book | A saved Google connection | timezone |
A function can only use a connection from its own organization and of the right kind. Saving a calendar function with a missing or wrong connection is refused straight away, so a mistake is found when you save rather than on a live call.
Remove a connection
Choose the bin icon beside it under Saved connections. Dialgem refuses while an agent function still uses the connection: change or remove that function first, then delete the connection.
Limits
- Up to 20 saved connections per organization.
- Names must be unique within an organization.
- Adding, connecting and removing a connection are recorded in the audit log, without the secret.