Capability library / Application package

Five9 package v1.0.0

Read Five9 agent details, active calls, contacts, and queue wait times; update contacts, place outbound calls, and finish calls with a disposition. Covers the session-based Agent and Supervisor REST APIs, not administration.

Review state: In review · Not part of the reviewed release library

This page describes AAES Govern’s controls. AAES Operate has private-work permissions, operational reviews and recorded-spend limits; it does not include Govern. About AAES Govern

Before you enable this package

Draft package; not part of the reviewed library. Confirm endpoints and authentication against the provider contract before use. Replace the reserved .invalid host and review the egress allowlist.

Read each action's effects and exclusions below. Before installation, also read the complete package requirements, including credential issuance, scope, expiry, and provider permissions. These are deployment prerequisites, not capabilities this package supplies.

Capabilities (7)

Each capability below is one registered operation. The complete package JSON includes its exact network destination allowlist. The repository stores it at packs/five9.json and embeds a copy in the release binary.

Risk tiers. R0 is the minimum for reads. R2 is the minimum for write, create, update, execute, and invoke. R3 is the minimum for delete, send, pay, deploy, approve, share, and transfer. Operators can raise these levels. A minimum tier does not measure the operation's business or confidentiality risk.

On supported execution paths routed through AAES Govern, the R3 actions listed below require approval by an authorized person. Bypass paths and observation-only registrations are outside that guarantee. A provider's restoration feature does not remove this approval requirement. A provider-side approval, such as approving a GitLab merge request, is also separate from AAES Govern human approval. The capability matrix shows which execution paths are implemented, restricted to lab use, or refused at startup. Live compatibility must be tested in your environment.

Field guide. Endpoint is the service address and request method. Connector is the adapter that makes the call. Custody describes how the credential is held; the credential reference identifies the value to resolve. Data class sets handling requirements: pii means personal data, financial means financial records, and internal means internal organizational data.

five9.agent.info.read v1.0.0R0

Kind
tool
Action
read
Endpoint
GET https://five9-vcc.invalid/appsvcs/rs/svc/agents/AGENT_ID
Connector
http
Custody
customer_vault
Credential ref
secret-ref-five9-vcc-session-cookie
Data class
pii

Read agent info.

Read one agent's profile and state, which are personal data, through /appsvcs/rs/svc/agents/{agentId}, a path exercised by the retrieved starter kit. Bind AGENT_ID to a concrete agent and replace the reserved host with the customer's data-center API host before enabling.

five9.calls.read v1.0.0R0

Kind
tool
Action
read
Endpoint
GET https://five9-vcc.invalid/appsvcs/rs/svc/agents/AGENT_ID/interactions/calls
Connector
http
Custody
customer_vault
Credential ref
secret-ref-five9-vcc-session-cookie
Data class
pii

Read calls.

List an agent's active calls through the starter kit's agent-context /interactions/calls path. Records include customer numbers and campaign IDs and are classified as pii (personal data). Bind AGENT_ID and replace the reserved host before enabling.

five9.contacts.read v1.0.0R0

Kind
tool
Action
read
Endpoint
GET https://five9-vcc.invalid/appsvcs/rs/svc/orgs/ORG_ID/contacts/CONTACT_ID
Connector
http
Custody
customer_vault
Credential ref
secret-ref-five9-vcc-session-cookie
Data class
pii

Read contacts.

Read one contact's personal data through /orgs/{orgId}/contacts/{contactId}, a path exercised by the retrieved starter kit. Bind ORG_ID and CONTACT_ID and replace the reserved host before enabling.

five9.contacts.update v1.0.0R2

Kind
tool
Action
update
Endpoint
PUT https://five9-vcc.invalid/appsvcs/rs/svc/orgs/ORG_ID/contacts/CONTACT_ID
Connector
http
Custody
customer_vault
Credential ref
secret-ref-five9-vcc-session-cookie
Data class
pii

Update contacts.

Update one contact through PUT /orgs/{orgId}/contacts/{contactId}, as exercised by the retrieved starter kit. The unrestricted body can overwrite any writable field the session user has permission to change; the pack imposes no field-level limit. Bind ORG_ID and CONTACT_ID and replace the reserved host before enabling.

five9.supervisor.ewt.read v1.0.0R0

Kind
tool
Action
read
Endpoint
GET https://five9-vcc.invalid/supsvcs/rs/svc/orgs/ORG_ID/ewt/group/SKILL_GROUP_ID/MEDIA_TYPE_ID
Connector
http
Custody
customer_vault
Credential ref
secret-ref-five9-vcc-session-cookie
Data class
internal

Read estimated wait times.

Read expected wait time for a skill group on the supervisor-context path (/supsvcs/rs/svc/...), classified as internal data: an aggregate queue statistic, not customer data. This capability exercises the supervisor side of the Agent/Supervisor split; it grants nothing on the separate SOAP admin or statistics surfaces. ORG_ID, SKILL_GROUP_ID and MEDIA_TYPE_ID are placeholders the deployment binds before enabling, and the host is a reserved placeholder to substitute before enabling.

five9.calls.make_external v1.0.0R3

Kind
tool
Actions
create, send
Endpoint
POST https://five9-vcc.invalid/appsvcs/rs/svc/agents/AGENT_ID/interactions/make_external_call
Connector
http
Custody
customer_vault
Credential ref
secret-ref-five9-vcc-session-cookie
Data class
pii

Make external calls.

Initiate an outbound external call from the agent's session (agent-context POST .../interactions/make_external_call, as exercised by the retrieved starter kit): the effect rings a telephone number supplied in the request body and opens a live voice interaction with an end recipient, and the recipient may receive the call before any cancellation. The capability is registered as create and send at the minimum R3 tier — send is one of the designated actions requiring human approval.

On supported execution paths mediated by AAES Govern, irreversible actions require approval by an authorized person; this does not prevent calls through bypass or observation-only paths.

The request body carries the destination number and campaign id unrestricted, so the vendor action being a POST-create does not lower the effect; the dialed number is personal data. AGENT_ID is a placeholder the deployment binds before enabling, and the host is a reserved placeholder to substitute before enabling.

five9.calls.dispose v1.0.0R3

Kind
tool
Actions
delete, update
Endpoint
PUT https://five9-vcc.invalid/appsvcs/rs/svc/agents/AGENT_ID/interactions/calls/CALL_ID/dispose
Connector
http
Custody
customer_vault
Credential ref
secret-ref-five9-vcc-session-cookie
Data class
pii

Set call disposition.

Finish a call and record its disposition through PUT /interactions/calls/{callId}/dispose, according to the retrieved starter kit's method comment. The full developer guide was unavailable, so termination of active calls in every state has not been verified. Where this operation ends an active customer call, the interruption cannot be reversed.

The registration declares update for the disposition and delete for the possible termination, at R3. Delete requires human approval. Bind AGENT_ID and CALL_ID and replace the reserved host before enabling.

Credential reference

The credential field names a reference rather than containing credential material. Packs are designed not to contain secrets; the format checks cover only known credential formats and cannot prove that arbitrary text contains no secrets. Installing a package registers its capabilities. Configure the provider credentials, endpoints, and network access, then test the integration in your environment before enabling it.

Reference
secret-ref-five9-vcc-session-cookie
Custody
customer_vault
Injection
header (Cookie)

Configure the value and injection format specified in the package. Assign responsibility for credential rotation and revocation, restrict provider permissions, and keep credential material out of logs and responses.

Complete credential requirements

Store the complete Cookie header value for a dedicated Five9 VCC agent or supervisor user in the client's secret manager. An external deployment process logs in, captures the issued session cookie, and refreshes the reference. The executor injects that value unchanged and does not log in.

The retrieved sample authenticates through a logged-in browser session. The full developer guide is gated, and HTTP Basic or token authentication for server-side callers has not been verified. Obtain the guide's session, expiry, and revocation terms before enabling.

Confirm session expiry and logout invalidation against the vendor guide before enabling; neither behavior was verified against first-party operation documentation in this review. The retrieved sources do not establish that changing a password or disabling a user invalidates an existing session. Refresh before expiry; an expired session fails closed. On suspected exposure, terminate the session itself rather than relying on account changes.

Use a dedicated user with only the agent or supervisor permissions these capabilities need: the session inherits the user's full permissions. Keep its value only in executor memory for a call, never in logs, traces, diagnostics, or crash dumps. Do not enable the pack if the deployment cannot meet those requirements.

Resources

  • five9-vcc-agents (api, pii): https://five9-vcc.invalid/appsvcs/rs/svc/agents
  • five9-vcc-contacts (api, pii): https://five9-vcc.invalid/appsvcs/rs/svc/orgs/ORG_ID/contacts
  • five9-vcc-supervisor (api, internal): https://five9-vcc.invalid/supsvcs/rs/svc

Technical package and review record

Complete provider requirements and exclusions

Draft: the full Five9 Agent and Supervisor REST API developer guide was unavailable during review. On 2026-09-21, developer.five9.com remained unreachable and the vendor-hosted guide redirected to a login-gated portal; apidocs.five9.com was also unavailable in the review environment. Session, expiry, revocation, and call-disposition behavior across states remain unverified. Obtain those terms before enabling.

The registered paths come from the Five9 Developer Program's starter-kit repository, its agent_VCC_boilerplate.html sample, and the publicly hosted CRM SDK documentation. The repository's own README states that it is not an official or supported Five9 resource.

API coverage: this pack covers real-time call control and supervision through the session-based Agent and Supervisor REST API, with agent paths under /appsvcs/rs/svc and supervisor paths under /supsvcs/rs/svc. It does not cover the separate Configuration Web Services SOAP/WSDL API (users, campaigns, calling lists, skills, and dispositions, on api.<region>.five9.com or api.five9.com /wsadmin/...), which uses its own admin credentials, or the Statistics Web Services SOAP API. Domain administration needs a separate registration and review.

Host setup: a logged-in session calls https://app.five9.com/appsvcs/rs/svc/auth/metadata to obtain its data-center API host and port from metadata.dataCenters[].apiUrls[]. Replace the reserved five9-vcc.invalid host in every endpoint, resource locator, and egress allowlist entry together. The allowlist matches the authority exactly. If the returned port is not 443, review that port as well; the entries here specify the authority only.

Authentication: the retrieved sample uses browser session credentials (fetch credentials: 'include'). This pack stores a session cookie in the customer's vault and requires an external process to obtain and refresh it. No bearer scheme was verified; whether the gated guide supports HTTP Basic or API tokens for server-side callers remains an open review item.

Approval classification: calls.make_external places a live outbound call and declares create and send at R3; send requires human approval. calls.dispose records a disposition and finishes a call according to the sample, but termination behavior in every state is unverified. Where it ends an active customer call, that interruption cannot be reversed. Although update has an R2 floor, this capability declares delete and update at R3 to cover the possible termination.

Excluded operations: Configuration Web Services and Statistics Web Services; recording views and downloads (including POST /supsvcs/rs/svc/supervisors/{id}/agents/{id}/recording_views, which exposes recorded customer conversations); contact deletion and do-not-call (DNC) list changes; campaign start/stop and calling-list loading, which can drive mass outbound dialing; supervisor monitoring, whisper, and barge-in; and WebSocket event channels. Each requires its own registration and review.

Re-review on 2026-10-29: the legacy vendor PDF URL still redirected to the Five9 Documentation Center login portal. The guide bundle, its table of contents and a candidate vendor-hosted raw PDF were inaccessible through the web reader. The public Technical Requirements guide names the Agent and Supervisor REST API guide but supplies no registered operation contract. The Five9 GitHub organization lists admin and chat samples, not this REST reference. All seven operations and the session contract remain unverified against first-party operation documentation; keep this pack disabled.

Download the complete package JSON for exact network allowlists, credential requirements, exclusions, and setup notes. Read these requirements before installation.

The full documentation review record is supplied in the evaluation package. The evaluation package runs in your environment and comes only with the paid design partnership. This page reproduces the source links and review block; the full record is available for evaluation. Discuss a design partnership to inspect it before installation.

Review block

This section reproduces the review block recorded in the pack file. The evidence and approval record is separate: for a reviewed pack, it is in the evaluation materials and in the release binary's embedded assets.

Review in progress; record dated 2026-10-29

4 sources, retrieved 2026-09-21

Current documentation links are navigation aids. They do not change the package, its historical sources or its review date. Review dates describe a documentation review, not a live integration test. No package is provider-endorsed or yet tested against a live provider tenant.

Release identity

SHA-256 of the pack file bytes: 9a017dfb1ebe79fe8d20c87c07fe1d272f45a1f1556cfd0ca612ece902a914a7

Not part of the reviewed release library. Editing a package changes its release identity. A deployment plan checks its own file digests; it does not restore reviewed status or authenticate approval.