📖 User Guides & Support
💬 Discord Guide
Bot Commands

Discord Bot Commands

The MyNATCA Discord server uses a verification bot to help manage member verification and roles. This guide covers the commands available to members.

Getting Started with Commands

How to Use Commands

Discord commands start with a slash (/). Simply type the command in any channel where you have permission to use bot commands.

Examples:

  • /register - Start the verification process
  • /status self - Check your verification status

Where Commands Work

  • Most text channels - Commands work in channels where you have message permissions
  • Direct messages - Some commands work in private messages with the bot

Available Commands

Member Verification Commands

/register

Purpose: Link your Discord account to your MyNATCA member record Usage: /register What it does: Starts the Auth0 verification process to link your Discord account to your NATCA membership Who can use: All members

/status

Purpose: Check verification status Usage:

  • /status self - Check your own status
  • /status user @username - Check another user's status (Admin only)
  • /status member 123456 - Check status by member number (Admin only)

What it shows: Verification status, member information, and account links

Who can use: All verified members including:

  • NATCA Members (membertypeid=6)
  • NATCA Staff (membertypeid=8) - Enhanced October 2025
  • RNAV Members (membertypeid=10) - Enhanced October 2025

Recent Update (October 2025): The /status command now works for all member types. Previously, it only worked for regular NATCA members. Now Staff and RNAV members can use the command to check their verification status.

Example Output:

Regular Member:
✅ Verified Member
Name: John Doe
Member #: 123456
Member Type: NATCA Member
Roles: NATCA Member, FacRep

Staff Member:
✅ Verified Member
Name: Jane Smith
Member #: 789012
Member Type: NATCA Staff
Roles: NATCA Staff

RNAV Member:
✅ Verified Member
Name: Bob Johnson
Member #: 345678
Member Type: RNAV Member
Roles: RNAV Member

Administrative Commands (Admin Only)

/verify

Purpose: Manually verify a member (Administrator use only) Usage: /verify membernumber:123456 discorduser:@username What it does: Manually links a Discord account to a member record Who can use: Server administrators with Manage Roles permission

/unlink

Purpose: Unlink Discord accounts from member records What it does: Removes the connection between Discord and member accounts Who can use: Server administrators with Manage Roles permission

/refresh

Purpose: Refresh member roles and permissions What it does: Updates Discord roles based on current member data Who can use: Server administrators with Manage Roles permission

/validation

Purpose: Administrative validation commands What it does: Various validation and diagnostic functions Who can use: Server administrators with Manage Roles permission

Testing Commands (Updated October 2025)

The Discord bot includes a comprehensive test suite to ensure all commands work correctly, including the new Staff and RNAV member support.

Running Tests

# Run all command tests
npm test
 
# Run tests with detailed stack traces
npm run test:verbose

Test Coverage

The test suite validates:

  • All 7 slash commands with 18 test cases
  • Staff member handling (membertypeid=8) - New test coverage
  • RNAV member handling (membertypeid=10) - New test coverage
  • Command permissions and error handling
  • Mock Discord objects for reliable testing
  • Position-based nickname formatting for Staff and Chief of Staff
  • Role assignment verification for all member types

What Gets Tested

Member Type Support:

  • /status works for regular members (membertypeid=6)
  • /status works for Staff members (membertypeid=8)
  • /status works for RNAV members (membertypeid=10)

Role Assignment:

  • Regular members receive "NATCA Member" role
  • Staff members receive "NATCA Staff" role
  • RNAV members receive "RNAV Member" role

Nickname Formatting:

  • Regular members: "FirstName LastName (Region/Facility)"
  • Staff members: "FirstName LastName (Staff)"
  • Chief of Staff: "FirstName LastName (Chief of Staff)"
  • RNAV members: "FirstName LastName (RNAV)"

Getting Help

If you need assistance with Discord commands:

  1. Try the command - Most commands provide helpful error messages
  2. Check your permissions - Some commands require specific roles
  3. Ask in #general - Other members can help with basic questions
  4. Contact administrators - For verification issues or technical problems

Command Tips

Using Commands Effectively

Be Patient

  • Commands may take a few seconds to process
  • Don't repeat commands immediately if they don't respond

Check Your Permissions

  • Some commands require specific roles or permissions
  • Member commands work for verified members only
  • Admin commands require administrator permissions

Get Verification First

  • Most functionality requires completing the /register process
  • Verify your NATCA membership before trying other commands

Troubleshooting Commands

Command Not Working?

  1. Check if you're verified - Use /status self to check
  2. Complete registration - Use /register if not verified
  3. Check spelling - Commands must be typed exactly
  4. Try in a different channel - Some channels may restrict bot usage

Getting Error Messages?

  1. Read the error message - It usually explains the issue
  2. Verify your membership status - Ensure you're a current NATCA member
  3. Contact administrators - If the error persists

This bot is specifically designed for MyNATCA member verification and management. For technical support, contact the server administrators.

Discord VerificationTroubleshooting