CreateBlogSupport
Log inSign up
Home
Webex Contact Center
  • Overview
  • Guides
  • API REFERENCE
  • AI
  • Configuration
  • Data
  • Desktop
  • Journey
  • Media And Routing
  • Changelog
  • SDK
  • Customer Journey Data Service
  • AI Assistant for Developers
  • Webhooks
  • Contact Center Sandbox
  • Using Webhooks
  • Beta Program
  • Webex Status API
  • Contact Center Service Apps
  • FAQs

Webex Contact Center

Events

Events in the Webex Contact Center Web SDK are required for multi-session environments, to ensure that your application stays synchronized across browser tabs and reacts promptly to agent and task updates.

Refer to the Quickstart Guide to initialize webex, register the agent, and set up your webex.cc listeners.

anchorAgent Events

anchor
EventDescriptionPayload
agent:stationLoginSuccessEmitted after a successful station login.AgentStationLoginSuccess object
agent:stationLoginFailedEmitted if the station login attempt fails.-
agent:reloginSuccessEmitted after a successful re-login to the station.AgentStationLoginSuccess object
agent:logoutSuccessEmitted after the agent logs out successfully.AgentLogoutSuccess object
agent:logoutFailedEmitted if the agent logout attempt fails.-
agent:stateChangeSuccessEmitted when any agent state change notification is received.AgentStateChangeSuccess object
agent:stateChangeFailedEmitted when a state change request fails.-
agent:multiLoginEmitted when the agent logs in from another station or session.-
agent:dnRegisteredEmitted when the agent DN is registered successfully.-
AgentStationLoginSuccess
{
  agentId: string;
  agentSessionId: string;
  auxCodeId: string | null;
  chatCount: number;
  deviceId: string;
  deviceType: "BROWSER" | "EXTENSION" | "AGENT_DN";
  dn: string;
  emailCount: number;
  eventTime: number;
  interactionIds: string[];
  lastIdleCodeChangeTimestamp: number;
  lastStateChangeTimestamp: number;
  mmProfile: { chat: number; email: number; social: number; telephony: number; };
  notifsTrackingId: string;
  orgId: string;
  profileType: string;
  roles: string[];
  siteId: string;
  skillProfileId: string;
  skillProfileName: string;
  skills: string[];
  status: string;
  subStatus: string;
  teamId: string;
  trackingId: string;
  type: "AgentStationLoginSuccess";
  voiceCount: number;
}
AgentLogoutSuccess
{
  data: {
    agentId: string;
    agentSessionId: string;
    eventTime: number;
    loggedOutBy: "SELF" | "SYSTEM";
    logoutReason: string;
    orgId: string;
    roles: string[];
    status: "LoggedOut";
    subStatus: string;
    trackingId: string;
    type: "AgentLogoutSuccess";
  };
  orgId: string;
  trackingId: string;
  type: "Logout";
}
AgentStateChangeSuccess
{
  data: {
    agentId: string;
    agentSessionId: string;
    auxCodeId: string | null;
    changedBy: "SELF" | "SUPERVISOR";
    changedById: string;
    changedByName: string;
    connectedChannels: string[];
    eventTime: number;
    lastIdleCodeChangeTimestamp: number;
    lastStateChangeReason: string;
    lastStateChangeTimestamp: number;
    orgId: string;
    status: string;
    subStatus: string;
    trackingId: string;
    type: "AgentStateChangeSuccess";
  };
  orgId: string;
  trackingId: string;
}

anchorTask Events

anchor
Task Payload
// task.data
{
  agentId: `string`,                // agent's unique ID
  eventTime: `number`,              // timestamp in epoch ms
  interaction: {
    interactionId: `string`,        // interaction ID
    createdTimestamp: `number`,     // epoch ms when interaction started
    currentVTeam: `string`          // current virtual team (queue) ID
  },
  mediaType: `string`,              // "telephony" | "chat" | "email" | "social"
  contactDirection: { type:`string` }, // "INBOUND" | "OUTBOUND"
  state: `string`,                  // e.g., "connected", "consulted", "new"
  orgId: `string`                   // organization ID
}
EventDescriptionPayload
task:hydrateEmitted when active tasks are restored during a session resume or page reload.Task object
task:incomingEmitted when a new task reservation arrives for the agent.Task object
task:offerContactEmitted when a direct contact offer is pushed to the agent.Task object
task:assignedEmitted when a task has been fully assigned to the agent.Task object
task:holdEmitted when the agent puts the task on hold.Task object
task:unholdEmitted when a held task is resumed.Task object
task:endEmitted when a task completes or is ended.{Task object, wrapupRequired: boolean} (Indicates if we need to wrapup the task or now)
task:wrapupEmitted when wrap-up is initiated on a task.Task object
task:wrappedupEmitted when wrap-up completes and the task is removed.Task object
task:recordingPausedEmitted when call recording is successfully paused.Task object
task:recordingPauseFailedEmitted when pausing call recording fails.Task object
task:recordingResumedEmitted when call recording is successfully resumed.Task object
task:recordingResumeFailedEmitted when resuming call recording fails.Task object
task:consultCreatedEmitted when the agent initiates a consult on an existing task.Task object
task:offerConsultEmitted when another agent offers a consult request.Task object
task:consultingEmitted when a consult is active (on both sender and recipient sides).Task object
task:consultAcceptedEmitted when an incoming consult offer is accepted.Task object
task:consultQueueCancelledEmitted when a queue-based consult is cancelled before it reaches a queue.Task object
task:consultQueueFailedEmitted when a queue-based consult fails.Task object
task:consultEndEmitted when a consult ends on this task.Task object
task:rejectedEmitted when the agent rejects a task (RONA).reason: string (Reason for task rejection)
task:mediaEmitted on arbitrary media changes within the task.Task object
In This Article
  • Agent Events
  • Task Events

Connect

Support

Developer Community

Developer Events

Contact Sales

Handy Links

Webex Ambassadors

Webex App Hub

Resources

Open Source Bot Starter Kits

Download Webex

DevNet Learning Labs

Terms of Service

Privacy Policy

Cookie Policy

Trademarks

© 2025 Cisco and/or its affiliates. All rights reserved.