AdministerGurusup contacts and external contacts

Gurusup contacts and external contacts

Choose who Gurusup can ask when it lacks an answer, inside or outside your organization, and how it reaches them by call or Slack.

Gurusup only asks someone who is set up as a contact.

Admins set up contacts for any member, and external contacts. Members can set up their own.

KindWhoWhere
Gurusup contactA member of your organizationAdmins: the member's panel in Team. Members: their Profile page.
External contactSomeone without an account, such as a partnerThe External contacts tab of Team. Admins only.

Before you start

  • For Slack, the person is in a Slack workspace already connected to your organization. See Connect Slack.
  • For a call, you have the phone number and know its country. You pick the country from a list, so you type the number without the country code, for example 612 345 678.
  • Gurusup only asks members who can see the knowledge behind the question, through their categories or because they were picked on a restricted source. Pick contacts with that in mind.

Set up a Gurusup contact

Open the member

Go to Team and click the member's row.

Enable the contact

In the Contact section, turn on Gurusup contact. Until then it reads "Gurusup can ask them when it needs a human."

Add contact methods

Under Contact methods, choose Call or Slack, pick the country for a call, and fill in the value. See Contact methods.

Write When to ask

One topic per line, for example pricing approvals or enterprise exceptions.

Save

Click Save contact. You should see "[name] is now reachable by Gurusup." and the section lists the methods, with Edit to change them.

Contact methods

MethodWhat to enter
CallThe phone number without the country code, for example 612 345 678. Pick the country in Country code, on the left of the number.
SlackThe person's Slack user ID, like U012ABCDEF, not an @handle. In Slack, open their profile, click More, then Copy member ID.

Country code is a searchable list that shows each country with its calling code, for example "ES +34". Type a country name, an ISO code or a calling code under "Search countries...". If nothing matches, the list reads "No countries found. Try a name or calling code." New numbers start with the country of your organization's time zone, or Spain if that has no match. Gurusup saves the number with its country code, and drops a leading 0 unless the country is Italy. A WhatsApp method, where one exists, uses the same list.

When you leave a Slack field, Gurusup checks the ID against your connected Slack workspaces and shows the workspace, name, email and whether the person is a guest. If the check does not run, click Verify Slack user. If the person is in several connected workspaces, pick one under Slack workspace. You cannot save until every Slack method is verified.

Click Add method for more. Email and other channels are not offered. The first method has the highest priority: use the arrows to reorder and the X to remove, keeping at least one.

How Gurusup picks who to ask

Gurusup reads the question and every contact's When to ask, and picks the best fit. If no topic fits clearly it can still propose someone, so check the name before you confirm. Write topics the way people ask: short, specific, one per line.

RuleDetail
Only contactsA person named in a Slack thread or a document is not a contact.
AccessIf the question rests on what Gurusup found in your sources, only a member who can read that knowledge is asked, and never an external contact. The same holds for conflicts, where only admins can ask a contact.
PriorityGurusup tries the first method. If it fails or nobody answers, the requester can click Try next contact method in My requests, and Gurusup uses the next unused method.
Nobody fitsWith no contact set up, or none with a method the request allows, the assistant says that no team contact is available.

A notice at the top of Team counts the members without a contact method, for example "2 members need a contact method so Gurusup can escalate questions to them." Click Show them to filter the list, then click a name to open that member.

Add an external contact

Click External

In Team, open the External contacts tab and click External. The New external contact dialog opens.

Fill in the details

Enter a Name and at least one method. When to ask is optional, but gives Gurusup hints about when to ask.

Save

Click Save. You should see "[name] saved." and a card with the first topic and the methods.

Use Edit on a card to change it, or the delete icon to remove it ("[name] deleted."). Deleting cannot be undone. External contacts can appear in a conflict's Who to ask list, but Gurusup turns them down when it tries to send.

Turn a contact off

Open the member, turn off Gurusup contact and confirm Disable contact. You should see "[name] is no longer reachable by Gurusup." (for yourself, "Gurusup will no longer reach you this way.").

Disabling deletes the methods and topics, so enabling again means re-entering them. Requests already sent to that person can't use Try next contact method: the requester sees "The person this question was sent to is no longer a contact. Ask someone else instead." Removing a member from the organization also deletes their contact.

If something goes wrong

Saving

You seeWhat to do
"Add at least one contact method."Add a method before saving.
"This contact method is required"Fill in the empty method or remove it.
"Doesn't look like a valid phone number"Check the digits and the country in Country code.
"Enter the number without the country code. Pick the country on the left."Remove the + and the country code from the number, and pick the country in Country code.
"Add the country code to the phone number: start with + and the country code, like +34 612 345 678, using 7 to 15 digits."Shown by the API or by an assistant when a call or WhatsApp number has no country code. Start the number with + and the country code.
"Name and at least one contact method."Fill in the external contact's name and a method.
"Fix the invalid contact method before saving."Correct the marked value.
"Verify every Slack contact and choose its workspace before saving."Click Verify Slack user and pick a workspace if asked.
"Couldn't save contact. Only organization admins can manage another user's contact."Set up your own contact under Profile.
"Couldn't save contact. This user already has a contact."Open the existing contact and edit it.
"Couldn't save contact. Someone else changed this contact at the same time. Refresh the page and make your change again."Refresh and repeat.
"Couldn't save contact. This contact is being deleted, so it can't be changed."Wait, then refresh.
"This contact no longer exists. Refresh the page to see current contacts."Refresh.
"Couldn't disable contact."Try again. If it keeps failing, contact support.

Slack IDs

Gurusup shows the message it receives from the Slack check. When you save, the same messages can appear after "Couldn't save contact."

You seeWhat to do
"Enter a Slack user ID like U012ABCDEF, not an @handle"Use the member ID, not the name.
"No connected Slack workspace contains that user ID. Check the ID and workspace connection, then try again."Check the ID, and that the person's workspace is connected under Sources.
"This Slack workspace is not connected. Ask an admin of your organization to connect it in Connect apps, or choose a connected Slack workspace."Connect it, or pick another under Slack workspace.
"This person cannot be reached in the selected Slack workspace. Choose another Slack workspace or person."Pick another workspace or person.
"This person cannot be reached through your connected Slack workspaces. Check their Slack member ID or choose another person."Check the ID.
"Slack could not find this person. Check their Slack member ID or choose another person."Check the ID.
"This person belongs to a different Slack workspace. Choose their Slack workspace and try again."Pick the person's workspace under Slack workspace.
"This Slack user is deactivated. Ask your Slack admin to reactivate them or choose an active person."Ask your Slack admin to reactivate them, or choose someone else.
"This Slack account belongs to a bot. Choose a person to contact."Choose a person.
"This Slack account belongs to an app. Choose a person to contact."Choose a person.
"This person is only connected through Slack Connect. Ask your Slack admin to invite them to the connected Slack workspace."Ask your Slack admin to invite the person to your Slack workspace.
"This person is available in more than one Slack workspace. Choose the Slack workspace to use."Pick a workspace.
"Slack could not verify this person. Check their Slack member ID and selected Slack workspace, or ask your organization admin for help."Check the ID and the workspace, then click Try again.
"We couldn't verify this Slack contact because of a problem on our side. Your saved contact details are safe. Try again in a few minutes. If it keeps failing, contact support at" (the message ends with the support email address)Click Try again in a few minutes. If it keeps failing, contact support.
"Slack verification is unavailable. Refresh the page and try again."Refresh the page.
"Could not verify this Slack user. Check the ID and workspace connection, then try again."Shown when the check fails without a message from Gurusup. Click Try again.
"This Slack user is already linked to another contact. Remove the Slack contact method from that contact in Team before linking it here."Admins: remove the Slack method from the other contact first.
"This Slack user is already linked to another contact. Ask an admin of your organization to remove it from the other contact."Members: ask an admin to remove it from the other contact.