Zendesk platform help — ticketing, Help Center knowledge base, AI agents, live chat, Talk voice, Sell CRM, omnichannel messaging, Explore analytics, Marketplace apps, REST API. Use when Zendesk tickets not routing correctly, AI agent misclassifying or giving wrong answers, help center articles not surfacing in search, live chat widget not converting, SLA badges not showing or breach timers wrong, Zendesk costs spiraling with add-ons, API rate limits being hit, or integrations not syncing with Salesforce or HubSpot. Do NOT use for help desk platform comparison (use /sales-helpdesk-selection), CCaaS platform selection (use /sales-ccaas-selection), or live chat strategy across tools (use /sales-live-chat).
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
The command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
File Explorer
4 files
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview
name
sales-zendesk
description
Zendesk platform help — ticketing, Help Center knowledge base, AI agents, live chat, Talk voice, Sell CRM, omnichannel messaging, Explore analytics, Marketplace apps, REST API. Use when Zendesk tickets not routing correctly, AI agent misclassifying or giving wrong answers, help center articles not surfacing in search, live chat widget not converting, SLA badges not showing or breach timers wrong, Zendesk costs spiraling with add-ons, API rate limits being hit, or integrations not syncing with Salesforce or HubSpot. Do NOT use for help desk platform comparison (use /sales-helpdesk-selection), CCaaS platform selection (use /sales-ccaas-selection), or live chat strategy across tools (use /sales-live-chat).
J) API & Development — REST API, webhooks, apps, ZIS
K) Admin — pricing, plans, add-ons, billing, user management
L) Something else — describe it
What's your role?
A) Support agent / team lead
B) Support manager / director
C) Admin / IT
D) Developer / RevOps
E) Founder / small team
F) Other
What plan are you on? (Support Team $19 / Suite Team $55 / Suite Growth $89 / Suite Professional $115 / Suite Enterprise & Enterprise Plus — quote-only "Talk to Sales") — note AI agents are now billed per Automated Resolution on top of any plan
Skip-ahead rule: if the user's prompt already contains enough context, skip to Step 2.
Step 2 — Route or answer directly
Problem domain
Route to
Choosing between Zendesk vs Freshdesk vs Intercom
/sales-helpdesk-selection {question}
Contact center / CCaaS selection
/sales-ccaas-selection {question}
Live chat strategy across tools
/sales-live-chat {question}
Chatbot flow design (non-Zendesk)
/sales-chatbot {question}
CRM comparison / selection
/sales-crm-selection {question}
Email deliverability
/sales-deliverability {question}
Sales coaching / call review
/sales-coaching {question}
When routing to another skill, provide the exact command: "This is a {problem domain} question — run: /sales-{skill} {user's original question}"
Step 3 — Zendesk platform reference
Read references/platform-guide.md for the full platform reference — modules, pricing, integrations, data model, workflows.
Answer the user's question using only the relevant section. Don't dump the full reference.
Step 4 — Actionable guidance
You no longer need the platform guide — focus on the user's specific situation.
Ticket routing issues: Check trigger conditions, order (triggers fire top-to-bottom), and automation vs trigger distinction (automations are time-based, triggers are event-based)
SLA problems: Verify business hours schedule, check if SLA policies are applied in the correct order (first match wins), confirm the metric type (first reply vs next reply vs periodic update)
AI agent tuning: Review conversation logs for misclassification patterns, adjust intents, add training phrases, check if the right knowledge sources are connected
Cost optimization: Map features to actual plan needs — many teams overpay for Enterprise when Professional covers their needs. Evaluate whether AI/QA/WFM add-ons are delivering ROI
API integration: Use API tokens for server-side, OAuth for client-side apps. Mind rate limits (200-2500 req/min by plan). Use incremental exports for bulk data, not list endpoints
If you discover a gotcha, workaround, or tip not covered in references/learnings.md, append it there.
Gotchas
Best-effort from research — review these, especially items about plan-gated features and add-on pricing that may be outdated.
Real costs are 2-3x advertised — base plan prices don't include Advanced AI ($50/agent), Copilot ($50/agent), QA ($35/agent), or WFM ($25/agent; the Workforce Engagement Bundle pairs QA+WFM at $50). A team on Suite Pro at $115/agent can easily reach $225/agent with add-ons. As of 2026, Suite Enterprise / Enterprise Plus are quote-only ("Talk to Sales") rather than the old fixed $169.
AI agents are now billed per outcome — Zendesk AI agents are included in every Suite/Support plan but charged per Automated Resolution (publicly cited around $1.50 committed / $2.00 pay-as-you-go), so AI cost scales with volume on top of seat prices. The Advanced AI add-on ($50/agent) unlocks AI triage/sentiment/intent on top. Don't assume "AI included" means free.
Triggers vs automations confusion — triggers fire on ticket create/update (event-based), automations fire on time conditions (hourly scan). Mixing them up causes routing bugs.
Zendesk's own support is slow — widely reported across G2, Trustpilot, and community forums. Budget for self-service via their docs and community rather than relying on support tickets.
Integration sync can pause silently — Salesforce and HubSpot syncs can stop without admin notification. Monitor sync health proactively.
Reporting is plan-gated — real-time dashboards require Professional+. Custom Explore reports have limited customization on lower plans.
API rate limits vary dramatically by plan — Team gets 200 req/min, Enterprise gets 700, Enterprise Plus gets 2500. Hitting limits returns 429 with Retry-After header.
256 API token limit — accounts can maintain up to 256 active tokens; at capacity you must delete one to create a new one. (Accounts that already exceed 256 are grandfathered to a 2048 limit.)
Webhooks are signed — verify the X-Zendesk-Webhook-Signature header as base64(HMAC-SHA256(timestamp + body)) using the webhook's signing secret, where the timestamp is the X-Zendesk-Webhook-Signature-Timestamp header. Use the X-Zendesk-Webhook-Invocation-Id header for idempotent processing. See references/zendesk-api-reference.md.
Related skills
/sales-helpdesk-selection — Comparing help desk platforms (Zendesk vs Freshdesk vs Intercom vs Help Scout)
/sales-ccaas-selection — CCaaS platform comparison and selection
/sales-live-chat — Live chat strategy across tools
/sales-chatbot — Chatbot marketing and conversational automation
/sales-integration — Connect Zendesk to CRM, e-commerce, and other tools
/sales-do — Not sure which skill to use? The router matches any sales objective to the right skill. Install: npx skills add sales-skills/sales --skill sales-do
Examples
Example 1: Ticket routing broken
User says: "Tickets from our enterprise customers keep going to the wrong team — they should go to our dedicated enterprise queue but they're landing in general support"
Skill does: Walks through trigger conditions (check organization tags, custom fields, or email domain), trigger ordering (first-match wins), and tests with a sample ticket to trace the routing path.
Example 2: AI agent giving bad answers
User says: "Our AI agent keeps suggesting irrelevant help center articles when customers ask about billing"
Skill does: Reviews connected knowledge sources, checks intent training phrases, examines conversation logs for misclassification patterns, and recommends adding negative examples to improve classification.
Example 3: Costs spiraling
User says: "We're on Suite Enterprise and our Zendesk bill is $5000/month for 20 agents — can we reduce this?"
Skill does: Audits which add-ons are active (AI, QA, WFM), checks if Enterprise features are actually used (custom roles, sandbox, 300 help centers), and recommends downgrading to Professional if advanced features aren't needed.
Troubleshooting
SLA badges not showing or breach timers wrong
Symptom: SLA indicators missing from tickets, or timers count through non-business hours
Cause: Business hours schedule misconfigured, SLA policy order wrong (first match wins), or metric type mismatch (first reply vs next reply)
Solution: 1) Check Admin > Business rules > SLAs — verify the policy matches the right conditions. 2) Check Admin > Business rules > Schedules — verify timezone and business hours. 3) SLA policies apply first-match, so put more specific policies above general ones.
API rate limit errors (429)
Symptom: API calls returning 429 Too Many Requests
Cause: Exceeding plan-based rate limits (Team: 200/min, Pro: 400/min, Enterprise: 700/min)
Solution: 1) Check X-Rate-Limit and Retry-After response headers. 2) Use incremental exports for bulk data instead of list endpoints. 3) Implement exponential backoff. 4) Consider the High Volume Add-on (2500/min, requires 10+ agent seats).
Salesforce sync not updating
Symptom: Ticket data not appearing in Salesforce, or Salesforce contacts not syncing to Zendesk
Cause: Sync can pause silently due to auth token expiration, field mapping errors, or API limits on either side
Solution: 1) Check Admin > Integrations > Salesforce — look for sync errors. 2) Re-authenticate if the OAuth token expired. 3) Verify field mappings match expected data types. 4) Check Salesforce API usage — Zendesk sync counts against Salesforce API limits too.
