NIVA is now Vatoo. Read the short story

Vatoo
All integrations

Connect Zendesk
to Vatoo

Vatoo connects to Zendesk via the REST API v2 using API Token authentication, giving your AI bot live read and write access to your support desk. Once connected you can enable individual components · Tickets, Users, Organizations, Groups · and control exactly which operations the bot can perform. Let your bot answer ticket status questions, create new tickets, reply to customers, and escalate automatically · without a human agent touching the keyboard.

Estimated: 5–10 minutesEasy6 steps

Confirm connector availability, your account plan, and required permissions before setup. Test with a non-production record before enabling live actions.

Vatoo
VatooZendesk
Enable API Access and Generate a Token01
Find Your Zendesk Subdomain02
Connect Zendesk in Vatoo Botmaster03
Test the Connection04

Setup overview · illustrative

Have these
ready

  • Zendesk account (Support plan required for API access)
  • Vatoo botmaster account with active bot
  • Zendesk admin access to generate an API token

6 steps
to go live

01

Enable API Access and Generate a Token

  • Log in to Zendesk as an Administrator
  • Go to Admin Center (grid icon in the top bar)
  • Navigate to Apps and integrations → APIs → Zendesk API
  • Under Settings, ensure Token access is enabled
  • Click Add API token
  • Enter a description (e.g. "Vatoo Bot") and click Create
  • Copy the token immediately · it is only shown once

API token access is per-agent. The token is associated with the email you use in the next step.

02

Find Your Zendesk Subdomain

  • Look at your Zendesk URL in the browser address bar
  • It will be in the form https://yourcompany.zendesk.com
  • Your subdomain is yourcompany only · not the full URL
03

Connect Zendesk in Vatoo Botmaster

  • Open your Vatoo botmaster → ERP Integrations in the sidebar
  • Find the Zendesk card and click Connect Zendesk
  • Enter your Zendesk Subdomain (just the subdomain)
  • Enter the Agent Email · the email address of the admin who generated the token
  • Paste the API Token
  • Click Save & Connect

The integration name is just a friendly label. You can name it anything.

04

Test the Connection

  • Back on the ERP Integrations page, click Test on the Zendesk card
  • A green success message with your ticket count confirms the connection works
  • If the test fails, check that the email matches the token owner and the subdomain is correct
05

Enable Components and Configure Write Permissions

  • Click Components on the Zendesk card
  • Toggle on the components your bot should access: Tickets, Users, Organizations, Groups
  • For write operations (create ticket, reply, update user) enable the "Allow Write" toggle per operation
  • Click Save

Start with read-only. Enable write access only for operations you are confident should be automated.

06

Test with Your Bot

  • Open your bot chat widget
  • Try: _"Show me all open tickets"_
  • Try: _"Find user with email user@example.com"_
  • Try: _"Create a ticket: Billing query, priority high"_
  • Check ERP Integrations → Operation Logs for each API call made

Stuck?
Quick fixes

401 Unauthorized · test connection fails

The agent email and API token combination is wrong. Re-generate the token in Admin Center → Apps and integrations → APIs → Zendesk API. Ensure the email matches the account that owns the token.

Subdomain not found

Enter just the subdomain (e.g. "acme" not "acme.zendesk.com"). EU-hosted accounts may use a different TLD · check your actual login URL.

Search returns empty results

Zendesk search uses a query language. At minimum provide "type:ticket" which Vatoo adds automatically. Add a status or keyword to narrow results.

Create ticket fails · 422 Unprocessable Entity

Subject is required. If providing a requester, the email must be valid. For internal-only tickets you can omit the requester but a comment body is still recommended.

Reply operation fails with 403

The agent associated with the API token may lack permission to update certain tickets. Check the agent's role in Admin Center → People → Team members.

Cannot find Zendesk API option in Admin Center

API token access requires a Zendesk Support plan. The feature is not available on the free trial. Upgrade to at least a Team plan to unlock API tokens.

More integrations

Connect Zendesk in one call

Book a demo and we'll set up the integration with you live.