Actions10
- clickToCall Actions
- Pop-Up Screen Actions
- callLog Actions
- External IVR Actions
- CDR Notifications Actions
- Dialer Actions
- Blacklist Actions
Overview
The node integrates with the Voicenter API to manage telephony-related resources. Specifically, for the Blacklist resource and the removeFromBlacklist operation, it removes specified phone numbers from a blacklist maintained by the Voicenter system. This is useful in scenarios where previously blocked or restricted phone numbers need to be reinstated or allowed again.
Practical examples include:
- Removing customer phone numbers from a call-blocking list after resolving disputes.
- Managing dynamic blacklists in call centers to allow certain numbers back into the calling pool.
- Automating cleanup of blacklists based on external triggers or workflows.
Properties
| Name | Meaning |
|---|---|
| Phones | List of phone numbers to remove from the blacklist. Each entry requires a phone number in E.164 format. Multiple entries can be provided. |
| Merge JSON parameters | Boolean flag indicating whether to merge additional parameters from a JSON input using lodash's merge function. Useful for appending or updating request parameters dynamically. |
| JSON | Raw JSON input used to provide additional parameters when "Merge JSON parameters" is enabled. This allows flexible customization of the request body beyond the standard fields. |
Output
The node outputs JSON data representing the response from the Voicenter API after attempting to remove the specified phone numbers from the blacklist. The structure typically includes success indicators, any error messages, and details about which numbers were successfully removed.
If the API supports binary data output (not indicated here), it would be summarized as related to the operation result or logs, but this node primarily deals with JSON responses.
Dependencies
- Requires an active connection to the Voicenter API via an API key credential configured in n8n.
- Uses the Voicenter API client internally to perform authenticated requests.
- Optionally depends on lodash's
mergefunction to combine JSON parameters if enabled.
Troubleshooting
- Invalid Phone Number Format: Ensure all phone numbers are in valid E.164 format; otherwise, the API may reject them.
- Authentication Errors: Verify that the API key credential is correctly set up and has sufficient permissions.
- Empty Phone List: The operation requires at least one phone number; providing an empty list will likely cause an error.
- Malformed JSON Input: If using the JSON parameter merging feature, ensure the JSON is well-formed to avoid parsing errors.
- API Rate Limits or Downtime: Network issues or API limits might cause failures; check connectivity and API status.
Common error messages usually relate to invalid input data or authentication failures. Resolving these involves validating inputs and credentials.
Links and References
- Voicenter API Documentation (replace with actual URL)
- E.164 Phone Number Format
- Lodash merge documentation