3CX icon

3CX

Interact with 3CX telephony system

Actions462

Overview

The node interacts with the 3CX telephony system, specifically providing an operation to retrieve fax information by a phone number. This is useful in scenarios where users need to fetch details about faxes sent or received through the 3CX system using the fax number as a key identifier. For example, a user might want to automate the retrieval of fax metadata or status for a given fax number to integrate it into a CRM or logging system.

Properties

Name Meaning
Number Phone number in international format (e.g., +1234567890). The fax number to retrieve.

Output

The output JSON contains the fax information associated with the provided phone number. This typically includes metadata such as fax status, sender/receiver details, timestamps, and possibly content references. If the node supports binary data, it would represent the actual fax document or attachments, but this is not explicitly detailed in the source code provided.

Dependencies

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

Troubleshooting

  • Common issues:
    • Invalid or missing phone number format: Ensure the number is in international format starting with "+".
    • Authentication failures: Verify that the API key credential and server URL are correctly set.
    • Network connectivity problems: Confirm that the n8n instance can reach the 3CX server URL.
  • Error messages:
    • Authorization errors indicate invalid or expired credentials; reauthenticate or update credentials.
    • "Not Found" errors may mean no fax exists for the given number; verify the number is correct.
    • Timeout or connection errors suggest network issues or incorrect server URL configuration.

Links and References

Discussion