Updated June 2019
The OnSIP app can be synced to your Slack account. Once you link your accounts, you can send and receive messages seamlessly between the OnSIP app and Slack. You will also be able to view your Slack chat history with a coworker directly from his/her contact profile within the app.
For the Slack integration with OnSIP to work, your users' Slack email addresses must match their OnSIP addresses.
Enabling the Slack Integration in the OnSIP App
- Log into app.onsip.com or open the desktop app.
- From the Profile in the upper right-hand corner, click on “App Settings.”
- Under “Third Party Chat,” click the “Add to Slack” button. A loading animation should appear.
- You will be required to authorize your Slack account to access your OnSIP app. Then click on “Authorize” in the popup box.
- Your Slack account and OnSIP app will then be synced.
Each OnSIP user will have to enable the integration from his/her own OnSIP app him/herself. The OnSIP Account Administrator cannot enable the integration for all users on his/her account.
Sending Messages to Coworkers in Slack from the OnSIP App
- From the OnSIP app home screen, select a contact you wish to chat with from the Contacts list on the left side.
- Contacts that have enabled chat will receive your messages in Slack, as well as in the OnSIP app. Contacts who have not enabled chat won’t receive your messages in the OnSIP app.
- Once his/her user info appears, scroll down to the Message box at the bottom of the page.
- Type a new message in the text field, and click on the Send Message button, or press Enter to send your message. The contact will receive your message in both their Slack interface as well as their OnSIP app (if they are logged in).
- Any responses sent from Slack will appear in both your OnSIP app and your Slack interface (if you are logged into Slack).
Past Slack chat history (covering the last 50 messages) with a coworker will appear in this Message box as well. Simply scroll up to review past messages.
Clicking on the Slack icon next to the date and time of a message will open the message in Slack.
Clicking on the black Slack icon next to the “Send” button will open the full chat conversation with this user in Slack.
The color of a contact's icon displays his/her phone status:
- A green icon means the user has a device—like the app or a desk phone—that is available to take calls.
- A red icon means the user is currently on a phone call.
- An orange icon means the user is set to away. However, users who have a desk phone linked to their account will still show the green available icon if the desk phone is available.
- No icon means the user is not signed into the OnSIP app.
Sending Messages to Slack Channels from the OnSIP App
You also have the ability to send messages to and receive messages from Slack channels right in the OnSIP app interface.
- Click on the "Add" button in your Contacts sidebar.
- Navigate to the "Slack Integration" box on the right-hand side.
- Select the channels you wish to add and then click the “Add Channel” button. You can also "Select All" channels at once. (Note that you can only add public Slack channels to your OnSIP app and not private channels.)
- You will now see these channels listed in the left Contacts sidebar. They will be identified by a small Slack icon next to the name of the channel to note that they are Slack channels and not contacts.
- When you select a channel, you will see its message history box in the OnSIP app interface, as well as the names of all members in that channel listed at the bottom of the page.
- Send a message to the channel by typing it in the "Type Message Here" field and clicking on the "Send Message" button.
Selecting another channel member's name from the list below will bring you to that member's Contact page in the OnSIP app.
You can enable pop-up notifications for messages received in the OnSIP app.
- From your Profile in the upper right-hand corner, click “App Settings.”
- Scroll down to the Notifications box, and toggle the switch to “On.” This automatically enables all notifications, but you can select those you want to turn to “Off.”
- You will now get pop-up notifications as you receive messages in the OnSIP app.
- To disable message notifications, select the ‘Off’ button next to “On Chat.”
Disabling the Slack Integration
- From your Profile in the upper right-hand corner, select “App Settings."
- Navigate down to Third Party Chat and click “Disable Slack.”
- The Slack chat integration will then be disabled.
- If a message is received in the OnSIP app that is unable to be displayed properly, such as a GIPHY or custom command, the plain text version of the message will be presented. You can view the original message in Slack by clicking on the colorful Slack icon next to the date/time of the message. If the message was a file upload, a link will be provided in the OnSIP app to access it.
- Standard emojis will appear in the OnSIP app but not custom emojis, GIPHYs, or other Slack apps.