Scope confirmed for this build
- Channels: Email and Messaging through the native mobile SDK on iOS and Android. No Talk/phone channel or Web Widget.
- Intake: One external website contact form for law enforcement requests, DMCA/copyright notices, partnership inquiries, and general contact feeds Zendesk through the custom parser. No dedicated Zendesk-hosted ticket forms are being built.
- Help Center: Content exists and is searchable by AI agents and approved support surfaces, but is not linked in public navigation and is kept out of search-engine indexing.
- AI: AI Agents Advanced connected to messaging and email; Copilot add-on enabled for human agents.
- Localization: English is the default support/interface language. The app language selector supports English, Spanish, and French; streamer/request stream languages are captured as product metadata.
- Routing: Omnichannel routing is in scope for human escalations, using deterministic request fields first and Intelligent Triage signals only after accuracy is measured.
Omnichannel routing and Intelligent Triage scope.
Build routing around the explicit Issue Category field, source channel, priority, group ownership,
business schedule, and escalation requirements. Add Intelligent Triage as an assistive layer for
topic, sentiment, language, and entity detection; do not let AI classification override trusted
form selections or protected-workflow guardrails without review.
| Signal | Use | Guardrail |
|---|---|---|
| Issue Category | Primary routing, SLA, group, and AI-exclusion decision. | Company form and approved fields outrank AI guesses. |
| Topic | Classify account access, app bugs, DMCA, partnership, law enforcement, privacy, billing, and payment work. | Review accuracy by channel before using topics in triggers. |
| Entities | Extract case numbers, app versions, platform, jurisdiction, reference IDs, and urgency values for routing and reporting. | Do not extract or expose secrets, credentials, bank data, or sensitive evidence. |
| Language | Report volume, trigger translation workflow, and identify unsupported-language fallback. | Do not create language queues unless agents can actually work that language. |
| Sentiment | Flag frustration and quality risk for review. | Sentiment is reporting-only until priority rules are tested against real tickets. |
Open questions needing external input.
No flagged tasks yet.
Governance and requirements
| Entry point | Zendesk path | AI / routing | Notes |
|---|---|---|---|
| Website custom contact form | Custom parser creates the ticket. | Parser sets requester email, subject from dropdown, description as message, Issue Category, group, priority, tags, attachments, and correlation ID. | DMCA and law-enforcement get separate confirmation emails; all other categories use the general confirmation. |
| Approved support addresses only. | Email AI agent can answer approved support email; sensitive categories get
no_ai_reply and route to Legal. |
Use omnichannel push routing and auto-open/auto-assign behavior as configured in Phase 14. | |
| iOS in-app Messaging | Native iOS Messaging channel. | Messaging AI agent is Tier 1; human handoff routes to Tier 2 by Issue Category and context. | Admin-side setup covers channel key, authenticated user, metadata, push, and handoff verification. |
| Android in-app Messaging | Native Android Messaging channel. | Messaging AI agent is Tier 1; human handoff routes to Tier 2 by Issue Category and context. | Admin-side setup covers channel key, authenticated user, metadata, push, and handoff verification. |
| Help Center | Public content surface only. | Articles power AI-agent answers and agent/Copilot knowledge. | No Zendesk request form, no Web Widget, no public navigation link. |
| Out of scope | Talk, SMS, social messaging, Web Widget, live chat, community, and Zendesk-hosted request forms. | No routing, AI activation, or public entry point. | Keep disabled or omitted. |
Security, privacy, and compliance
Human-only safeguard. Law-enforcement, DMCA/copyright,
privacy/data-rights, security/vulnerability, litigation, preservation, emergency, and other legally
sensitive requests must bypass autonomous replies and actions. Route them directly to approved human
owners using deterministic fields, tags, and triggers. Have counsel approve intake wording, identity
checks, retention, response templates, and escalation rules.
Brand, identity, and localization
Multilingual support for a monolingual human team
Multilingual operating boundary. Native conversation
translation can let monolingual agents work across supported languages, but machine translation is
an aid—not proof of legal meaning, identity, authority, consent, or deadline. For sensitive/legal
content, preserve the original, avoid autonomous replies, and route through an approved review
process before making a consequential decision. [ZD-68]
Recommended operating model. Let Advanced AI agents handle
Tier 1 in tested supported languages, route human takeovers into the real support groups, and use
native conversation translation when Tier 2 agents need it. Reserve skills for real expertise such
as iOS, Android, DMCA, privacy, or security.
WeeVu language baseline. Confluence documents app language as
English, Spanish, or French, with English as the default interface/support language. Streamer
languages and request stream language are product metadata for matching streams; they are not the
same as agent working languages.
Legal and safety translation gate. Machine-translated
law-enforcement, DMCA, privacy, security, litigation, preservation, or emergency text may be used
for triage only. Preserve the original text, send no autonomous substantive reply, and define the
review/escalation path before relying on identity, authority, scope, dates, legal assertions, or
consent.
Coverage model
| Layer | Required coverage decision | Safe fallback |
|---|---|---|
| Advanced AI agents | Language is activated, supported by the current AI-agent list, covered by approved knowledge, and passes evaluation. | State the limitation and escalate; never improvise a promise. |
| Human email/API/messaging | Native conversation translation supports the language and agents are trained to compare the original. | Pause the substantive response and use the approved escalation path when meaning is uncertain. |
| Help center | Locale, category, section, article, navigation text, metadata, and search path are complete. | Keep the locale inactive; show the approved default language. |
| iOS and Android | SDK UI, app-owned strings, AI/system messages, push text, accessibility labels, and RTL layout are tested. | Use the app’s approved default locale and offer escalation. |
| High-risk requests | An internal process exists for language uncertainty, privacy limits, and legal review. | Acknowledge receipt only with approved text; place the ticket on hold until the process is complete. |
- [ZD-71]
- Start with English default, Spanish, and French.
- Track stream language separately as user/request metadata.
- Track channel, use case, AI-agent support, conversation translation, help center, app UI, and fallback path.
-
- Do not treat stream-language selections as a same-language human support promise.
- [ZD-70]
- Activate only the additional languages needed for the app/support workflow.
- Do not assume activation translates email notifications, rules, macros, knowledge, or app-owned strings.
-
- Pass the normalized locale through the backend.
- Store the submitted value.
- Set requester language through the approved rule/API mapping.
- Treat browser/device locale and AI detection as hints when they conflict with an explicit choice.
- [ZD-52]
- Measure accuracy by language and channel before using it in rules or reports.
- Create an Unknown/Needs review fallback.
- [ZD-77]
-
- Enable Translate with AWS translate for Messaging and outgoing async comments.
- Enable Additionally, translate async channels with AWS Nova Micro for both incoming and outgoing Email/API comments.
- Decide whether to show the AI-translation disclosure on async replies; the disclosure setting does not apply to Messaging.
- [ZD-81]
- Accept or correct the detected language.
- Turn translation on or off per conversation.
- Inspect Show original and Show translation.
- Escalate when meaning is ambiguous.
- Do not copy customer data into consumer translation tools.
- [ZD-72]
- [ZD-73]
- Create a variant for every enabled language.
- Test the default-language fallback.
- [ZD-74]
- Verify URL locale, profile/browser preference behavior, locale switcher, and default fallback.
- [ZD-75]
- Include theme snippets, navigation, metadata, and search terms.
- Do not publish orphan translations whose parent pages are missing.
- [ZD-76]
- Apply the glossary.
- Retain the source/version relationship.
- Review high-impact content through the approved process.
- Add any required AI-translation notice.
- Remember AI article translation does not support content blocks.
- [PT-08]
- [ZD-78]
- Test mixed-language messages, language switching, unsupported-language fallback, and script/dialect issues where relevant.
-
- Re-test supported languages after knowledge, instructions, procedures, model behavior, or system replies change.
- [ZD-79] [ZD-80]
- Remember SDK UI localization does not translate AI, agent, or integration-authored conversation content.
-
- If nobody can validate a language, launch it as limited support or keep it out of scope.
- Test ordinary support, slang/typos, mixed language, ambiguous dates/numbers, form attachments, AI resolution, human takeover, translated reply, and high-risk escalation.
-
- Pause a locale when quality or the review path is not good enough.
People, groups, roles, and skills
Ticket model and Agent Workspace
-
- Account / Login.
- DMCA.
- Equipment.
- Legal / Compliance.
- Other.
- Payments.
- Payouts.
- Press / Partnerships.
- Refund request.
- Requests.
- Safety / Abuse.
- Streams.
- Technical / App Bug.
-
- Source application/platform (website, iOS, Android, email).
- Product/app version, OS version, locale, and authenticated external user ID.
- Organization/agency, jurisdiction/country, reference/case number, and authority type where appropriate.
- AI outcome, escalation reason, contact-form correlation ID, and integration status.
- Legal-hold flag and sensitivity classification if approved.
-
- New: not yet accepted.
- Open: actively owned.
- Pending: waiting on requester.
- On-hold: waiting on internal or third party.
- Solved: response/work complete.
- Possible custom statuses: Awaiting legal review; Awaiting agency verification; Awaiting partner decision.
- [ZD-17]
-
- Urgent: verified immediate safety/security/legal deadline only.
- High: time-sensitive legal or material service impact.
- Normal: standard support and partnership work.
- Low: informational or non-actionable requests.
Website contact form integration
Required architecture. Browser → company-owned HTTPS
endpoint → validation/abuse controls → scoped Zendesk OAuth client → Tickets API. Never put a
Zendesk credential in browser code. Do not build a new implementation on API tokens; use OAuth
client credentials or another supported OAuth flow with short-lived tokens. [ZD-18]
- [ZD-19]
- [ZD-20]
-
- Handle token expiry/renewal, secret rotation, revocation, and secure storage.
- Add timeouts and retry with backoff.
- Handle 401, 403, 409, 422, 429, and 5xx responses.
- Re-test before launch because API-token behavior is changing.
-
Website contact-form Issue Category and control mapping Issue Category Group / priority Required controls Legal / Compliance Legal · High or policy-driven no_ai_reply; verify authority; restricted notifications; counsel procedureDMCA Legal · Normal/High by deadline no_ai_reply; statutory-data checklist approved by counselLegal / Compliance Legal · High by jurisdictional clock no_ai_reply; identity verification; legal-hold checkSafety / Abuse Legal · Urgent/High by severity when security/safety risk exists no_ai_reply; secure disclosure path; no broad email notificationPress / Partnerships Tier 2 · Normal Structured company/URL fields; acknowledgement; qualification macro Technical / App Bug, Account / Login, Streams, Requests, Payments, Payouts, Equipment, Refund request, or Other Tier 1 · Normal Product/platform metadata; normal routing; AI Tier 1 and Copilot eligibility -
- Set requester to the submitted email address.
- Set subject to the selected dropdown value.
- Add the submitted description as the ticket message so AI can read it.
- Set Issue Category, group, priority, source tags, attachments, and correlation ID from the parser mapping.
-
- Do not clone the email AI-agent trigger for the API channel.
- Require Channel = Email for the email AI agent.
- Add
no_ai_replydefensively for every sensitive category. [ZD-21]
-
- DMCA confirmation.
- Law-enforcement confirmation.
- General confirmation for all other categories.
Email channel
Help center and knowledge
“Searchable but not publicly linked” interpretation. Keep the help
center open and indexable so search engines and the AI agents can access public articles, but omit
it from the company site/app’s public navigation. Do not add
noindex; Zendesk
automatically exposes a sitemap for an open help center. [ZD-29]No-Zendesk-form caveat. Removing Submit a request
links does not by itself eliminate direct
/hc/{locale}/requests/new access. Also,
disabling Anybody can submit tickets closes Support to unknown end users and can affect new
inbound email/CC workflows. Choose the open-versus-closed account model from actual email
requirements, then remove the request-form helper from the help-center theme and test direct URLs in
every locale. [ZD-83] [ZD-84]- [ZD-30]
- [ZD-31]
- [PT-02]
- [PT-03]
-
- Remove the request-form helper and fields from
new_request_page.hbs. - Render a localized explanation/link to the company-owned contact form instead.
- Check article request callouts, search/error pages, and notification links after theme updates.
- Remove the request-form helper and fields from
-
- If new email senders are allowed, keep Zendesk open and suppress only the public form surface.
- If only known users are allowed, close Support and test form-created requesters, mobile identities, email replies, and suspended tickets.
iOS Messaging channel — admin setup
Android Messaging channel — admin setup
Advanced AI agents — Messaging and Email
Important AI-agent behavior. Each new AI agent serves only
one channel type. AI-agent-only messaging conversations create read-only tickets; triggers, SLAs,
routing, assignment, macros, and most ticket workflows do not run until the conversation escalates
to a human. Design reporting and escalation tests around that boundary. [ZD-03] [ZD-04]
Build two agents. Create one agent for Messaging and a
separate agent for Email. Only one AI agent can be active on a channel at a time, and a messaging
agent cannot later be activated on email or vice versa. [ZD-41]
- [PT-04]
- [ZD-42]
-
- Welcome/greeting and explicit automated identity.
- Knowledge reply and no-answer behavior.
- Clarification and empty-message behavior.
- Unsupported language.
- Fallback, escalation, failed escalation, and after-hours handoff.
- Feedback/BSAT and wrap-up. [ZD-43]
- [ZD-44]
-
- State use case, required parameters, step order, conditions, success, failure, and escalation.
- Ask for confirmation before consequential actions.
- Do not automate law-enforcement, DMCA, privacy, security, legal-hold, irreversible, or high-impact decisions.
- Test, approve, activate, monitor, and retain rollback history. [ZD-45]
- [ZD-85]
-
- Use allowlisted endpoints, strict input/output schemas, server-side authorization, idempotency, safe retry, audit correlation, and secret redaction.
- Keep backend response under Zendesk’s 30-second requirement and return safe structured errors. [ZD-46]
- Start read-only; separately approve every write action and its rollback.
-
- Keep Channel = Email and Received at = approved support address constraints.
- Do not support the API channel used by the website form.
- Exclude users/organizations tagged
no_ai_replyor equivalent. [ZD-47]
- [ZD-48]
-
- Answerable, unanswerable, ambiguous, typo-heavy, hostile, slang, unsupported-language, and multi-intent requests.
- Explicit human request, repeated fallback, after-hours, disconnection, action timeout/error, and unavailable team.
- PII, legal categories, prompt injection, knowledge poisoning, and requests to ignore policy.
- Email quoting/signatures/footers/attachments and mobile metadata/authentication cases.
- [PT-05]
- [ZD-49]
Zendesk Copilot
Separation of duties. Advanced AI agents speak and act directly
with customers as Tier 1. Agent Copilot guides Tier 2 agents on triage, replies, next steps, and
approved actions after escalation. Admin Copilot supports configuration work. No voice-related
Copilot features are in scope.
[ZD-50]
- [ZD-51]
-
- Review detected topics before using them in routing.
- Create custom topics only where the standard model is insufficient.
- Add entity synonyms and false-positive tests.
- Exclude sensitive values that should not be extracted or exposed.
-
- Keep custom topics aligned to Equipment, Payouts, Streams, Requests, Payments, Safety / Abuse, and Account / Login.
- Keep default-topic mappings aligned to Account / Login, Payments, Payouts, Refund request, Equipment, DMCA, Technical / App Bug, and Other.
- Keep the form's explicit Issue Category as the higher-trust value when form and topic disagree.
-
- Suggested first replies can draw from macros/help-center content and sometimes LLM-generated content; agents must verify every suggestion.
- Auto assist takes precedence when both features produce suggestions. [ZD-53]
- [ZD-54]
-
- Write short, ordered steps directed at the agent.
- Reference the correct public article, internal procedure, macro, fields, and action.
- Include prerequisites, branching, stop conditions, manual checks, and escalation.
- Track version, test cases, and rollback.
- [ZD-56]
-
- Use read-only actions first.
- Require an additional confirmation for refunds, deletions, account changes, or external side effects.
- For legal categories, use procedures to guide human verification/escalation; do not create actions that decide legal validity.
-
- Read the AI conversation summary and source ticket history before acting.
- Use Copilot for next-step guidance, suggested replies, procedures, and action prompts.
- Confirm facts, policy fit, customer impact, and required approvals before sending or taking action.
- Flag missing, wrong, or confusing Copilot guidance through the agent feedback process.
- [ZD-58]
- [ZD-59]
-
- Admin Copilot is included with Suite Professional as of May 2026 and does not consume the monthly Copilot allowance. [ZD-60]
- Because Professional lacks the account audit log, record Admin Copilot changes in the external configuration register.
Routing, business rules, schedules, and SLAs
| Setting | WeeVu decision / option |
|---|---|
| Routing mode | Use omnichannel push routing for email and messaging. |
| Messaging assignment | Use Auto-accept for the agent. |
| Email assignment | Decide whether assigned email tickets automatically open for agents. |
| Capacity evaluation | Choose spare-capacity percentage or remaining ticket count. |
| Capacity ramp | Stage 1: 2 messaging / 6 email. Stage 2: 4 messaging / 4 email. Stage 3: 6 messaging / 2 email. |
| Messaging reassignment timing | Leave off while messaging auto-accept is on. |
| Inactive messaging capacity | Decide whether inactive messaging conversations count toward capacity. |
| Capacity release and reminders | Keep or adjust inactivity reminders, Pending/Solved status changes, and auto-release. |
| Agent-ended sessions | Decide whether ended messaging sessions route later as email tickets. |
| Reassignment through queues / focus mode | Decide whether reassigned work returns through custom queues and whether focus mode is on. |
- [ZD-61]
-
- Stage 1: 2 messaging conversations and 6 email tickets per agent.
- Stage 2: 4 messaging conversations and 4 email tickets per agent.
- Stage 3: 6 messaging conversations and 2 email tickets per agent.
- [ZD-62]
-
00 · Guardrails / exclusions10 · Intake normalization20 · Classification / priority30 · Group / skills / routing40 · AI / Copilot enablement50 · Notifications60 · Integrations90 · Cleanup / closure
- [PT-06]
-
- Automations run hourly, not at an exact minute, and can affect at most 1,000 tickets per hourly run. [ZD-63]
-
- First reply, next reply, periodic update, requester wait, agent work, and total resolution as appropriate.
- Do not assume an SLA applies to an AI-agent-only messaging ticket; it starts only after human escalation makes the ticket editable. [ZD-64]
Agent operations and training
Reporting and monitoring
UAT and production readiness
-
- Test website intake and requester-language mapping.
- Test email/dynamic content and help-center hierarchy/search.
- Test both AI agents, native translation, mobile UI/push, accessibility/RTL, and legal escalation.
- If nobody can validate a language, document the fallback process instead of claiming full support.
Cutover and rollback
Hypercare and continuous improvement
Final acceptance gates
Do not launch until every gate passes
Sources reviewed
Official Zendesk documentation is authoritative for product behavior. Partner material informed sequencing, governance, knowledge quality, testing, and maintainability. All links were checked during research on 1 August 2026.
Zendesk product and implementation
- ZD-01About the Zendesk Suite plan types
- ZD-02Launch Guide for Zendesk Suite
- ZD-05Zendesk Suite Product Controls and Recommendations Guide
- ZD-61Setting your schedule with business hours and holidays
- ZD-62Creating custom omnichannel routing queues
- ZD-63About automations and how they work
- ZD-64About SLA policies and how they work
Multilingual support and translation
- ZD-68Understanding conversation translation
- ZD-69Turning AI translation on or off for ticket conversations
- ZD-70Adding multiple languages to Zendesk
- ZD-71Zendesk language support by product
- ZD-72Excluding terms from AI-generated translations
- ZD-73Providing multiple-language support with dynamic content
- ZD-74Configuring a help center for multiple languages
- ZD-75Localizing help-center content
- ZD-76Translating help-center articles with AI
- ZD-77Using an end user’s language in business rules
- ZD-78Languages supported by AI agents
- ZD-79Localizing the iOS Messaging SDK UI
- ZD-80Localizing the Android Messaging SDK UI
- ZD-81Translating conversations in tickets
AI agents and Copilot
- ZD-03Creating an AI agent
- ZD-04Understanding AI-agent tickets
- ZD-062026 AI-agent workspace migration and knowledge/search updates
- ZD-41Activating and managing AI agents
- ZD-42Connecting knowledge sources for AI agents
- ZD-45Creating generative procedures
- ZD-46Technical requirements for AI-agent integrations
- ZD-48Agentic AI for advanced email AI agents
- ZD-49About automated resolution tiers
- ZD-50About Zendesk Copilot
- ZD-52Automatically classifying tickets with intelligent triage
- ZD-54Turning on and configuring Auto Assist
- ZD-55Creating procedures for Auto Assist
- ZD-59Analyzing Copilot activity
- ZD-60Admin Copilot for Suite Professional and above
API, security, email, knowledge, and mobile SDKs
- ZD-10Migrating from API tokens to OAuth access tokens
- ZD-18Removal of API tokens beginning July 28, 2026
- ZD-22Verification for anonymous help-center requests
- ZD-23Forwarding incoming email
- ZD-25Authenticating incoming email
- ZD-29Help-center SEO and sitemap
- ZD-30Remove Submit a request from the help center
- ZD-32iOS SDK release notes
- ZD-33iOS Messaging SDK getting started
- ZD-34iOS end-user authentication
- ZD-35iOS push notifications
- ZD-36Zendesk SDK app privacy details
- ZD-37Android Messaging SDK getting started
- ZD-38Android end-user authentication
- ZD-39Android push notifications
- ZD-82Android Messaging SDK release notes
Additional official control and channel references
- ZD-07Analyzing and improving the account security posture
- ZD-08Single sign-on options in Zendesk
- ZD-09Managing two-factor authentication
- ZD-11Creating ticket deletion schedules
- ZD-12Agent Workspace for messaging
- ZD-13Data processing in AI agents
- ZD-14Host mapping a help center
- ZD-15Light-agent permissions
- ZD-16Managing omnichannel routing configuration
- ZD-17Activating custom ticket statuses
- ZD-19Tips to combat spam and protect your business
- ZD-20OAuth token scopes API reference
- ZD-21Managing AI agents connected to email channels
- ZD-24Allowing Zendesk to send on behalf of your email domain
- ZD-26Customizing email notifications
- ZD-27Allowing attachments in tickets
- ZD-28Understanding simplified email threading
- ZD-31Removing Web Widget to deactivate web/mobile messaging
- ZD-40Android SDK analytics tracking
- ZD-43Viewing and editing AI-agent system replies
- ZD-44AI-agent instructions and tone-of-voice best practices
- ZD-85Managing use cases and reply methods for AI agents
- ZD-47Defining customers who interact with email AI agents
- ZD-51Turning Zendesk AI features on or off
- ZD-53Turning on suggested first replies
- ZD-56Reviewing AI-generated Auto Assist procedures
- ZD-57Actions for Auto Assist and action flows
- ZD-58Group-level permissions for Copilot
- ZD-65Analyzing AI-agent performance
- ZD-66Explore’s 37-month data retention limit
- ZD-83Enabling anyone to submit tickets
- ZD-84Permitting only added users to submit tickets
Zendesk partner guidance
- PT-013Li — The Zendesk Implementation Checklist (2026)
- PT-02Swifteq — Organizing knowledge for generative AI
- PT-03Swifteq — Zendesk Guide best practices
- PT-04Premium Plus — Zendesk AI agents
- PT-05Premium Plus — AI implementation: identify, build, test, optimize
- PT-06Salto — Organizing Zendesk triggers
- PT-07CRM Scene — Zendesk implementation checklist for growing teams
- PT-08Swifteq — Multilingual support in Zendesk