VideoDB icon

VideoDB

Interact with the VideoDB API

Overview

This node integrates with the VideoDB API to perform various video-related operations. Specifically, the "Record Meeting" operation allows users to record a meeting by providing details such as the meeting URL, bot information, and callback settings. This is useful for automating the capture and processing of online meetings or webinars, enabling workflows that require meeting recordings to be stored, analyzed, or shared.

Practical examples include:

  • Automatically recording and saving online meetings from platforms that provide URLs.
  • Using a bot identity (name and image) to personalize the recording session.
  • Setting up callbacks to notify other systems when the recording is complete or updated.
  • Streaming meeting data in real-time for live transcription or monitoring.

Properties

Name Meaning
Collection Name or ID Select or specify the collection where the meeting recording will be stored.
Meeting URL The URL of the meeting to be recorded.
Bot Name Optional name of the bot that will appear during the recording session.
Bot Image URL Optional URL of an image/avatar representing the bot.
Meeting Title Optional title for the meeting recording.
Callback URL Optional URL to receive callbacks about the recording status or events.
Callback Data Optional JSON object containing additional data to send with the callback.
Time Zone Time zone setting for the meeting recording timestamps; defaults to "UTC".
Realtime Stream Boolean flag indicating whether to enable real-time streaming of the meeting content.

Output

The node outputs a JSON object containing the response from the VideoDB API after attempting to record the meeting. This typically includes metadata about the recording session, such as IDs, status, and any relevant messages returned by the API.

If real-time streaming is enabled, the node may also handle streaming data, but this is managed internally and not explicitly output as binary data in the node's main output.

Dependencies

  • Requires an API key credential for authenticating with the VideoDB API.
  • The node uses the VideoDB API base URL, defaulting to https://api.videodb.io if not specified in credentials.
  • Network access to the VideoDB API endpoint is necessary.
  • No additional environment variables are required beyond the API authentication token.

Troubleshooting

  • Invalid or missing API key: Ensure the API key credential is correctly configured and has the necessary permissions.
  • Collection not found: Verify that the specified collection ID or name exists in your VideoDB account.
  • Incorrect meeting URL: Confirm the meeting URL is valid and accessible.
  • Callback failures: If using a callback URL, ensure it is reachable and properly handles incoming requests.
  • Time zone issues: Use valid time zone strings; otherwise, timestamps may be incorrect.
  • Network errors: Check internet connectivity and firewall settings that might block access to the VideoDB API.

Common error messages usually originate from the API and indicate issues like authentication failure, invalid parameters, or server errors. Reviewing the API response in the node output can help diagnose these problems.

Links and References

Discussion