You have to be an Administrator or Space moderator to complete the following steps:

1. Open the menu by clicking the hamburger icon on the top-left corner of the Sococo app, and select SETTINGS from the menu.

2. Select the Slack Integration option under the Integrations section, and select the CONNECT option:

   

3. Follow the Slack authorization flow.

   NOTE: If you need to change the Slack workspace, select the Sign in to another workspace option on the top-right side. The authorizing Slack user will need privileges to install apps in Slack.

   

4. Once integrated, you can turn on the option to require an invitation for Slack team members to join the Sococo organization:
   

Approving Sococo in Slack 

You need to setup Slack to approve the Sococo app:

1. On your Slack client, go to Administration > Manage apps.

   https://[yourslack].slack.com/apps/manage

2. Under Apps, type Sococo in the Title Includes field and click on the Approve button:

   

New Users with Slack Integration

For new Sococo users, the easiest and recommended way to authorize your Sococo identity is to log in with your Slack credentials.

1. Navigate to the Sococo app.
2. Select MORE WAYS TO LOG IN.
3. Select the option to LOG IN WITH SLACK.
4. Follow the Slack authorization flow:

Integrating an Existing Sococo User with Slack

For existing Sococo users (users who are members of existing spaces prior to the Slack team integration), integration steps are different. Log in with your existing Sococo credentials first, and then integrate to Slack using the chat.

Your explicit authorization is required before you can use Sococo chat to send messages to users in Slack.

To do this, open a Private (person-to-person) chat window and follow the instructions found on the yellow bar at the top of the chatbox:

Note: Selecting the CONNECT TO SLACK option will open a Slack authorization pop-up that will allow you to authorize access to Slack. If you are using Sococo via Chrome, you may need to allow the pop-ups.

Chatting with Any Slack Team Member from Sococo

Once a Sococo space is mapped to a Slack team, all Slack team members will be able to access that Sococo space. They do not need to be invited.

The list of all Slack team members will be available on the People Pane in Sococo. You may chat with any Slack team member or ask any Slack team member to join a meeting room in Sococo.

To chat with any Slack team member from Sococo:

1. Click on Find on your People pane
   

2. Search for the slack name of the Slack user you want to chat with
   

3. Click on Open chat for the user, and a chat window will open at the bottom-right part of your Sococo app. At the header of the chat, you can see that the chat is done via Slack.
   

   • You will also receive chats in Sococo from any Slack team members who send you a direct message from Slack.
   • You will also notice that the Sococo chat window will show the chat message history from Slack.

To get a Slack user to join your room in Sococo:

1. Right-click on the user's avatar in the People pane and select Get <Username>:

   

   The Slack user will receive a direct message in Slack from Slackbot stating that <Slack username> has sent an invite to meet in Sococo:

   

2. A user can respond to invite from Sococo by simply clicking the Please click here to join! in the Slack direct message:

   

NOTE: Get notifications/messages are received from the Sococo app user as a Slackbot direct message, not from the user who sent the invite.

Any member of a Slack team logging in to Sococo can view and access all Sococo spaces mapped to that Slack team using the Sococo space drop-down list:

You can start a meeting in a Sococo room by using the /sococo command on Slack:

There are several ways to use the /sococo command:

Inviting All Members of a Channel

Using the /sococo command in a channel without any input parameters will result in:

• A @channel style message sent to the channel with a link to the Sococo meeting room:

  

• Any member of the channel can join the meeting by clicking the link.

• The meeting will be hosted in the largest available (empty) room in the Sococo space mapped to the channel.

Inviting Specific Members only

You can use the /sococo command to invite specific users to a meeting and select the destination meeting room.

Usage:

/sococo [@user1, @user2, @user3,...] [destination space name] [destination
 room name]

Example:

/sococo @jon @jane @justin @john Conference A

Many large Slack organizations apply a Team Channel organization pattern. This creates a channel for each organizational team within Slack and invites the members of those teams to the channel.

To map Team Channels to spaces and rooms in Sococo, follow these steps:

1. Provisioning spaces

   For each space needed:

   1. Create a Sococo space.

   2. Log in to the Sococo space as an Org Administrator.

   3. Map the Sococo space to the Slack Team.

2. Onboarding Slack Team Channels

   For each Slack Team Channel:

   1. Identify the Sococo space and room that you want to map to the specific Slack Channel.

      Recommendation: Label the room with the same name as the Slack Channel.

      

   2. Log in to Slack.

   3. Issue a /sococo 'spacename' 'roomname' command from the Slack channel (where 'spacename' and 'roomname' are the targets identified in Step 2a) to invite all channel members into their Sococo room for the first time:

      

   4. Each member will onboard by clicking the Please click here to join! link generated by the /sococo command.

      Clicking the link will ask the members to authorize Slack and establish their membership in the target space, which will place them in their designated channel room:

      

   5. Ask each member to set the channel room as their home room by clicking on the Set as home room option. Members should also select the Add to starred option for every member of their Slack Channel Team:

      

3. Regular use:

   • To initiate a meeting from Slack on demand, anyone in the channel team can issue a /sococo 'spacename' 'roomname' command on the Slack channel. The command invites all members of that Slack channel to the team's Sococo room.

   • When in the Sococo team room, members will have the ease of access to their channel team members via the Starred favorites.