Bots NextPlane

USERS GUIDE

 
Table of Contents

NextPlane Users Guide for IBM Slack Federation


Why NextPlane App

Not everyone is on Slack. Increasingly your colleagues, inside and outside your enterprise, can be on other collaboration platforms such as Microsoft Teams or Cisco Webex Teams. Others may be on legacy platforms such as Microsoft Skype for Business.

The nextplane App lets you connect with colleagues that are on different platforms. You can stay on Slack and be able to:

  • Invite and add each other as contacts
  • Send direct messages with rich text, GIFs, and emoji reactions
  • Share presence status
  • View each other’s profiles
  • Find non-Slack conversations
  • Add non-Slack contacts to channels
  • Mute your direct messages with non-Slack contacts

To get started with the nextplane App, you need to add it to your Slack application. You will then be able to add non-Slack contacts to your workspace and start communicating with them.



Get Started with the NextPlane App

1. Add the NextPlane App to Your Slack Application

Next to Apps, click Browse apps . In the search bar, start typing nextplane, and then from the search results, select the App.

The nextplane App is added to your Slack application and appears in Apps.


2. Add a non-Slack Contact

Select the nextplane App and on the Home tab, click Add Contacts . Enter your non-Slack contact's user ID in the email address format, e.g., john.doe@gomaxine.com, and click Add .

Important! You can also add non-Slack contacts from any messaging area using the /nextplane invite + user ID slash command, e.g., /nextplane invite john.doe@gomaxine.com.




3. Wait for the Contact to Accept Your Invitation and Access Your Workspace

The nextplane App will notify you when the non-Slack contact accepts your invitation to connect.

To allow the non-Slack contact to access your workspace:

  1. When you receive the notification, confirm adding the contact to your workspace by clicking Confirm .

  2. On the request approval page, click Submit  to request permission from the workspace App Manager to add the non-Slack contact to your workspace.

  3. The app_governance_bot will notify you once your request is approved.

    When you receive the notification, please do NOT click Complete Installation. Instead, go back to your direct message with the nextplane App, and in the acceptance notification, click Confirm  again.

    Important! This step is required to grant the invited contact permission to access your Slack workspace.

  4. On the request permission page, in the upper-right corner, check if the necessary workspace is selected, and then click Allow  to grant the required permissions.

    The invited contact is added to your workspace and appears in Apps.




4. Start a Direct Message with a non-Slack Contact

Go to Apps and select the recently added non-Slack contact. In the message field, compose your message and
click Send message  or press Enter. This starts a direct conversation with your non-Slack contact.



5. Find a Direct Message with a non-Slack Contact

If you lost your direct conversation with a non-Slack contact, type your contact's name in the search field at the top of Slack. From the search results, select the necessary contact and start messaging.



Key Features


1. Accept the Incoming Invitation from a non-Slack Contact

The nextplane App will notify you of any incoming requests from non-Slack contacts whose companies are a part of the NextPlane ConverseCloud Network.

To accept the incoming invitation:

  1. When you receive the notification, confirm adding the contact to your workspace by clicking Confirm . 

  2. On the request approval page, click Submit  to request permission from the workspace App Manager to add the non-Slack contact to your workspace.

  3. The app_governance_bot will notify you once your request is approved.

    When you receive the notification, please do NOT click Complete Installation. Instead, go back to your direct message with the nextplane App, and in the contact request notification, click Confirm  again.

    Important! This step is required to grant the invited contact permission to access your Slack workspace.

  4. On the request permission page, in the upper-right corner, check if the necessary workspace is selected, and then click Allow  to grant the required permissions.

    The non-Slack contact is added to your workspace and appears in Apps.




2. Find Your NextPlane ID for Slack

NextPlane ID for Slack is different from your email address. Your non-Slack contacts can invite you using this ID.

To find your NextPlane ID for Slack, do one of the following:

  • In any messaging area, type /nextplane help, and then click Send message  or press Enter.
    In the help message, under the instruction on how to find your NextPlane ID, click Show My ID .

  • In any messaging area, type /nextplane showmyid, and then click Send message  or press Enter.

The nextplane App sends you a direct message with your NextPlane ID for Slack. You can right-click it, copy, and then share it with non-Slack colleagues.



3. Add a non-Slack Contact to a Channel

To add a non-Slack contact, select the necessary channel* and do one of the following:

  • If you selected the newly-created channel, below the channel description, click Add an app .

  • If you selected the already existing channel, in the upper-right corner, click Show channel details , and then
    select More  > Add apps.

In the list of workspace apps, next to the app representing the necessary contact, click Add .

Wait for the non-Slack contact to accept your invitation to join the channel. Once they accept, all the channel members will be able to see their messages posted to the channel.

If you have the necessary permissions, you can remove non-Slack members from the channel.

* You can add non-Slack contacts to public channels only. Adding non-Slack contacts to private as well as shared channels will be available soon.



4. View a non-Slack Contact's Profile Details (V-Card)

Open the direct message with the necessary non-Slack contact and navigate to the About tab below the contact's name. Here, your contact's profile details are displayed.



5. Mute Direct Messages from a non-Slack Contact

To stop receiving notifications from a non-Slack contact, you can mute your direct messages.
Go to Apps, right-click your contact's name, and then select Mute conversation.

To unmute, right-click the contact and select Unmute conversation. You can also open the direct message with that contact and click Unmute  next to their name at the top.



Frequently Asked Questions

What commands can I use with the nextplane App?

With the nextplane App, you can use the following commands:

  • /nextplane invite – to invite non-Slack contacts
  • /nextplane showmyid – to display your NextPlane ID for Slack that you can share with non-Slack contacts
  • /nextplane help – to show help guidelines on how to use the nextplane App
  • /nextplane echo – to check the connectivity with the nextplane App

Do I need to request permission to add non-Slack contacts to my workspace?
Yes, if adding third-party apps is restricted for your workspace.

Do I need to invite non-Slack contacts if my colleagues have already added them to my workspace?
No. If your colleagues add a non-Slack contact to your workspace, you can find them by using search at the top of Slack. However, if you need to add that contact to another workspace you belong to, you will have to invite them and then confirm adding them to that workspace.

How can I add a non-Slack contact to a different workspace I belong to?
You need to confirm adding a non-Slack contact to every workspace you belong to. You can select the necessary workspace in the Allow step when granting the non-Slack contact permission to access your workspace. The menu with workspaces you belong to is available in the upper-right corner.

Can non-Slack contacts invite me from their client applications?
Yes, if their companies belong to the NextPlane ConverseCloud Network. To invite you, they need to have your
NextPlane ID for Slack. 

What is my NextPlane ID for Slack?
NextPlane ID for Slack is different from your email address. Your non-Slack contacts can invite you using this ID.

How can I find my NextPlane ID for Slack?
You can find it by typing /nextplane help or /nextplane showmyid in the message field.

What if the contacts I need to invite do not belong to the NextPlane ConverseCloud Network?
Please provide them with the NextPlane contact details to establish federation between your companies.

What if I haven't received the confirmation that the invited contact accepted my invitation?
It might take some time for the non-Slack contact to accept your invitation. Please wait until the nextplane App confirms that your invitation is accepted. If the confirmation won't come, you can try to invite the contact once again. If the problem persists, get in touch with the NextPlane support team.

Why doesn't the invited contact appear in my Slack application after I click Allow on the request permission page?
The problem might be with the selected workspace. If you belong to multiple workspaces, please ensure that the right workspace is selected in the Allow step.

Can I see my non-Slack contacts' presence status?
Yes. Once the contact is on your workspace, you can see their presence status.

Can my non-Slack contacts see my profile?
Yes. Your profile details (V-card) become available for non-Slack contacts right after you add them to your workspace. Depending on the other platform's capabilities, your non-Slack contacts will be able to view your profile details.

Why some of my non-Slack contacts' profiles are not available on the About tab?
The information displayed on the About tab largely depends on whether the external contact’s profile is filled out. The other platform's capabilities can also limit it.

What does it mean if I receive the notification that the non-Slack contact is temporarily unavailable?
It means that direct messaging with the non-Slack contact you last communicated with is not available due to some technical issues on their side. Please try later, but if the problem persists, get in touch with the NextPlane support team.

Can I @mention my non-Slack contacts?
NextPlane is currently working to provide the possibility to @mention your non-Slack contacts.

Can non-Slack contacts participate in channels?
Yes. Your non-Slack contacts can be invited to join and participate in any channel within your workspace.

Can I share files with my non-Slack contacts?
NextPlane is currently working to provide the possibility to share files with your non-Slack contacts.

Can I remove non-Slack contacts from my workspace?
No. Only Workspace Admins or App Managers can remove non-Slack contacts from your workspace.





Have trouble using the nextplane App? Get in touch with the NextPlane support team.
Need to subscribe? Contact NextPlane at sales@nextplane.net or book a free call with the NextPlane expert.

©2020 NextPlane, Inc. ALL RIGHTS RESERVED.


CURIOUS TO LEARN MORE ABOUT NEXTPLANE'S SERVICES?

We’re with you every step of the way with customer success and professional training teams, and 24/7 customer support.

  • How It Works
  • Customers
  • Pricing
  • Blog
  • Request a demo
  • How It Works
  • Customers
  • Pricing
  • Blog
  • Request a demo