3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

This node interacts with the 3CX telephony system, specifically allowing users to update entries in the Black List Numbers resource. The "Update Black List Number" operation modifies an existing blacklisted phone number's details such as the caller ID and description. This is useful for managing unwanted or blocked callers dynamically within automated workflows.

Practical examples include:

  • Automatically updating the description of a blacklisted number when new information is received.
  • Changing the caller ID associated with a blacklisted entry based on updated data from another system.

Properties

Name Meaning
Id The unique identifier of the black list number entity to update. Required.
Caller Id The phone number or caller ID to associate with the black list entry.
Description A textual description or note about the black list number entry.

Output

The node outputs JSON data representing the updated black list number entity after the update operation completes. This typically includes fields such as the Id, CallerId, Description, and any other metadata returned by the 3CX API confirming the update.

No binary data output is indicated.

Dependencies

  • Requires an active connection to a 3CX telephony system via an OAuth2 authenticated API credential.
  • The node expects the base URL of the 3CX server to be configured in the credentials.
  • The API requests are made to the /xapi/v1 endpoint of the 3CX server.

Troubleshooting

  • Missing or invalid Id: Since the Id property is required, omitting it or providing an incorrect value will cause the update to fail. Ensure the Id corresponds to an existing black list number.
  • Authentication errors: If the OAuth2 token is expired or invalid, the node will not be able to communicate with the 3CX API. Refresh or reconfigure the API credentials.
  • Invalid Caller Id format: Providing an improperly formatted phone number may result in API rejection. Validate the Caller Id before sending.
  • Network issues: Connectivity problems to the 3CX server will cause request failures. Verify network access and server URL correctness.

Links and References

Discussion