Follow

Slack Integration with the OnSIP App

Updated December 2016

 

 

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

  1. Log into app.onsip.com.
  2. From the Menu in the upper left-hand corner, click on 'Settings.' Enabling the Slack integration in the OnSIP app
  3. Navigate to the Chat box, and click the “Add to Slack” button.  A loading animation should appear.
    Connecting Slack to the OnSIP app  
  4. You will be required to authorize your Slack account to access your OnSIP app. Review the Permissions, and click on 'Authorize' in the popup box.
  5. 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

  1. From the OnSIP app home screen, select a contact you wish to chat with from the Contacts list on the left side.
  2. Contacts with chat bubbles next to their names will receive your messages in Slack, as well as in the OnSIP app. Contacts that just have a circle next to their name don't have a matching email address with a Slack user, or aren't setup in Slack. For these contacts, you won't be able to send a message to them in Slack.
    Contacts List in the OnSIP app
  3. Once his/her user info appears, scroll down to the Message box at the bottom of the page.
  4. Type a new message in the text field, and click on the Send 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).Sending a message to a coworker's Slack interface from the OnSIP app
  5. 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 is available / not on a phone call.
  • An Orange icon means the user is currently on a phone call, or set to Do Not Disturb.
  • A Blank 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.

  1. Click on the "+" or "Add Contact" buttons in your Contacts sidebar.
  2. Navigate to the "Add Slack Channel" box on the right-hand side.
  3. 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.)
    Adding Slack Channels in the OnSIP app
  4. 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.
  5. 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. 
    Sending a message from the OnSIP app to a Slack Channel
  6. Send a message to the channel by typing it in the "Type Message Here" field, and clicking on the "Send" button.

Selecting another channel member's name from the list below will bring you to that member's Contact page in the OnSIP app.

Message Notifications

You can enable popup browser notifications for messages received in the OnSIP app.

  1. From the Menu in the upper left-hand corner, click on 'Settings.'
  2. Scroll down to the Notifications box, and select the ‘On’ button next to ‘On Chat.’
    Setting browser chat message notifications in the OnSIP app
  3. You will now receive notifications in your browser as you receive messages in the OnSIP app.
  4. To disable message notifications, select the ‘Off’ button next to ‘On Chat.’

Disabling the Slack Integration

  1. From the Menu in the upper left corner, select 'Settings.'
  2. Navigate to the Chat box, and select the Disable Slack button.
  3. The Slack chat integration will then be disabled.

Miscellaneous Notes

  • 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.
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Powered by Zendesk