Use this method to add whitelist.
Field | Type | Required | Description |
method | String | Yes | "addToBlackist" |
app_id | String | Yes | Unique identifier for the App to which the user belongs. |
signups | Yes | Add an array of signups. | |
reference | String | Yes | A unique reference for the request (used for tracking or logging). |
Preconditions for API Functionality
The following tables outline the preconditions that must be met for the API to function correctly. Failure to meet these conditions may result in errors or unexpected behavior.
- Preconditions for API permissions
Before performing signup management messages, ensure the following conditions are met:
Action | Required Permission | Description |
signup Management | "Signup Management" | The API must have the "Signup Management" permission to manage both whitelist and blacklist settings. |
If you add the same user to the blacklist and whitelist, the priority goes to the blacklist.
This feature is limited to apps created using the nandbox app builder.
Response
addToBlacklist_ack
â
On success, the
addToBlacklist_ack method is returned, including an echo of the signup record.Field | Type | Returned | Description |
method | String | Yes | "addToBlacklist_ack " |
app_id | String | Yes | Unique identifier for App. |
signups | Yes | Array of Whitelist signup objects | |
reference | String | Optional | Unique identifier echoed from the request. |
Example Requests
json{ "method": "addToBlacklist", "app_id": "90090684293000559", "reference": 111111148, "signups": [ { "signup_id": "name@example.com", "tags": ["4"] } ] }
javaArrayList<String> users = new ArrayList<>(); users.add("16136147500"); users.add("test001@gmail.com"); api.addBlackList(incomingMsg.getChat().getId(), users); public void addBlackList(String chatId, List<String> users) { AddBlackListOutMessage addBlackListOutMessage = new AddBlackListOutMessage(); addBlackListOutMessage.setChatId(chatId); addBlackListOutMessage.setUsers(users); api.send(addBlackListOutMessage); } AddBlackListOutMessage addBlackListOutMessage = new AddBlackListOutMessage(); addBlackListOutMessage.setChatId(chatId); addBlackListOutMessage.setUsers(users); api.send(addBlackListOutMessage)
javascriptlet users = []; users.push("16136147500"); users.push("test001@gmail.com"); api.addBlackList(incomingMsg.chat.id, users);
Response
json{ "method": "addToBlacklist_ack", "app_id": "90090684293000559", "signups": [ { "id": "488", "signup_id": "name@example.com", "tags": [ "4" ] } ], "reference": 111111148 }