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.
| Kind | Who | Where |
|---|---|---|
| Gurusup contact | A member of your organization | Admins: the member's panel in Team. Members: their Profile page. |
| External contact | Someone without an account, such as a partner | The 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.
Open Profile
Open the menu at the bottom of the sidebar and click Profile settings.
Enable the contact
In Gurusup contact ("How Gurusup reaches you when it needs something only you know."), turn on Allow Gurusup to contact you.
Add methods and When to ask
Add at least one method and your topics, as described below.
Save
Click Save contact. You should see "Gurusup can now reach you."
With a contact, you can also ask your assistant to contact you yourself. See Ask questions.
Contact methods
| Method | What to enter |
|---|---|
| Call | The phone number without the country code, for example 612 345 678. Pick the country in Country code, on the left of the number. |
| Slack | The 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.
| Rule | Detail |
|---|---|
| Only contacts | A person named in a Slack thread or a document is not a contact. |
| Access | If 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. |
| Priority | Gurusup 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 fits | With 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 see | What 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 see | What 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. |