Assign Roles via buttons

In this guide, we will create a button on a message that will give a role when someone clicks the button and sends a message about which role they got.

Clicking the button again will remove their role and sends a message about which role got removed from them

Sapphire Assign Roles via buttons Example

1) Create a message template

Go to the Message Template page from the messages menu on Sapphire dashboard and create a new template by clicking the "Create new template" button.

Sapphire Assign Roles via buttons Create a message template

Note

We will call this template as "Main Message" because it's the one that has select menu. When someone clicks the option in select menu, it gives a role and sends a message which is only visible to that user.

2) Design your Main Message

For this guide, we will design a simple server welcome message which will have a button called "Yellow Role"

Sapphire Assign Roles via buttons Design your Main Message

3) Add the Button to the Main Message

Click the "+ Action Row" to add an action row in the message template. Then click the "+ Button" to add a button.

Sapphire Assign Roles via buttons Add the Button to the Main Message

4) Configure the Button on Message Template

Click the ⚙ on the button, then click "Select an action".

Sapphire Assign Roles via buttons Configure the Button on Message Template

5) Create a New Action

If you've already created any button components, they'll appear in the actions list. Since we haven't created any components yet, we'll see an option to create a new button component.

Click on "New action" to create a new button component.

Sapphire Assign Roles via buttons Create a New Action

6) Enter a name for your Button Component

Type in a name for your button component and click the ✅. This will make a new button component and link it to this button.

Sapphire Assign Roles via buttons Enter a name for your Button Component

7) Create another message template

Create a new message template, just like we did in step 1. Sapphire will send this template when someone clicks the button.

For this guide, we will create a button to give user a role and send a confirmation message. So, I have created a new message template and entered some variables and text.

I have given this message content below so you can copy and paste it into your message template.

Sapphire Assign Roles via buttons Create another message template

Role Assign Confirmation Message

 <:sapphSmile:924030133642354740> **Role Added** ${rolesadded}
 
 <:sapphSad:909078279116435456> **Role Removed** ${rolesremoved}

Note

Explanation for the message give above:

<:sapphSmile:924030133642354740> this is a sapphire emoji id which will show sapphire emoji on the message

**Role Added** - Bold text

${rolesadded} - Roles Added Variable, this will show which role the user got after clicking the Select Menu

${rolesremoved} - Roles Removed Variable, this will show which role is removed from the user got after clicking the Select Menu

Sapphire Assign Roles via buttons Remove Empty Lines

8) Remove Empty Lines

Go to the variables menu on the template editor of the message you created on the previous step and enable the option Remove Empty Lines

Sapphire Assign Roles via buttons Remove Empty Lines

Note

The option Remove Empty Lines will hide the line from message template if the variable used on the line is empty. We use it on this template so that it only show the roles added to the user or removed from the user.