Agent call adapter

This guide walks agents through the main functions and settings related to using the Agent call adapter.

The following screenshot illustrates the locations for the main call adapter menus. See the following sections for descriptions of the menu options available under each.

Status bar

You can click the status bar to view a drop-down menu of available Status options. When you sign in to the call adapter, your status is set to Unavailable by default.

You can change your agent status at any time, unless you are in an active call.

Network menu

Select the network menu to view its three sub-sections. The network menu also includes a Send Report button at the bottom. You can click this button to send a report if you are experiencing network issues.

  • Network Info: Displays your current network status.
  • Permissions: Displays your current permissions.
  • Sound: Lets you preview your notification tones and whisper notifications (spoken notifications).

Options menu

Click the Options menu to see the option to Log Out of the Call Adapter. The Options menu also contains two sub-menus, Language and Stats.

  • Language: You can select your language using this menu.
  • Stats: Displays your daily individual and team average statistics for Calls Today (number of calls), Duration (average length of each call), CSAT, and Sentiment Score.

Call tab

Click the Call tab to make an outbound call.

History tab

Click the History tab to view all of your previous calls. The toggle at the top of the Adapter lets you choose between viewing all calls or only Missed calls.

Click an individual call to view its Call details. This displays information about the call and includes an option at the top to either copy the CRM link into your browser or open the case in the CRM directly. You can then make any changes necessary to the case, provide updates or add additional information. You also have the option of calling the end-user back from this screen by clicking on the phone icon to the right of their phone number.

When you click a Missed call you will see additional information about the call. This includes whether or not the end-user received help from another agent, so you know if you need to call the end-user back. This information is indicated in the Call Status field.

Voicemail tab

Select the Voicemail tab to see your unanswered voicemail in each queue, as well as voicemail history. You can use the toggle at the top of the screen to switch between the Queue and History options.

  • Queue: This tab displays all unanswered voicemails by queue as well as personal voicemails, depending on your configuration. The number of voicemails in each mailbox is indicated next to the queue name.
  • History: This tab displays all voicemails by queue as well as personal voicemails, depending on your configuration. The number of voicemails in each mailbox is indicated next to the queue name.

When you select a queue to listen to voicemails the voicemails are played in order, whether unanswered voicemails or historical voicemails. A specific voicemail cannot be selected from the list.

Listen to voicemail messages

After the voicemail has finished playing, you have the option to Forward, Dismiss, or Call Back. You can switch tabs while listening to a voicemail but cannot start an outbound call.

  • Dismiss: Moves the voicemail to your voicemail history. Dismissed voicemails still generate a ticket in the CRM.
  • Forward: Click this option to display a list of available destinations to forward the voicemail. Depending on your configuration you will see Queue or Agent options, which you can switch between by clicking on the tab. You will see a notification banner when the voicemail has been successfully forwarded.
  • Call Back: Select this option to call the end-user back. You must wait for the voicemail to finish playing before you can make an outbound call.

Voicemail in Zendesk

Private comments will be posted when a voicemail is left, listened to, or if a callback is made through the Agent Adapter.

  • A media player lets you listen to the voicemail and information about the time, date, and the name of the queue called are included in the voicemail name.

  • Different statuses will be seen depending on how the voicemail is managed.

    • Voicemail Played: Seen if the agent listened to the voicemail in the agent widget.

    • Voicemail Dismissed: Seen if the agent listened to the voicemail in the agent widget and dismissed it without calling the customer back.

    • Called Back Customer: Seen if the agent calls the customer back through the agent adapter after listening to the call in the agent adapter

Voicemail in Salesforce

The voicemail will be associated with an attachment to a new task in Salesforce, available in the Activity History section. To listen to the voicemail:

  1. From the case created in Salesforce, select the subject of the Task.

  2. Click the Attachment file name.

  3. Click View File to listen to the voicemail.

In-call menu

When you are in an active call, a menu appears that lets you take multiple actions. Some in-call features are optional and won't appear on the screen unless your Admin has enabled them. These optional features are marked as Optional in the following list.

  • Mute: Mutes your microphone but keeps the call going.

  • Hold: Places the caller on hold.

  • Transfer/Add: This button provides you with three options for transferring or conferencing calls, visible as tabs across the top of the screen: Queue, Agent, or Outside line. In each case you have the option of transferring or adding your selection to the call. For a warm transfer, stay on the call until the transfer is completed, then then click End Call. For a cold transfer, end the call to complete the transfer after selecting the destination. Cold transfers can only be sent to agents or final leaf queues.

  • (Optional) Redact: Click this button to stop recording. You will see a banner showing that the call is redacted and the duration of the selection.

  • (Optional) Agent Assist: This button opens the Agent Assist menu, which will optionally display the Knowledge Assist and Live Transcripts options.

  • (Optional) Knowledge Assist: Displays a list of relevant articles, if any. If there are no relevant articles the list will be blank. Select an article to open and read it.

  • (Optional) Live Transcript: Displays speech bubbles for each message to and from the end-user.

  • (Optional) SmartActions: Most SmartActions are only available when the end-user calls in using Mobile SDK. Which options are available depends on your organization's configuration. Click the SmartActions button to open the SmartActions menu. Here you will find options to:

    • Request payment
    • Request verification
    • Request a photo
    • Request a video
    • Request text input
    • Request a screenshot
    • Begin a Co-browse session
    • Use the Virtual Task Assistant
    • Send SMS messages to install or open apps
  • Hang up and Call Back: Click this button to hang up and call the end-user back. This will create a new outbound call and you will see an Account details record in the In-Call menu until the call connects.

  • End call: Terminates the call.

  • Details tab: Select the Details tab at the bottom of the screen to see shortcuts to the CRM, an option to enter notes, and call and caller information. If you open the notes section, you will see a place to enter your notes. They will be automatically imported to the CRM at the end of the call.

Receive and make calls

This section describes how to receive inbound calls and make outbound calls.

Receive an inbound call

The first step of receiving a call is answering it. Answering a call varies slightly depending on whether auto-answer is enabled. For more information, see Auto-answer.

To receive an inbound call:

  1. Answer the call:

    • If auto-answer is disabled, a notification banner appears on your screen notifying you of an inbound call. Click the banner to answer the call.

    • If auto-answer is enabled, an Incoming call screen appears in the call adapter and the target pick-up time and countdown timer display. Click Answer to answer the call.

  2. After you answer the call, the following sequence begins in the call adapter:

    1. A new screen appears that displays caller information, queue information, and the support phone number that the caller used.

    2. A final countdown timer appears for the start of the call. If the caller has multiple accounts, you have the option to choose which account to attach to the call.

    3. The call starts.

Make an outbound call

To make an outbound call:

  1. In the call adapter, click Start call.

    • If you have a Salesforce or Zendesk customer relationship management (CRM) app, click the phone number that you want to dial, paste a phone number into the call adapter, or dial the number.

    • If you have a CRM app other than Salesforce or Zendesk, paste or dial the phone number.

    • If you don't have a CRM app, dial the phone number.

  2. Click Next. The call information displays.

  3. Optional: If you have a CRM app and there is no account ID for the phone number that you are calling, click the open_in_new open icon next to Account ID to open your CRM app and create an account.

  4. Optional: Click the arrow next to Language to switch to a different language, if available.

  5. Optional: Click the arrow next to Outbound number to switch to a different outbound number, if available.

  6. Click Call. The Calling screen appears.

  7. Wait for the end-user to answer the call.

Transfer calls

In CCAI Platform, you can either warm transfer or cold transfer end-users to another agent or queue. In a warm transfer the end-user stays on the line and talks to the next agent before the transfer is complete. Cold transfers assign the end-user to the new agent or queue without the original agent staying on the line.

Transfer details

Transferring a call to a Team is not supported at this time. Agent assignments are based on queues. Set up a team-specific queue if this option is required for your workflow.

  • Available agents can receive transfer calls. Unavailable Agents can also receive transfers, if enabled at Operations Management > Agent Status.

  • For IVR calls, agents will only see the IVR-specific queues. The same applies to Mobile and Web calls.

  • Automatic Redirection: When a call is transferred to a queue with an Automatic Redirection active, the call will follow the Automatic Redirection path just as a new call would. Leave Ongoing Calls with 3rd Parties must be enabled Settings > Call.

  • After Hour deflection: If the Automatic Redirection for a queue is set to message or voicemail, transfers to a queue outside of operating hours will follow the After Hour deflection. If Automatic Redirection is set to queue or phone number, Automatic Redirection will take priority over After Hours deflection.

  • Overcapacity Deflection: Warm transfers don't trigger the Overcapacity Deflection. Only cold transfers are deflected when Overcapacity Deflection is enabled.

  • Call Priority: Transferred calls have higher priority than standard inbound calls by default.

  • Call Duration: The call duration starts at the initial call pickup and remains for the duration of the call to properly represent how long the caller has been on the call. It does not reset when transfers take place.

  • Call Recording: When enabled, the call recording won't capture the portion of the call after the agent leaves if a call is transferred to a 3rd party.

Warm transfer

Warm transfers can be done with the end-user on hold or not on hold, or a combination of both. We suggest putting the caller on hold so that you can bring them in as soon as the transfer is about to be completed. This gives you a chance to tell the next agent why they are being transferred and any other details that makes the experience smoother for the end-user. Warm transfers don't trigger Overcapacity Deflection (if configured).

  • Click Hold to place caller on hold (they will hear hold music).

  • Click Transfer to initiate the transfer action.

  • You can use the search field to search for an agent, manager, or queue. Predicted wait times, after hours, and redirection settings for the queue are included in this view so you have an idea of what the caller can expect. A green phone icon indicates the queue is set to Automatic Redirection. A moon icon indicates the queue is outside of the set hours of operation.

  • After the new agent joins the call, the caller is still on hold and cannot hear the agent's conversation. Click Hold again to take the caller off of hold.

  • Click End call to complete the transfer.

Cold transfer

Cold transfer is especially useful in a busy contact center where the original agent cannot stay on the line with the caller until the next agent picks up. When you hang up during a cold transfer, the caller is subject to overcapacity deflection, if it is enabled. After you have selected a destination for a cold transfer, end the call to complete the transfer rather than waiting on the line.

Add a third party to a call

When on a call, you can add a vendor or any other outside participant to create a conference call. You can also call another party and speak to the other caller while the first caller is on hold, then return to the first caller without connecting the two callers.

  • Click the Hold button to place the current caller on hold.

  • Click Add Party to bring up the dial pad.

  • Enter the third party number.

  • Click the Call button to dial out to the third party. You'll see both the first caller and the third party listed in your adapter. You can put either of these parties on hold if needed. If a party is on hold, they will hear hold music but not your conversation.

  • Remain on the line, complete the call as normal, and click Done when you are finished;


  • If you want to leave the call so that the two (or more) callers on the line remain on a call but you are no longer connected, click Done.

Post-call menus and actions

After the call is completed, click End call. You will see a screen indicating that the call has ended along with an option to call the customer back if needed, or to move to the next agent status.

(Optional) If Wrap-Up is enabled you will be placed into the Wrap-up screen after the call has ended. Here, you can set your case disposition and complete your notes. After the disposition and notes are complete, click Submit to add them to the CRM. If your wrap-up time is exceeded, your status will automatically change and a banner notification will appear to indicate next steps. After you click Submit you will see a new banner notification indicating that the wrap-up was successfully sent. You must manually set your status to Available in order to receive new calls.