Blocklist Extension

Table of Contents:

1. Introduction
2. How It Works
3. Installation and Configuration
4. User Manual
5. Support

 

Introduction

The Blocklist is an extension that allows you to block and unblock malicious contacts through the Blip platform.

As an example of its functionality, think about the large number of contacts that companies receive every day. Amongst these contacts, there may be malicious users. This is where the Blocklist comes in, allowing you to block these contacts through the Blip platform, without disrupting the company's daily operations and work environment. 

 

How It Works

The Blocklist extension was developed with the aim of enabling the blocking of malicious contacts that communicate with companies through the use of Blip.

The following features are offered:

• Contact blocking
• Contact unblocking

Furthermore, it is supported on all channels as long as the user has been registered in the system.

 

Installation and Configuration

To use the Blocklist extension, you need to access the contract where you want to install it and then access the Router bot. Once there, navigate to the extensions section, where the Blip Store will open, and search for “Blocklist”. Once you find it, you need to activate it and install it.

After it has been activated and installed, you need to make a small adjustment in the builder for it to function correctly. Follow the steps below:

Step 1) Access the bot that you use as the "Main" for user arrival.

Step 2) After entering your main bot, click on "Builder," as shown in the image.

Step 3) Once in the builder of your main bot, click on the start block, as in the example.

Step 4) After clicking on the start block, a modal will appear on the right side of your screen. Click on "exit conditions," as follows.

Step 5) After clicking on the exit conditions, simply enter the desired exit conditions according to what you want to happen to the blocked user who contacts your bot.

Use the variable "contact.extras.blocklistStatus" to handle the conditions. This variable can return "userBlocked" for blocked users and "userUnblocked" for unblocked users. Note that "userUnblocked" will only appear for those contacts who have been blocked at least once and are currently unblocked.

See the example in the image below, in this case, we chose to send the blocked contact to a block specifically designed for blocked contacts.

 

 

Therefore, with the extension installed, activated, and the previous steps taken to define what the bot should do with blocked users, whether to ignore them, send something, or perform other actions, the extension is ready to be used.

User Manual

Users with administrator permissions can perform all functions of the extension, including blocking and unblocking contacts already present in the Blip contact base.

Once the Blocklist extension is installed and the user has administrator permissions, when accessing it, they will be able to use the extension and will encounter the following screen:

 

 

Blocking Contacts

Step 1) To block contacts, on the main screen of the extension, in the upper right corner, simply click on the "Block a contact" button, as shown in the image below:

 

 

Step 2) Once you click on "Block a contact," as shown in the previous image, the following modal will open on the left side:

Now, you will need to enter the User ID of the contact you want to block in the "User ID" field. If you're unsure how to obtain the Contact Identifier (ID), refer to this Take Blip tutorial.

After entering the ID correctly, simply click on "Search", as shown below:

 

Once you click on "Search", the extension will search your Contacts for the provided identifier and return the contact found with some details about it:

 

Remember that at any time you can cancel the search and close the modal by clicking on "Cancel".

Step 3) Once the extension returns the contact you want to block, simply click on "Block," as shown below:

 

And then, the user will be blocked:

 

Unblocking Contacts

Step 1) On the main screen of the Blocklist extension, you can view the blocked contacts. To unblock a contact, simply click on the open padlock icon on the right side of the contact you want to unblock, as shown in the example below:

 

 

Once done, the contact will be unblocked.

 

Whenever you add a user to either the block or unblock list, you should reset the contact so that its block or unblock status can be verified.

Low Code State Reset Commands:

• Blip Low Code Commands Extension

Support

If you have any questions or encounter any issues with the extension, please contact us via email at blippartner@sharkdev.com.br or call us at +55 (35) 98802-9321.

For more information, visit the discussion on the subject in our community or the videos on our channel. 😃