Contents
- User Guide
- Availability
- Contacts
- Add External Contacts
- Import Contact Lists
- Contact List Definitions
- Chats
- Search from Cisco Jabber Chat Windows
- Start Group Chats
- Windows
- Block Specific Contacts and Domains in Cisco Jabber for Windows
- Allow Specific Contacts and Domains in Cisco Jabber for Windows
- Manage Status Requests in Cisco Jabber for Windows
- Chat Rooms in Cisco Jabber for Windows
- Windows
- Windows
- Filter Rooms in Cisco Jabber for Windows
- Mentioning Users in Cisco Jabber for Windows Chat Rooms
- Windows
- Calls
- Send Call Icons To Contacts in Cisco Jabber for Windows
- Arrange Video Devices
- Windows
- Meetings
- Windows
- Integrate Cisco Jabber for Windows with Calendars
- Integrate Cisco Jabber for Windows with Google Calendar
- Allow Access to Google Calendar
- Remove Google Calendar Integration in Cisco Jabber for Windows
- Windows
- Accessibility
- Grayscale Status Icons
- Keyboard Shortcuts
- Keyboard Navigation
- Troubleshooting
- Verify Audio and Video Device Settings
- Unable to Access Cisco Jabber Features
- Set Video Preferences for Cisco Jabber Calls
- Change My Profile Picture in Cisco Jabber
- Create a Problem Report After a Client Error
- Create a Problem Report from the Help Menu
- Create a Problem Report from the Windows Start Menu
- Virtualization Experience Media Engine
- Cisco Unified Communications and the Virtual Environment
- Device Management
- Use Device Selector
- Cisco VXME, Screen Lock, and Call Control
- Cisco Approved Audio and Video Accessories
User Guide
Availability
Contacts
Add External Contacts
ProcedureCisco Jabber lets you add contacts from chat applications that are external to your organization. You can also add custom contacts for people without an IM address.
Your system administrator must enable this feature. If you cannot add external contacts, ask your system administrator for help.
Import Contact Lists
Procedure
Cisco Jabber imports the contacts from the definitions file. The contacts are available in your contact list.
Contact List Definitions
The following XML snippet shows the structure of a contact list definitions file:<?xml version="1.0" encoding="utf-8"?> <buddylist> <group> <gname>Group Name</gname> <user> <uname>IM Address</uname> <fname>Display Name</fname> </user> </group> </buddylist>The following table describes the elements in a contact list definitions file:
Element Description <?xml version="1.0" encoding="utf-8"?> XML declaration. buddylist Root element of the contact list definition. group Parent element of a contact group. One group can contain multiple users.
There is no limit to the number of users a group can contain. There is also no limit to the number of groups you can include in a contact list definitions file.
However, your server sets a restriction to the number of contacts that you can add to Cisco Jabber. You must ensure you do not exceed that limit in your contact list definitions file.
gname Specifies the name of the group. user Parent element that holds details for a single user. uname Specifies the instant messaging (IM) address of a user. fname Specifies the name that displays in the client user interface. The following is an example XML definition of a contact list that you can import into Cisco Jabber:<?xml version="1.0" encoding="utf-8"?> <buddylist> <group> <gname>Sales</gname> <user> <uname>amckenzi@example.com</uname> <fname>Adam McKenzie</fname> </user> <user> <uname>aperez@example.com</uname> <fname>Anita Perez</fname> </user> </group> <group> <gname>Marketing</gname> <user> <uname>nfox@example.com</uname> <fname>Nancy Fox</fname> </user> </group> </buddylist>Chats
Search from Cisco Jabber Chat Windows
Start Group Chats
ProcedureYou can use group chats to send instant messages to two or more contacts at the same time. Group chats are not persistent, meaning that you can use them to create a chat with two or more people but no history is stored.
Windows
Block Specific Contacts and Domains in Cisco Jabber for Windows
ProcedureYou can block specific contacts or domains. When you block a contact, that person cannot view your availability status or send you instant messages.
NoteIf you add a contact to your block list, and that contact has you in their contact list, that person cannot view your availability status or send you instant messages.
The following are examples of how the block list works:
- Example 1: Block specific contacts inside your organization
You add an IM address to your block list. That contact cannot view your availability status or send you instant messages.
- Example 2: Block specific domains
You add a specific domain, such as cisco.com, to your block list. No contacts who have IM accounts at that domain can view your availability status or send you instant messages.
Allow Specific Contacts and Domains in Cisco Jabber for Windows
ProcedureSome deployments of Cisco Jabber include an allow list that adds exceptions to the block list. You can enter specific contacts or domains in your allow list to ensure those contacts can view your availability status and send you messages.
NoteCisco Jabber uses your contact list as an allow list. You do not need to add contacts in your contact list to your allow list.
The following are examples of how the allow list works:
- Example 1: Allow specific contacts inside your organization
- Cisco Jabber blocks all contacts inside your company, except for those specific people in your allow list.
- Example 2: Allow specific domains
- Cisco Jabber blocks everyone outside your company, except for people who have IM accounts at cisco.com.
- Example 3: Allow specific contacts from blocked domains
- Cisco Jabber blocks all people who have IM accounts at cisco.com, except for anitaperez@cisco.com.
Manage Status Requests in Cisco Jabber for Windows
ProcedureSome deployments of Cisco Jabber let you manage notifications when people request to view your availability status.
Chat Rooms in Cisco Jabber for Windows
You can use chat rooms if they are enabled by your administrator. Chat rooms are enabled if there is a Chat Rooms icon on your hub window.
Use chat rooms to join or read discussions on the theme of the room with the other chat room members. For example, your administrator may create a themed chat room such as "Foreign Exchange Rates", where you can join this room to discuss the foreign currency exchange rates and view all previous messages sent to the room since its creation.
You can browse all rooms by viewing a list of room names, join open rooms, or be added to a room by an administrator. You can be a member of multiple rooms. You can filter room content by keywords or senders.
Windows
ProcedureJoining a chat room allows you to participate in the conversation or read what is being said, where multiple chat room members share information in a common chat window. All of the rooms that you are a member of are listed in your My rooms tab. If an administrator adds you to a chat room, it is displayed immediately in your My rooms tab.
Step 1 Click the Chat Room icon in the Hub window, and select the All Rooms tab. Step 2 Browse for a room, which are listed alphabetically. If a room is restricted to specific members, you cannot join the room unless you are added by an administrator. For the restricted rooms that you are not a member of, you see a lock icon instead of the Join button. Step 3 Click Join beside the room that you want to join. The rooms where you are already a member have a checkmark beside them.
Windows
Procedure
Step 1 Select the Chat Room icon on the hub window, and select My Rooms to view the rooms where you are a member. Step 2 Double-click on the room that you want to enter. Step 3 View the current participant list on the right side of the chat window. You can show or hide the participant list. Step 4 Read the discussion and enter your own chat messages. The history of the conversation is persistent. When you exit the chat room and close the client, you can return to the conversation in that room. When you return to the chat room, you can view the messages that were sent by other members while you were not logged in. From the chat room, select Show More to view older messages.
Filter Rooms in Cisco Jabber for Windows
ProcedureYou can create notifications in chat rooms that tell you whenever a key word is used, or a certain user makes a comment, or your username is mentioned. These notifications are based on filters. Filters search chat room using the criteria that you define for the search. So after you create a filter, then you get notified about any conversations that happen in the chat rooms that match your filter criteria. You see a red notification on the hub window which displays the number of new matches found for your filter. Filters can include mentions when your username is used in a chat room, or custom filters that search by keyword or sender.
Step 1 In the client, select Create Filter. , then select Step 2 Give the filter a label and then define the filter criteria. You can filter chat rooms using up to three keywords or by username. You must define at least one keyword or the username of the sender, but you can specify the sender and up to three keywords. Step 3 Select Create. Results are listed on the Filter tab, with a number to indicate how many results were found that you have not read. Results are updated automatically each time a new match for your filter is made. When you have matches on your filter, you can click on the filter match to open the chat history in the rooms where the matches were found.
Mentioning Users in Cisco Jabber for Windows Chat Rooms
When other users mention your username, it creates a notification in the My mentions section of your chat room filters. Mentioning other users notifies them that they were mentioned in a chat room.
Before You BeginProcedure
Users only receive a notification if the chat room is public and the user is part of the organization, or they are a member of the chat room.
Mentions must be enabled by your system administrator.
Step 1 To create a mention for another user, in the text box of the chat window in a chat room, type the @ symbol followed by the person's user name to search the directory for the user. The client displays user names that match what you are typing. Step 2 Select the username that you want to mention. You can mention a username that does not have a Jabber ID associated with it. You can use the @ symbol as part of your text entry. Step 3 Use the Esc key to exit the mention field.
After you send the message, a notification is created for the mentioned user in their My mentions list, with a link to the conversation in the room where the mention was made.
Windows
ProcedureYou can search chat rooms by keywords, and further refine your keyword search with criteria such as participants, room name, and date range.
Step 1 In the client window, select the Chat Rooms icon, then select the Filters tab. Step 2 Enter search criteria in a search box, just like you search for contacts in your Cisco Jabber hub window. The following restrictions apply to chat room searches: Step 3 Double click on a result to open the persistent chat room where the search got a match.
Results are sorted chronologically and grouped by room. The maximum number of results displayed is 200, although you can show more messages to display older results.
Calls
Send Call Icons To Contacts in Cisco Jabber for Windows
ProcedureYou can send a call icon to another user in a chat window that they can simply click on to call you. These call icons give you an easy way to request calls from contacts. When someone receives a call icon, they can simply click on the icon to start a phone call with you.
Enter either of the following commands in a chat window to sends the person or people in your chat window an icon of a telephone. Your contacts can click on the telephone icon to start a call with you. :callme or :telephoneMeetings
Windows
Procedure
Step 1 From the hub window, open the Settings menu, and go to Options. If you’re on an earlier version of Cisco Jabber for Windows, select instead. Step 2 When the Options window opens, select the Meetings tab, then Edit account. Step 3 From the WebEx Site drop-down list, select New Site. Step 4 Enter all of the required information, including the name of the Cisco WebEx site that you want to add to your Cisco Jabber client, for example, cisco.webex.com.
Integrate Cisco Jabber for Windows with Calendars
Procedure
Step 1 From the hub window, open the Settings menu, and go to Options. If you’re on an earlier version of Cisco Jabber for Windows, select instead. Step 2 Select the Integration tab. From release 11.0 onwards, this tab is called the Calendar tab.
Step 3 Select the application that you use to organize your calendar. If you integrate with Google Calendar, you must allow it access.
Step 4 Select to close Cisco Jabber. Step 5 Restart Cisco Jabber.
Integrate Cisco Jabber for Windows with Google Calendar
When Cisco Jabber restarts, a Google Calendar Sign In window opens. You must enter your account details so that Cisco Jabber can access events in Google Calendar.
Before You BeginProcedureSelect Google Calendar on the Integration tab (Calendar tab from release 11.0) and restart Cisco Jabber.
Step 1 Enter your Google account username and password and then select Sign in. A prompt displays to notify you that Cisco Jabber is requesting permission to manage your calendar.
Step 2 Select Allow access. Step 3 If prompted, select Yes to continue running scripts on the page. The first time you allow access to your Google Calendar, you might notice an error message that indicates an error occurs with scripts on the page.
The Google Calendar Sign In window closes.
Step 4 On the main Cisco Jabber window, select the Meetings tab on the left side navigation. Cisco Jabber displays calendar events from your Google Calendar account.
Allow Access to Google Calendar
When Cisco Jabber restarts, a Google Calendar Sign In window opens. You must enter your account details so that Cisco Jabber can access events in Google Calendar.
Before You BeginProcedureSelect Google Calendar on the Integration tab (Calendar tab from release 11.0) and restart Cisco Jabber.
Step 1 Enter your Google account username and password and then select Sign in. A prompt displays to notify you that Cisco Jabber is requesting permission to manage your calendar.
Step 2 Select Allow access. Step 3 If prompted, select Yes to continue running scripts on the page. The first time you allow access to your Google Calendar, you might notice an error message that indicates an error occurs with scripts on the page.
The Google Calendar Sign In window closes.
Step 4 On the main Cisco Jabber window, select the Meetings tab on the left side navigation.
Cisco Jabber displays calendar events from your Google Calendar account.
Remove Google Calendar Integration in Cisco Jabber for Windows
ProcedureYou can remove Google Calendar integration with Cisco Jabber. To completely remove Google Calendar integration, you should also revoke access from your Google account.
Step 1 Open the main Cisco Jabber window. Step 2 From the hub window, open the Settings menu, and go to Options. If you’re on an earlier version of Cisco Jabber for Windows, select instead. From release 11.0 onwards, the Integration tab is called the Calendar tab.
Step 3 Select None and then select OK. Step 4 Restart Cisco Jabber. Cisco Jabber no longer displays events from Google Calendar.
What to Do NextOpen your Google Accounts page and revoke access for Cisco Jabber in the Authorized Access to your Google Account section.
Windows
Accessibility
Keyboard Shortcuts
Active Calls
Operation Keyboard Shortcut End calls CTRL + K Enter or exit full screen mode CTRL + SHIFT + F Show or hide self-view video CTRL + SHIFT + B Mute or unmute your audio CTRL + Down Arrow Start or stop video CTRL + SHIFT + V Dock or undock the call window CTRL + ALT + P Hold or resume calls CTRL + SHIFT + H Open or close the keypad CTRL + SHIFT + K
Tip Enter numbers on the keypad with your keyboard. Increase volume CTRL + SHIFT + Up Arrow Decrease volume CTRL + SHIFT + Down Arrow Open or close the More menu CTRL + SHIFT + Plus Open the Merge menu when calls are on hold CTRL + M Transfer a call CTRL + SHIFT + T Start a conference call CTRL + SHIFT + C Keyboard Navigation
Press the Tab key and arrow keys to navigate through items on:
Tip
Use arrow keys to access lists and individual components.
Use the Tab key to navigate through the general area, and Shift + Tab to navigate backwards.
Use Ctrl +Tab to navigate through conversation windows when you have multiple conversations going.
Press Enter to select items on windows or start chats with contacts in your contact list.
Troubleshooting
Unable to Access Cisco Jabber Features
ProcedureIf there is an issue with a feature, for example, you cannot access your voice messages, you may have an issue with your connection status.
Step 1 In the client, select the Menu icon, then . Step 2 For each server listed, verify that the status displayed is Connected. Step 3 If any servers are not listed with a Connected status, select Options to verify the account settings. The Accounts tab opens. Step 4 Check that your username is correct and re-enter your system credentials and select Apply. Step 5 If the problem persists, select the Advanced option to see your server addresses, and then report the problem with your server information to your system administrator.
Set Video Preferences for Cisco Jabber Calls
ProcedureIf you see an incoming video call and you don't want to show your video for the call, you can change the setting to answer calls with video. Or if you notice that no video is being shown, you can choose to show your video when you answer calls.
Step 1 Select . . Step 2 Select your preference to Always start calls with video or Never start calls with video. You can always change these preferences. So to turn off video for just one call or one day, select Never start calls with video. Then you can change that preference later when you want to make video calls.
Step 3 Select Apply then OK.
Change My Profile Picture in Cisco Jabber
ProcedureIf you are not displaying a profile picture, or you want to change the picture you are using, you can add or change your profile picture. However, this option is only available to organizations using cloud deployments. If you don't have the Edit my profile option, then you cannot change your profile picture.
Create a Problem Report After a Client Error
ProcedureIf Cisco Jabber encounters a problem and must close, the problem-reporting tool starts automatically.
Step 1 In the Client Error dialog box, choose a problem type. Step 2 Enter a short description of the problem, and then click Save Report.
Note If your system administrator set up the feature, you can click Send Report to upload the problem report to a server. You do not need to save the file locally with this feature.
Step 3 In the Save As dialog box, choose the location to which you want to save the problem report, and then click Save. Step 4 Send the file to your system administrator.
Create a Problem Report from the Help Menu
ProcedureIf you experience an issue with Cisco Jabber, you can manually create a problem report from the Help menu.
Step 1 Select . Step 2 Select a problem area, and then click Next. Step 3 Enter a short description of the problem, and then click Next. Step 4 (Optional) To include a memory dump file, check the Include memory dump check box, and then click Attach File. Include a memory dump if Cisco Jabber or Device Selector crashes.
Step 5 In the Open dialog box, select the memory dump file, and then click Open. Step 6 Click Save Report.
Note If your system administrator set up the feature, you can click Send Report to upload the problem report to a server. You do not need to save the file locally with this feature.
Step 7 In the Save As dialog box, choose the location to which you want to save the problem report. Step 8 Send the file to your system administrator.
Create a Problem Report from the Windows Start Menu
ProcedureIf you cannot sign in to Cisco Jabber, you can create a problem report from the Microsoft Windows Start menu on the hosted virtual desktop. Only use this procedure if you cannot sign in to Cisco Jabber because the problem report does not include the logs from the thin client.
Step 1 Select . Step 2 Select a problem area, and then click Next. Step 3 Enter a short description of the problem, and then click Next. Step 4 (Optional) To include a memory dump file, check the Include memory dump check box, and then click Attach File. Include a memory dump if Cisco Jabber or Device Selector crashes.
Step 5 In the Open dialog box, select the memory dump file, and then click Open. Step 6 Click Save Report.
Note If your system administrator set up the feature, you can click Send Report to upload the problem report to a server. You do not need to save the file locally with this feature.
Step 7 In the Save As dialog box, choose the location to which you want to save the problem report. Step 8 Send the file to your system administrator.
Virtualization Experience Media Engine
Cisco Unified Communications and the Virtual Environment
In a virtual environment, your Cisco Unified Communications application (such as Cisco Jabber) runs on your hosted virtual desktop. The hosted virtual desktop is a form of desktop computing. Your hosted virtual desktop looks and functions like a regular desktop. However, your Windows desktop, other software, and your data reside in a central location called a data center. You access your hosted virtual desktop over a secure Citrix or VMware connection.
In a virtual environment, Cisco Virtualization Experience Media Engine is required to support audio and video calls with your Cisco Unified Communications application.
Device Management
Cisco Virtualization Experience Media Engine (VXME) includes a component called Device Selector. Device Selector is a menu that you can use to manage your cameras, speaker devices, microphones, and ring alerts. You can view your currently active devices or change them. A list of speaker devices appears first in the menu, followed by the lists of microphones, ring devices, and cameras.
After you connect a new device, a "New device found" message appears in the notification area and the new device becomes active.
NoteWith some wireless headsets, you may not hear the ringtone for incoming calls, because the wireless link that connects device is not open. To open the wireless link, press the call answer button on the headset. Some headsets play their own internal tone.
When you disconnect a device, a "Device disconnected message" appears in the notification area and the next device in your Preference list ( ) becomes active.
The Device Selector icon () appears in the notification area (system tray), in the bottom right corner of the screen. Some icons, including the Device Selector, can be hidden. Click the up arrow in the notification area to show hidden icons.
Cisco VXME, Screen Lock, and Call Control
While your hosted virtual desktop screen is locked, you cannot make calls, but you can receive them. If you have an incoming call while your hosted virtual desktop screen is locked, you can use one of your accessories to answer the call. With supported audio accessories, the following call control features are available while your screen is locked:
Cisco Approved Audio and Video Accessories
For a complete listing of audio and video accessories that are supported for Cisco Virtualization Experience Media Edition (VXME), visit http://www.cisco.com/c/en/us/products/unified-communications/uc_endpoints_accessories.html.
NoteWe do not provide technical support for these accessories. For more information about, or technical assistance with your accessories, see the documentation for your device or visit the manufacturer's website.
Copyright © 2017, Cisco Systems, Inc. All rights reserved.