3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

This node integrates with the 3CX telephony system to manage blacklisted phone numbers. Specifically, the "Create Black List Number" operation allows users to add a phone number to the blacklist, preventing unwanted calls from that number. This is useful in scenarios such as call centers or businesses wanting to block spam or nuisance callers automatically.

Practical examples include:

  • Automatically adding a caller ID to the blacklist after a complaint.
  • Managing a dynamic list of blocked numbers based on user input or external triggers.

Properties

Name Meaning
Caller Id The phone number (caller ID) to be added to the blacklist.
Description A textual description or note about the blacklisted number (e.g., reason for blocking).
Id An identifier for the blacklist entry (optional or system-generated depending on API).

Output

The node outputs JSON data representing the result of the blacklist creation request. This typically includes confirmation details such as the created blacklist entry's ID, the caller ID, and any associated metadata returned by the 3CX API.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the 3CX telephony system.
  • Needs the 3CX server URL configured in the credentials.
  • The node sends requests to the 3CX API endpoint /xapi/v1.

Troubleshooting

  • Authentication errors: Ensure the API key credential and server URL are correctly configured.
  • Invalid Caller Id format: Verify the phone number format matches what 3CX expects.
  • API endpoint errors: Check network connectivity and that the 3CX server is reachable.
  • Missing required properties: Make sure Caller Id is provided; otherwise, the API may reject the request.

Links and References

Discussion