Choose an authentication method
- OAuth (recommended)
- API token
OAuth lets Zendesk handle authorization without requiring you to generate or store tokens manually. RAUM AI receives a scoped access token that you can revoke from the Zendesk admin panel at any time.
Enter your subdomain
In the Zendesk Subdomain field, type the subdomain portion of your Zendesk URL. For example, if your Zendesk URL is
acme.zendesk.com, enter acme.Click Connect with Zendesk
Click Connect with Zendesk. RAUM AI redirects you to the Zendesk authorization page.
Authorize the connection
Log in to Zendesk if prompted, then click Allow to grant RAUM AI access to your account.
Set up webhooks and triggers
Webhooks let Zendesk push ticket events to RAUM AI in real time so Agent Mode can process tickets automatically. You can create the webhook and triggers during the onboarding wizard (step 5) or from Settings → Webhook at any time.Auto-create triggers
RAUM AI can provision the webhook endpoint and Zendesk triggers for you automatically:Open the webhook setup
In Settings → Webhook, click Auto-create triggers (or proceed through step 5 of the onboarding wizard).
Select the trigger types
Choose one or more of the following events:
| Trigger | When it fires |
|---|---|
| Ticket created | RAUM AI processes new tickets as soon as they arrive |
| Ticket solved | Captures resolution outcomes for CSAT tracking |
| Ticket rated | Syncs CSAT ratings back to RAUM AI analytics |
Manual webhook setup
If you prefer to configure the webhook manually in Zendesk:- In Zendesk, go to Admin → Apps and integrations → Webhooks → Create webhook.
- Set the endpoint URL to the one shown in RAUM AI under Settings → Webhook → Webhook URL.
- Set the request format to JSON and the HTTP method to POST.
- Create a trigger in Admin → Objects and rules → Triggers that targets the new webhook for the events you want to capture.
Troubleshooting
OAuth redirect returns an error
OAuth redirect returns an error
Common causes include an incorrect subdomain, Zendesk OAuth being disabled for your account, or a network firewall blocking the redirect. Verify your subdomain contains no spaces or special characters, then try again. If the problem persists, switch to API token authentication.
API token authentication fails with 401
API token authentication fails with 401
Check that you entered the admin email exactly as it appears in Zendesk (case-sensitive). Confirm that token access is enabled in Zendesk Admin → Zendesk API. If you regenerated the token in Zendesk, update it in RAUM AI under Settings → Integrations.
Triggers were created but tickets are not being processed
Triggers were created but tickets are not being processed
Confirm that the trigger condition in Zendesk matches tickets you expect RAUM AI to receive. Check Settings → Webhook in RAUM AI to see recent webhook deliveries and any error responses. Also verify that Agent Mode is enabled in Settings → AI Mode.
Webhook trigger auto-setup shows an 'error' status
Webhook trigger auto-setup shows an 'error' status
This usually means the Zendesk API returned a permissions error. Confirm that the connected account has admin-level access. If you are using an API token, check that the token belongs to an admin user, not an agent.