> ## Documentation Index
> Fetch the complete documentation index at: https://www.voiceflow.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Use agent assist with Zoom Contact Center

> Install Voiceflow agent assist for Zoom Contact Center. Load approved case context, choose a staff task and review suggestions in the Zoom Contact Center in-client app.

## Overview

Use the supported Zoom Contact Center app surface to follow the active engagement automatically. Staff receive approved case context and on-demand task results in the app panel.

Your team hosts the staff interface and case-access checks; Voiceflow runs the published read-only assistant. Tasks run only on a staff action. Automatic selection loads a snapshot, not a live transcript or a customer-send action.

| Capability | Supplied behavior |
| --- | --- |
| Staff surface | Zoom Contact Center in-client app |
| Case selection | Workspace/SDK binding with server authorization. |
| Tasks | Find policy, Draft reply, Suggest next step, Summarize and a question form. |
| Draft delivery | Copy completed suggestions for human review. |

<a id="requirements"></a>

## Prepare the staff deployment

Collect the assistant, verified identity and platform configuration once.

| Requirement | Owner and handoff |
| --- | --- |
| Published staff assistant | Voiceflow owner supplies approved Knowledge, project ID, Published test Environment alias and server API credential. Keep tools read-only. |
| Staff host | Application owner supplies Node.js 22+, HTTPS, verified staff/tenant sign-in, CSRF, body/rate limits and bounded provider reads. |
| Case access | Case-service owner approves the fields, checks staff/record access on every request and supplies the exact provider-to-case mapping. |
| Pilot platform | Administrator supplies the named app/launcher surface, test staff with allowed/denied records and the actual sandbox record IDs. |

Download the [starter bundle](/docs/examples/support-platforms-starter.zip). Keep `support-platforms`, `contact-center-assist` and `amazon-connect` as sibling directories. [Shared agent-assist setup](/docs/guides/integrations/contact-centers/agent-assist) owns the host/session contracts; [build the staff assistant](/docs/guides/agent-assist) before installing the platform entry.

<a id="installation"></a>

## Install the staff entry

Generate the platform files, connect authorized data and activate the pilot surface.

### 1. Build the platform files

From the extracted archive root, use your HTTPS staff origin without a path:

```bash title="Build the Zoom Contact Center staff app"
npm install --prefix support-platforms
node support-platforms/setup.mjs zoom-contact-center https://staff.example
```

Serve the generated `panel.html`, `panel.css` and `panel.bundle.mjs` together at `https://staff.example/support-platforms/zoom-contact-center/panel.html`. The command also writes `SETUP.md` and the applicable platform artifacts. Keep credentials on the server. It refuses an existing output directory; append a new directory after the origin when rebuilding. Configure no-store, approved iframe ancestors and embedded SSO.

### 2. Connect the authorized case reader

Use the existing authenticated host with [routes.mjs](/docs/examples/support-platforms/routes.mjs):

```js title="Mount both authorized staff routes"
import {createStaffRoutes} from './support-platforms/routes.mjs';
import {requireStaff,verifyCsrf,loadCaseForStaff} from './staff-adapters.mjs';
export const handleAssistRequest=createStaffRoutes({
  projectID:process.env.VF_PROJECT_ID,
  environmentAlias:process.env.VF_ENVIRONMENT_ALIAS,
  apiKey:process.env.VF_API_KEY,
  requireStaff,verifyCsrf,loadCaseForStaff,
});
```

`loadCaseForStaff(staff, id, {signal})` verifies the tenant, provider interaction/case mapping and permitted fields, then returns `{id, context: approvedText}` or `null`. It must not accept browser-posted context as evidence.

Mount the handler at **both** same-origin POST paths, `/api/agent-assist` and `/api/agent-assist/context`. Apply the host’s CSRF policy to both, a 32 KiB body limit, staff rate/concurrency limits and bounded identity/provider reads. Honor the supplied cancellation signal. The context route starts no Voiceflow session; every later task reauthorizes and reloads the record.

### 3. Activate the platform surface

Create or configure a **Zoom General app** for the **Contact Center** surface using the official Contact Center app guide. Set the generated HTTPS panel URL as the in-client Contact Center URL and configure the required domain/redirect allowlists and host security headers. Keep OAuth, staff-session mapping and app-context verification in the existing staff host; the SDK’s browser context is not a login.

Enable these SDK capabilities: `getEngagementContext`, `getEngagementStatus`, `onEngagementContextChange`, `onEngagementStatusChange`. The generated bundle includes `@zoom/appssdk@0.16.43` and configures SDK API version `0.16.0`. Authorize/install for licensed pilot agents and assign the app to the appropriate Contact Center queue/workflow using the current Zoom app setup. Test in the actual desktop client; an ordinary browser is not this surface.

The previous external companion remains a fallback when the account cannot install Contact Center apps. Build a manual panel using the documented option below; it does not inherit engagement events.

### 4. Load context and choose a task

Open the installed entry for an allowed sandbox record; confirm the selected ID without typing. Wait for **Case context ready** and inspect **Approved case context**. Denial keeps tasks disabled. Opening a record or loading context does not ask the model.

Choose **Find policy**, **Draft reply**, **Suggest next step** or **Summarize**. The question box is optional for these four actions; use it to focus the result. **Ask assistant** requires a question. Configure the assistant to return customer wording only for Draft reply and staff evidence/missing facts for the other tasks. Review model output before using it.

### Use the manual companion fallback

Keep task buttons and context checks when this account cannot supply the automatic surface.

Serve the starter’s original `panel.html`, CSS and module directories on the protected staff origin, with relative paths intact. It uses `start.mjs`: enter the authorized case ID, choose **Load case context**, then choose a task. Editing the ID disables tasks again. The manual companion does not inherit SDK events or screen-pop context.

<a id="case-context"></a>

## Configure case context

Treat workspace IDs as selection hints and keep approved data on the server.

The entry reads `engagementContext.engagementId`, checks engagement status and subscribes to context/status changes. Switching engagement clears the old result before loading the next snapshot; `state: "end"` clears/disables assistance. It also rechecks current engagement before a task. The backend must verify staff/account engagement entitlement and map it to approved case data; this SDK binding does not acquire audio or a transcript.

| Data boundary | Contract |
| --- | --- |
| Approved snapshot | The existing case/engagement service supplies an authorized snapshot. No Zoom transcript, caller data, saved notes or call-control operation is emitted by the browser entry. |
| Staff identity | Verified host session and tenant mapping; browser agent objects are not authentication. |
| Question and result | Render text safely; treat case text as reference data, not permission to run actions. |
| History | Fresh runtime conversation per task; no automatic case memory or full-history guarantee. |

Use **Copy suggestion** only after the complete result arrives, then review/edit it in the normal support workspace. This supplied surface has no verified draft-composer insertion action. A provider endpoint that sends a message or saves a note is not used as a substitute.

The host must reset/unload on logout and account changes. Browser abort stops consumption; it does not prove remote execution stopped or transcripts were deleted. Set expiry and retention with the owning teams. A snapshot above the starter’s 16,000-code-unit limit is rejected; narrow the approved fields instead of silently dropping conversation coverage.

<a id="testing"></a>

## Test the staff workflow

Check tasks, record changes, denial and the exact human delivery action.

### 1. Check the selected record and all four tasks

Use a sandbox case with an unopened item delivered 12 days ago and an approved 30-day policy. Confirm the visible record ID and approved snapshot. Run every task with an empty question, then add a focus. Verify policy conditions, missing facts and source references. Summaries must state gaps when the snapshot is metadata or a limited excerpt rather than a complete interaction.

### 2. Prove record isolation and access denial

Start a reply, then switch the selected workspace record before it completes. The old result must clear and never return. Clear/end the interaction where the surface supports it; test idle/non-record state as well. Use a second staff account for a denied record: no snapshot/answer may appear and no model request may start. Test logout, account switch and session expiry.

### 3. Review delivery and recover from failure

Copy one completed suggestion and review it in the normal composer. No provider send, saved note, refund or call-control request may occur. Verify a partial stream never enables Copy suggestion. Interrupt the stream and deny the provider read; the prior/partial result must clear. Restore the service and retry manually while keeping the normal support workspace usable.

### The entry or context does not load

Check platform assignment, direct origins and staff/provider access.

Verify the generated URL/artifacts, platform assignment and embedded sign-in. For parent messaging, verify both the direct source window and configured HTTPS origin; never use a wildcard. A 401 requires sign-in; 403 requires CSRF/tenant/record checks; 413 needs a narrower approved snapshot. Inspect redacted server diagnostics for provider/runtime failure. Reopen/reload after recovery without exposing the staff service publicly.

### The result belongs to an old record

Check whether this surface follows selection or opens a pinned companion.

Compare the visible ID with the workspace. For a pinned launch, open a new launcher for the current record; a separate tab cannot follow the original workspace. For SDK/property binding, repeat the switch during the pending response and check the direct parent/SDK events and generation guard. Do not rely on a network abort alone. Discard an uncertain result before continuing.

<a id="release-and-maintenance"></a>

## Release and maintain assistance

Record the accepted app, permissions and rollback before expanding access.

### 1. Release to the pilot staff

Record the staff-host build, provider field allowlist/mapping, platform configuration and Voiceflow Environment/release. Repeat allowed/denied cases through the actual installed entry with a fresh staff session. Assign owners for policy freshness, identity/token lifecycle, SDK/app updates and incidents; rerun [quality evaluation](/docs/guides/channels/agent-assist/evaluate-assistance) after changes.

### 2. Restore the reviewed deployment

Remove the Contact Center app assignment for the pilot queue/users or disable/uninstall the pilot General app through the approved Zoom configuration. Keep customer flows and numbers in place. Restore the recorded staff-host build and reviewed Voiceflow release, then repeat a fresh-session check.

Local review uses the starter’s labelled fictional fixtures; no SDK fixture or successful bundle proves provider installation, SSO, account permissions or real-model quality. Complete sandbox acceptance for this exact surface before release. For business-system tools, [Import help articles](/docs/guides/integrations/contact-centers) and Human agent hand-off, keep the canonical Integration manuals.
