Asterisk icon

Asterisk

Interact with Asterisk PBX via ARI (Asterisk REST Interface)

Channels → Unmute

AI-generated

Overview

This node interacts with the Asterisk PBX system via the Asterisk REST Interface (ARI) to manage channels, specifically to unmute a channel. It is useful in telephony scenarios where calls are managed programmatically, such as unmuting a call channel to allow audio transmission. For example, in a call center application, this node can be used to unmute an agent's call channel when they need to speak to a customer.

Use Case Examples

  1. Unmute a specific call channel by providing its unique Channel ID and specifying the direction of audio to unmute (inbound, outbound, or both).
  2. Use in automated call handling workflows to control audio states of channels dynamically.

Properties

Name Meaning
Channel ID The unique identifier of the channel to be unmuted. This is required to specify which channel the unmute operation applies to.
Direction Specifies the direction of audio to unmute on the channel. Options include 'both' (default), 'in' (inbound audio), and 'out' (outbound audio).

Output

JSON

  • channelId - The unique identifier of the channel that was unmuted.
  • direction - The direction of audio that was unmuted (both, in, or out).
  • status - The result status of the unmute operation, indicating success or failure.

Dependencies

  • Requires an Asterisk API credential with access to the ARI (Asterisk REST Interface) endpoint.

Troubleshooting

  • Ensure the Channel ID provided is correct and corresponds to an active channel in the Asterisk system.
  • Verify that the API credentials have sufficient permissions to perform channel operations via ARI.
  • Common errors include 'Channel not found' if the Channel ID is invalid, or 'Permission denied' if the API credentials lack necessary rights.
  • Network connectivity issues to the Asterisk server can cause request failures; verify the base URL and network access.

Links

Discussion