Overview
Sangoma’s TeamHub Chat provides the ability to collaborate with teammates inside Channels, or in a Direct Messages.
Channels | Direct Messages |
Channels are public or private collaboration areas based on teams or topics.
| Direct Messages are private chat sessions just between you and someone else (or a group of people). |
How to access TeamHub Chat?
Before using TeamHub Chat, we recommend reviewing this article: |
|---|
Click Here to access TeamHub.
Login using your Sangoma credentials.
In the left navigation panel click Chat to open the Chat page.
The Chat Sidebar is displayed on the left side of the Chat page.
The last accessed Channel or Direct Message is displayed on the right side of the Chat page.
Chat Sidebar Overview
The Chat Sidebar is used to organize and navigate your conversations. The sidebar displays your direct messages, channels you've joined, and notifications for specific conversations.
The Chat Sidebar consist of the following functions:
Function | Description |
+ | The ( + ) icon provide that ability Browse Channels, Create a new Channel, Open a Direct Message, or Create a New Category |
Find a channel | This function provides the ability to search, view and join a channel. Click Here for more details. |
Insights | This function displays statistics on your chat activity. |
Threads | This function displays all the message threads that you’re participating in or following.
A message thread is a message where someone uses the reply function to respond to a specific message. |
Drafts | This function displays all messages that were started but not sent. If any draft messages exist, the number of draft messages will be displayed. |
FAVORITES | This section, when expanded, lists all the Channels and Direct Messages that have been set as a Favorite. |
Categories | Channels and Direct Message can be grouped into categories. The Category creator can name the category. |
CHANNELS | This section, when expanded, lists all the Channels that you have joined. (Note: Channels flagged as a favorite are moved to the Favorites section.) The number of unread messages is displayed to the right of the channel name. Channels are differentiated by public ( # ) or private (🔒) designations: # - Public channels are visible to anyone within the organization, and are open for joining without channel owner approval. 🔒 - Private channels are only visible to channel members. Members can only be added by the channel owner. Click Here to learn more about Channels (Note: Channels tagged as a favorite are moved to the Favorites section.) |
DIRECT MESSAGES | This section, when expanded, lists all the Direct Messages that you have. (Note: Direct Messages tagged as a favorite are moved to the Favorites section.) |
Invite Members | This function is used to invite new members. |
Chat Shortcut Keys
Chat supports many Keyboard Shortcut keys. To get more information on the Keyboard Shortcut keys using your keyboard press the CTRL key and / key simultaneously.
Note: Some shortcuts may not be applicable for some accounts or use cases. |
How to work with chat messages
You can contribute to a discussion by writing messages. Within a message you can use formatted text, add links, add emojis, attach files, and mention teammates.
Note: If You navigate away or log out, the message will not be saved. |
How to access messages
You can start, edit or take other actions on chat messages from within a Channel or Direct Message.
Click on a Channel or Direct Message within the Chat Sidebar.
The Channel/Direct Message Stream will be displayed to the right with a list of previous activities.
New Messages can be entered at the bottom of the page.
How to create a new message
Click on a Channel or a Direct Message and the Message Stream is displayed to the right.
At the bottom of the page enter a new message at the bottom of the Channel or a Direct Message.
Click the Send ( ➤ ) button at the bottom right of the Message Entry area.
Mention Teammates
Teammates can be mentioned/tagged in a message using the @member name format (example: @Anna). Enhance your team’s collaboration by using @mention teammate to ask for input, or draw attention to action items that require a teammate’s attention. If a teammate is mentioned in a public channel, it will show as a new activity in their Channel list helping to draw their attention to your message. They will get a new notification displayed on the ring bell and get a Desktop Push notification if they have it enabled.
Text Formatting Options
On the bottom of the message entry, are text formatting options. This allows you to format the text so that you can change the appearance of your messages.
Click the ( Aa ) icon to hide or display the format options.
Note: To insert a new line within a message press the Shift and the Enter key at the same time.
Add Links
To add a link within a message, Click the Link (🔗) icon and the following will be added to the message [](url).
[ ] - Inside the brackets enter the text to be displayed for the link.
(url) - Inside the parentheses enter the URL for the link.
Attach Files
To add a file to a conversation, at the bottom of the Message Input click the attach ( 📎 ) icon, or drag-and-drop a file from anywhere directly into the message input. Once a file has been added to a conversation the file will appear in the TeamHub Files section in the Left nav bar. Note that the maximum supported file size is 50 MB.
How to Reply to an existing message
Note: Replying to an existing message creates a message thread and can be easily accessed in the Threads section in the Chat Sidebar.
Click on a Channel or a Direct Message and the Message Stream is displayed to the right.
Click on the desired message within the Message Stream.
The Reply Entry area is displayed to the right.
Enter the reply message.
Click the Send ( ➤ ) button at the bottom right of the Reply Entry box.
Addition reply options
For Additional Message options hover over an existing message and the Message Action toolbar will be displayed.
Your Message | Teammate Message |
 |  |
Message responses:
There are several response types you can take on an existing message.
Thumbs Up - Replies with an approval emoji.
Grinning - Replies with a smiley face emoji.
Raised Hands - Replies with a celebratory emoji.
Add a reaction - Allows for selecting an emoji response.
Save - Save the message.
Reply - The Reply action allows you to add a direct response to a specific message, creating a threaded Response. See below for more information about a threaded response.
More - Click on the More ( … ) icon for additional options, including Edit and Delete functions.
How to edit your message response
If you have created a message you can go back and edit the message.
Hover over an existing message and click the Menu ( ⋮ ) icon that is displayed.
Select Edit.
Make your changes.
Click the Save update button.
Click the Cancel button to back out of the changes.
How to delete your message response
If you created a message you can go back and delete the message.
Hover over an existing message and click the Menu ( ⋮ ) icon that is displayed.
Select Delete.
Click the DELETE button to confirm you want to delete the message.
Click the CANCEL button to back out of the changes.
How to mark a message as read or unread
Hover over an existing message and click the Menu ( ⋮ ) icon that is displayed.
Select Mark as Read or Mark as Unread.
How to pin a message
Hover over an existing message and click the Menu ( ⋮ ) icon that is displayed.
Select Pin to Channel.
Working with Talk in Chat
How to Call an Extension
Open the Direct Message where you want to make an extension call
Click the Talk button in the top right corner of the page.
Once you clicked, it will start dialing the user’s extension.
A small call card will appear for you to end the call, put the call on hold or mute yourself.
Working with Meet in Chat
How to Start a Meet (Audio and Video call)
Open the Channel or Direct Message where you want to start an audio or video meeting
Click the Meet button in the top right corner of the page.
Once you clicked, a Join button will be displayed in the chat room for all members of the channel, private or group conversation.
Click Join and your audio/video meeting will be started.
All Sangoma Meet features will be available for you such as recording, screen sharing and moderation controls.
As participants join the call, their name will appear in the little box:
Working with Direct Messages
Create a new Direct Message
Click the (+) icon to right for the Direct Message label in the Chat Sidebar.
Search and select the people to be included in the chat.
Click the GO button.
Open and Respond to a Direct message
Click on the desired Direct Message name in the Chat Sidebar.
The Direct Message will be displayed to the right.
The Direct Message displays a list of all the previous activity that has happened within the Direct Message.
New messages can be entered in the Message Entry box at the bottom of the message.
Within the message header section:
Click the Star ( ☆ ) icon to add or remove from Favorites.
Click the Pin ( 🖈 ) icon to pin or unpin.
Click the Page ( 🗎 ) icon to add a header.
Click on the Direct Message name to display a list of the following functions that can be performed.
Move to Favorites.
Move to a new or different Category.
Mute the conversation
Edit the conversation Header
Close the Direct Message
Disable calls
How to Add or Remove a Direct Message from Favorites
Several methods are available for setting a Direct Message as a favorite.
Hover over the desired Direct Message and click the Menu ( ⋮ ) icon that is displayed:
To add to favorites select Move to Favorites.
To remove from Favorites select Move To Direct Messages or a Category.
Open a Direct Message and click on the Star ( ☆ ) icon next to the Direct Message Name to add or remove from Favorites.
Click on the Direct Message Name, select View Info, and click the Star ( ☆ ) icon to add or remove from Favorites.
Working with Channels
How to find a Channel
There are a couple different options for finding Channels.
Click the ( + ) icon at the top of the Chat Sidebar and select Browse Channels from the menu.
Select Find channel at the top of the Chat Sidebar, and enter the search criteria.
Member Management
How to add Members to a Channel
Several options are available to add members.
Hover over the desired Channel and click the Menu ( ⋮ ) icon that is displayed:
Click Add Members.
Search and select Members.
Click the ADD button.
Open the desired Channel:
Click on the Channel name.
Select Add Members from the menu.
Search and select Members.
Click the ADD button.
Open the desired Channel:
Scroll to the top of the Channel activity list.
Click the ADD MEMBERS TO THIS CHANNEL button.
How to remove Members from Channel
Open the desired Channel.
Click on the Channel name.
Select Manage Members from the Menu.
Click the Member option next to the desired member.
Select Remove from Channel.
How to add or remove Admin rights for Channel Member
Open the desired Channel.
Click on the Channel name.
Select Manage Members from the menu.
Click the Member option next to the desired member.
Select Make Channel Admin or Make Channel Member.
How to Leave a Channel
Several methods exist to leave a channel.
Hover over the desired Channel and click the Menu ( ⋮ ) icon that is displayed:
Select Leave Channel.
Open the desired Channel:
Click on the Channel name.
Select Leave Channel.
Open the desired Channel:
Click on the Channel name.
Select Manage Members from the menu.
Click the Member option next to your name.
Select Leave Channel.
How to Archive a Channel
Open the desired Channel.
Click on the Channel name.
Select Archive Channel.
How to Edit a Channel Header
Open the desired Channel.
Click on the Channel name.
Select Edit Channel Header.
How to Edit a Channel Purpose
Open the desired Channel.
Click on the Channel name.
Select Edit Channel Purpose.
How to Copy a Channel’s Link
Hover over the desired Channel and click the Menu ( ⋮ ) icon that is displayed.
Select Copy Link.
How to Mark a Channel as Read or Unread
Hover over the desired Channel and click the Menu ( ⋮ ) icon that is displayed.
Select Mark as Read or Mark as Unread.
How to add or remove a Channel from Favorites
Several methods are available for setting a Channel as a favorite.
Hover over the desired Channel and click the Menu ( ⋮ ) icon that is displayed:
To add to favorites select Move to Favorites.
To remove from Favorites select move to Channel or a Category.
Open a Channel and click on the Star ( ☆ ) icon next to the Channel Name to add or remove from Favorites.
Click on the Channel Name, select View Info, and click the Star ( ☆ ) icon to add or remove from Favorites.
How to Move a Channel
Hover over the desired Channel and click the Menu ( ⋮ ) icon that is displayed:
Select Move to. The move options are:
Favorites.
An existing Category.
New Category.
Channel.
How to Mute a Channel
Hover over the desired Channel and click the Menu ( ⋮ ) icon that is displayed:
Select Mute Channel.
How to change Notification preferences
Global Notifications
In the Chat Header click on the Setting ( ⚙ ) icon.
Select Notifications.
Channel Specific Notifications
Open the desired Channel.
Click on the Channel name.
Select Notification Preferences.
How to Rename a Channel
Open the desired Channel.
Click on the Channel name.
Select Rename Channel.
How to Open or Close the Channel Info
Open the desired Channel.
Click on the Channel name.
Select View Info to open or Close Info to close.