Connecting Zoho Desk
Connect Zoho Desk so your agents can manage tickets across your preferred Zoho datacenter.
Info
The Zoho Desk integration is currently in Beta. Core ticket flows work, but some edge cases (attachments, custom fields, multi-department setups) are still being refined. We welcome your feedback.
Prerequisites
- A Zoho Desk account with admin access
- Your Zoho datacenter region: US (.com), EU (.eu), India (.in), Australia (.com.au), or Japan (.jp)
- Permission to create webhooks in Zoho Desk
Connect Your Account
- Open Settings → Connected Apps
- Find Zoho Desk and click Connect
- Choose your datacenter region — this determines which Zoho endpoints Symbi will use. Pick the region where your Zoho Desk data lives
- Click Connect with Zoho Desk — you'll be redirected to Zoho's OAuth consent screen for that region
- Review the scopes (ticket management, settings, basic org info) and approve
- You're returned to Symbi with the connection confirmed
Warning
Pick the right region before connecting — changing regions later requires disconnecting and reconnecting.
Webhook Setup
After OAuth, Symbi shows you a webhook URL and secret in a collapsible section on the Zoho Desk card. You'll need to add these to Zoho Desk manually:
- In Zoho Desk, go to Setup → Automation → Webhooks
- Create a new webhook and paste the URL from Symbi
- Add the secret Symbi provided
- Enable the events:
ticket_created,ticket_updated,comment_created - Save
Symbi also polls on a backup schedule, so if a webhook misses, the agent still sees the event shortly after.
What Your Agent Can Do
Once connected, a Zoho Desk agent can:
- Reply to Ticket — send customer-facing responses
- Add Note — internal staff-only notes
- Update Ticket Status — move tickets through Open, On Hold, Escalated, Closed
- Get Ticket — fetch ticket details
- Get Conversations — read the full conversation history
- List Tickets (opt-in)
Security
Zoho OAuth tokens expire every hour and are refreshed automatically. Tokens are AES-256 encrypted at rest. Each API call uses the datacenter-aware endpoint for your region and includes the required Zoho-oauthtoken header.
You can revoke Symbi's access any time from your Zoho account's connected apps page.
Limitations
- Company-only — Zoho Desk is not available for the Personal Assistant
- Attachments in beta — inline images and file attachments are supported but may behave inconsistently on certain ticket types
- Custom fields — most custom fields are readable, but writing to some may require additional configuration
Tip
Start with Always Review for the first week. Zoho's workflow flexibility means each customer's setup is slightly different, and reviewing early actions helps you fine-tune the agent to your specific pipeline.
What's Next?
- Connect Slack for real-time review notifications
- Learn about the Operation Center for managing approvals
- Fine-tune behavior in the tuning guide
Info
Zoho Desk-integrasjonen er for øyeblikket i Beta. Kjerne-saksflyter fungerer, men enkelte kanttilfeller (vedlegg, tilpassede felter, oppsett med flere avdelinger) finjusteres fortsatt. Vi tar gjerne imot tilbakemeldinger.
Forutsetninger
- En Zoho Desk-konto med administratortilgang
- Din Zoho datasenter-region: US (.com), EU (.eu), India (.in), Australia (.com.au) eller Japan (.jp)
- Tillatelse til å opprette webhooks i Zoho Desk
Koble til kontoen din
- Åpne Innstillinger → Tilkoblede apper
- Finn Zoho Desk og klikk Koble til
- Velg datasenter-region — dette bestemmer hvilke Zoho-endepunkter Symbi vil bruke. Velg regionen der Zoho Desk-dataene dine ligger
- Klikk Koble til med Zoho Desk — du blir videresendt til Zohos OAuth-samtykkeskjerm for den regionen
- Gå gjennom omfangene (sakshåndtering, innstillinger, grunnleggende organisasjonsinformasjon) og godkjenn
- Du returneres til Symbi med tilkoblingen bekreftet
Warning
Velg riktig region før du kobler til — å endre region senere krever at du kobler fra og kobler til på nytt.
Webhook-oppsett
Etter OAuth viser Symbi deg en webhook-URL og -hemmelighet i en utvidbar seksjon på Zoho Desk-kortet. Du må legge disse til i Zoho Desk manuelt:
- I Zoho Desk, gå til Setup → Automation → Webhooks
- Opprett en ny webhook og lim inn URL-en fra Symbi
- Legg til hemmeligheten Symbi ga deg
- Aktiver hendelsene:
ticket_created,ticket_updated,comment_created - Lagre
Symbi poller også på et backup-skjema, så hvis en webhook går glipp, ser agenten fortsatt hendelsen kort tid etter.
Hva agenten din kan gjøre
Når tilkoblingen er på plass, kan en Zoho Desk-agent:
- Svar på sak (Reply to Ticket) — sende kundevendte svar
- Legg til notat (Add Note) — interne notater kun for staben
- Oppdater saksstatus (Update Ticket Status) — flytte saker gjennom Open, On Hold, Escalated, Closed
- Hent sak (Get Ticket) — hente saksdetaljer
- Hent samtaler (Get Conversations) — lese hele samtalehistorikken
- List saker (List Tickets) (opt-in)
Sikkerhet
Zoho OAuth-tokens utløper hver time og oppdateres automatisk. Tokens krypteres med AES-256 i hvile. Hvert API-kall bruker det datasenter-bevisste endepunktet for regionen din og inkluderer den nødvendige Zoho-oauthtoken-headeren.
Du kan oppheve Symbis tilgang når som helst fra siden for tilkoblede apper på Zoho-kontoen din.
Begrensninger
- Kun selskap — Zoho Desk er ikke tilgjengelig for den Personlige Assistenten
- Vedlegg i beta — innebygde bilder og filvedlegg støttes, men kan oppføre seg inkonsistent på visse sakstyper
- Tilpassede felter — de fleste tilpassede felter er lesbare, men skriving til noen kan kreve ekstra konfigurasjon
Tip
Start med Alltid gjennomgå den første uken. Zohos arbeidsflytfleksibilitet betyr at hver kundes oppsett er litt forskjellig, og å gjennomgå tidlige handlinger hjelper deg å finjustere agenten til din spesifikke pipeline.
Hva er neste?
- Koble til Slack for sanntidsvarsler om gjennomgang
- Lær om Operation Center for håndtering av godkjenninger
- Finjuster oppførselen i justeringsveiledningen