docs Nametag Slack Integration
Launch Nametag Get help

Nametag Slack Integration

Overview

The Nametag Slack integration lets you start identity verification requests directly from Slack using the slash command:

/nametag → opens the Nametag Verification dialog.

From this dialog, you can run one of two verification flows:

  1. Verify myself & others (send verification links to you and selected people)
  2. Create a shareable link (generate one link you can share yourself)
Nametag Verification dialog

Create a verification from Slack

  1. In any channel or DM, type /nametag
  2. The Nametag Verification dialog opens.
  3. Choose what you want to do:
    • Verify myself & others
    • Create a shareable link
  4. If your Slack integration is connected to more than one environment, you must choose an Environment from the dropdown list.
  5. If the chosen environment has more than one template, you must choose a Template.
  6. (Optional) Add a Label to describe the verification.
  7. Submit the request

Flow 1: Verify myself & others

Description

  • After you choose Verify myself & others, a multi-select user dropdown list appears.
  • When you submit:
    • Nametag sends each selected user and you a DM containing a verification link.
    • Nametag posts a status message in the current conversation.
    • If the bot is not in the current conversation, Nametag creates a group DM with the selected users and posts the status message there instead.
    • Nametag posts progress updates in the message thread when the verification status changes.
    • When a verification is completed, Nametag may include the verified name in the thread updates posted in Slack.

User selection rules

Slack’s built-in user picker can include:

  • Bots
  • Yourself
  • External Slack Connect users

Validation: You can only complete the request if you selected at least 1 member who is not a bot and not yourself.

External Slack Connect users

If you select an external user, Nametag will check whether:

  • the Nametag bot is already part of a conversation where it can message that external user, and
  • Nametag is able to communicate with that person in Slack.

If not, an inline error is shown and the user will not be able to submit the request.

Label behavior

  • Label is optional
  • In Verify myself & others, the same label is applied to all requests created in that submission.

Description

When you choose Create a shareable link and submit:

  • Nametag generates one verification link.
  • Nametag sends:
    • a message containing the link, and
    • a status message
  • If the bot is part of the conversation, both messages are sent in the channel, and the link message is only visible to you (ephemeral).
  • If the bot is not part of the conversation, both messages are sent in a DM to the requestor.
  • Nametag posts progress updates in the message thread when the verification status changes.

Label behavior

  • Label is optional
  • In Create a shareable link, the label is applied to the single generated request.

Environment & template selection

Environment dropdown list

  • If your Slack integration is connected to multiple environments, the dialog shows an Environment dropdown list and the user must pick one before submitting.
  • If there is only one environment, the environment dropdown list is not shown.

Templates dropdown list

  • If the selected environment has multiple templates, the dialog shows a Template dropdown list and the user must pick one before submitting.
  • If there is only one template, the template dropdown list is not shown.
  • A default template is always configured and will be used automatically when no template selection is required.

Installing the Nametag Slack bot

To use the Nametag Slack integration, you must first connect a Slack workspace from the Nametag console.

Installation steps

  1. In the Nametag console, go to Configure.
  2. In the left sidebar, select Slack.
  3. Select Connect a Slack Workspace.
Connect a Slack Workspace
  1. You’ll be redirected to Slack to authorize the app.
  2. Choose the Slack workspace you want to connect.
  3. Review the requested permissions.
  4. Select Allow to complete the installation.
Allow Nametag Verifier to access Slack

Once completed, the Nametag bot will be installed in the selected Slack workspace and available for use with the /nametag command.

Required Slack permissions and scopes

Nametag Verifier requests the following Slack OAuth scopes to support its functionality. Each permission is used to enable user-initiated verification flows and related status updates.

Scope explanations

  • commands Required to register and handle the /nametag slash command, which opens the Nametag verification dialog.
  • channels:read Used to determine basic information about channels and whether the bot is part of the current conversation.
  • chat:write Allows the app to post status messages and send verification-related messages in Slack in response to user actions.
  • groups:read Used to read basic information about private channels to support posting status messages when applicable.
  • im:read Used to read basic information about direct message conversations to determine where messages and updates can be sent.
  • im:write Required to send direct messages containing verification links and status updates.
  • mpim:read Used to read basic information about group direct message conversations to determine whether status updates can be posted there.
  • mpim:write Required to open or create group direct messages and post messages when the bot is not part of the original conversation.
  • team:read Used to identify the Slack workspace associated with the installation and map it to the correct Nametag environment.
  • users:read Used to look up Slack users to:
    • validate selected users (for example, exclude bots or the requesting user)
    • display user names in verification status updates
  • users.profile:read Used to read Slack user profile fields needed to create or update a Nametag organization member, specifically:
    • the user’s email address
    • the user’s real name

Permission usage principles

  • The app sends messages in response to explicit user actions and to provide follow-up status updates for verification requests initiated by the user.
  • Status updates may be posted asynchronously (for example, as threaded messages) when the state of a verification request changes.
  • The app does not read or store Slack message content beyond what is required to deliver verification links and status updates.
  • No permissions are used for background monitoring or unsolicited messaging.

How to view the permissions the app needs

During installation, Slack will show the permissions required by the Nametag Verifier app.

You can review the granted permissions at any time in Slack:

  1. Open a conversation with Nametag Verifier.
  2. Select the bot name.
  3. Open the About tab.
  4. Select See all permissions.

This shows the full list of permissions granted to the Nametag Slack app.

Adding the bot to a conversation

Add to a channel

Any member who can manage the channel can typically add apps by either:

  • Typing: /invite @Nametag Verifier in the channel, or
  • Opening the channel header → Integrations / Apps → Add apps → select Nametag Verifier

Why this matters

Being “in the conversation” changes message delivery: