Asterisk icon

Asterisk

Interact with Asterisk PBX via ARI (Asterisk REST Interface)

Actions76

Bridges → Record

AI-generated

Overview

This node interacts with the Asterisk PBX system via the Asterisk REST Interface (ARI) to manage call bridges, specifically to start recording a bridge. It is useful in telephony scenarios where calls or conferences need to be recorded for quality assurance, training, or compliance purposes. For example, recording a customer support call bridge or a conference call bridge.

Use Case Examples

  1. Recording a customer support call bridge with a specific recording name and format.
  2. Setting a maximum recording duration and enabling a beep before recording starts.

Properties

Name Meaning
Bridge ID The unique identifier of the bridge to record.
Recording Name The name assigned to the recording file.
Format The audio format of the recording (e.g., wav).
Max Duration Seconds Maximum duration of the recording in seconds; 0 means unlimited.
Max Silent Seconds Maximum silent seconds before the recording stops automatically.
If Exists Action to take if a recording with the same name already exists (fail, overwrite, or append).
Beep Whether to play a beep sound before starting the recording.

Output

JSON

  • recordingName - The name of the recording started on the bridge.
  • bridgeId - The unique ID of the bridge being recorded.
  • format - The format of the recording file.
  • maxDurationSeconds - Maximum duration set for the recording.
  • maxSilenceSeconds - Maximum silence duration before stopping the recording.
  • ifExists - The action taken if the recording already exists.
  • beep - Indicates if a beep was played before recording.

Dependencies

  • Asterisk PBX system with ARI (Asterisk REST Interface) enabled
  • API key credential for authenticating with the Asterisk ARI

Troubleshooting

  • Ensure the Bridge ID is correct and the bridge exists in the Asterisk system.
  • Verify that the API credentials are valid and have permission to record bridges.
  • If the recording fails to start, check if a recording with the same name already exists and the 'If Exists' option is set appropriately.
  • Network connectivity issues between n8n and the Asterisk server can cause failures.

Links

Discussion