Asterisk icon

Asterisk

Interact with Asterisk PBX via ARI (Asterisk REST Interface)

Bridges → Add Channel

AI-generated

Overview

This node interacts with the Asterisk PBX system via the Asterisk REST Interface (ARI) to manage call bridges. Specifically, the 'Add Channel' operation allows users to add a specified channel to an existing bridge. This is useful in telephony scenarios where calls need to be dynamically connected or grouped within a bridge for conferencing or call control purposes.

Use Case Examples

  1. Adding a user's call channel to a conference bridge to enable multi-party communication.
  2. Dynamically including a new participant's channel into an ongoing call bridge during a support call.

Properties

Name Meaning
Bridge ID The unique identifier of the bridge to which a channel will be added.
Channel ID The identifier of the channel that will be added to the bridge.
Role Optional role of the channel within the bridge, defining its function or permissions.

Output

JSON

  • bridgeId - The unique ID of the bridge where the channel was added.
  • channelId - The ID of the channel that was added to the bridge.
  • role - The role assigned to the channel within the bridge, if specified.

Dependencies

  • Requires connection to an Asterisk PBX system via the Asterisk REST Interface (ARI).
  • Needs API authentication credentials for the Asterisk system.

Troubleshooting

  • Ensure the Bridge ID and Channel ID are correct and exist in the Asterisk system; invalid IDs will cause errors.
  • Check that the API credentials have sufficient permissions to modify bridges and channels.
  • Network connectivity issues to the Asterisk server can cause request failures.
  • If the role field is used, verify that the role value is supported by the Asterisk bridge configuration.

Links

Discussion