Automatic Promotion of YouTube Videos
This flow automates the distribution of each new video published on your YouTube channel, detecting its release and sharing it immediately on your networks, mailing lists, or other communication channels. Its goal is to maximize reach without i
📄 Documentation – Automatic Promotion of YouTube Videos
The workflow automatically detects newly‑published videos on a YouTube channel, generates an engaging summary, and posts an announcement to Telegram (and other channels if desired). It eliminates manual monitoring, ensuring every new video is promoted immediately.
🧩 Overview
The workflow monitors a YouTube channel’s RSS feed, extracts any video published within the last 24 hours, retrieves its transcript, summarizes the content, and sends a concise, inspiring message to a Telegram chat. This automation maximises audience reach and keeps the promotion process fully unattended.
⚙️ Main Features
- Real‑time feed monitoring – Periodically polls the channel’s RSS feed for new videos.
- Automatic new‑post detection – Parses the feed and flags videos released within the last 24 hours.
- Batch processing – Handles each new video concurrently for speed.
- Transcript extraction – Calls the YouTube Transcripts tool to obtain spoken content.
- AI‑generated summary – Uses OpenAI to produce a concise, engaging recap.
- Telegram broadcasting – Sends the formatted announcement to a specified chat.
🔄 Workflow Steps
| Component Name | Role in the Workflow | Key Inputs | Key Outputs |
|---|---|---|---|
| Consulta feeds de un canal de Youtube | Retrieves the YouTube channel’s RSS feed XML. | Feed URL (https://www.youtube.com/feeds/videos.xml?...) |
Raw XML feed data |
| Parse XML | Converts the XML into a structured format and extracts new entries. | XML data | Structured JSON of all feed entries |
| Data Batch Agent (New Posts) | Filters entries to those published within 24 hours and formats them for batch processing. | Parsed JSON data | JSON string containing a list of new video records |
| JSON to Data | Transforms the JSON string into a list of Data objects that can be iterated over. | JSON string of new videos | Data objects (each representing one video) |
| Data batch Agent (Worker) | Distributes each Data object to the worker agent, enabling parallel handling of multiple videos. | List of Data objects | Queue of tasks for the worker agent |
| YouTube Transcripts | Retrieves the transcript of a given YouTube video URL. | Video URL | Transcript text (plain or chunked) |
| Worker Agent (Summary & Telegram) | Generates an engaging summary from the transcript, then posts the announcement via Telegram. | Transcript text, Video metadata (URL, title, publish time) | Text message ready for Telegram, Telegram API response |
| Telegram Message | Sends the final message to the designated chat. | Message text, Chat ID, Bot token | Confirmation of message delivery |
The order shown above reflects the sequential data flow of the workflow.
🧠 Notes
- Scheduling – The workflow is intended to run on a regular schedule (e.g., hourly) to ensure fresh content is captured promptly.
- Credentials – A valid OpenAI API key and a Telegram bot token must be supplied; these are stored as credentials in the environment and referenced via the respective components.
- Language – The transcript extraction and summary generation are configured for Spanish (
es), but the language can be switched by adjusting thelanguagefield in the YouTube Transcripts component. - Error handling – If the RSS feed is unreachable or the transcript extraction fails, the workflow logs the error but continues processing any remaining videos.
- Batch limits – The data batch agent limits concurrency to a configurable number (default 5) to respect API rate limits.
- Extensibility – Additional broadcast channels (e.g., Slack, email) can be added by integrating corresponding messaging components within the worker agent.
This documentation captures the functional flow of the YouTube video promotion automation, providing a clear, concise reference for users and developers alike.