What are Marketplace Actions in ZVA
Marketplace Actions are reusable integrations in the Zoom App Marketplace. You can integrate the Zoom Virtual Agent with external systems using Marketplace Actions in the Zoom App Marketplace. This approach enables your agent to retrieve real-time data, such as order status, customer records, and ticket updates, during conversations.
This guide shows how to:
- Configure a Marketplace app and API endpoints
- Create reusable Marketplace Actions
- Sync actions with Zoom AI Studio
- Invoke actions from Virtual Agent skills
- Map input and output variables for dynamic responses
- Use this pattern to extend conversational workflows with secure, real-time data from any external service.
How the integration works
The integration uses a service invocation model that connects your Virtual Agent to external APIs through a Marketplace app.
Components
| Component | Purpose |
|---|---|
| Virtual Agent | Handles user conversations |
| AI Studio | Defines agents, skills, and tools |
| Marketplace app | Exposes external APIs as actions |
| External API | Processes requests and returns data |
End-to-end flow
- User sends a message to the Virtual Agent.
- The agent matches the request to a skill.
- The skill invokes a Marketplace Action.
- The Marketplace app sends an HTTP request to your API.
- The API processes the request and returns data.
- AI Studio maps the response to variables.
- The agent generates a natural language response. This flow ensures consistent, secure access to external data during conversations.
When to use Marketplace Actions
Use Marketplace Actions when you need to:
- Expose external APIs to Virtual Agent workflows
- Build reusable integrations across multiple Zoom accounts
- Support secure authentication (for example, OAuth 2.0)
- Enable real-time data retrieval during conversations
Note: Route all sensitive payment data through secure external systems. Do not process PCI-related information directly in Virtual Agent.