Overview

This node interacts with the Asterisk PBX system via the Asterisk REST Interface (ARI) to manage telephony channels. Specifically, the 'Channels - Redirect' operation allows users to redirect an active channel to a different endpoint. This is useful in call routing scenarios where calls need to be dynamically redirected to another extension or device, such as forwarding a call to a different phone or voicemail.

Use Case Examples

1. Redirect an active call from one extension to another by specifying the channel ID and the new endpoint.
2. Automate call handling by redirecting calls to different endpoints based on business rules or user input.

Properties

Output

JSON

• channel - Details of the channel after the redirect operation.

Dependencies

• Requires an API key credential for authenticating with the Asterisk REST Interface (ARI).
• Needs the base URL of the Asterisk ARI server configured in credentials.

Troubleshooting

• Ensure the Channel ID is correct and the channel is active; otherwise, the redirect will fail.
• Verify that the Redirect Endpoint is valid and reachable within the Asterisk system.
• Common errors include authentication failures due to incorrect API credentials and network errors if the ARI server is unreachable.
• If the redirect operation fails, check Asterisk logs for detailed error messages and ensure the ARI user has sufficient permissions.

Links

• Asterisk ARI Redirect Documentation - Official documentation on how to use the redirect operation in Asterisk ARI.