{ "nodes": [ { "id": "0721f8d0-1413-40ce-a5c4-9cbe6fd5a8c7", "name": "\ud83d\udccb MAIN \u2014 Workflow Overview", "type": "n8n-nodes-base.stickyNote", "position": [ -128, -912 ], "parameters": { "width": 780, "height": 1028, "content": "## \ud83c\udf99\ufe0f Product Update Audio Announcements \u2014 Changelog to TTS Audio\n\n**What this workflow does:**\nEvery time a new release is pushed to your GitHub repository (or a Notion changelog page is updated), this workflow:\n1. Fetches the raw changelog/release notes from GitHub Releases API\n2. Pulls the matching structured release notes from a **Notion** database (rich formatted content)\n3. Uses **OpenAI** to rewrite the technical changelog into a natural, podcast-style spoken script\n4. Sends the script to **ElevenLabs TTS API** to generate a professional MP3 audio file\n5. Uploads the MP3 via **UploadToURL** to get a permanent public audio URL\n6. Uses the **HTML node** to compose a beautifully formatted email newsletter with the audio player embed, changelog summary, and a 'Listen Now' CTA button\n7. Sends the newsletter via **Gmail** to your subscriber list (loaded from Google Sheets)\n8. Posts a Slack message to your internal `#product-updates` channel with the audio URL and release summary\n9. **Writes back** to the Notion changelog page \u2014 marks it as 'Audio Published' with the hosted audio URL\n\n**Architecture (unique from all previous templates):**\n- \ud83d\udc19 GitHub Trigger (watches releases \u2014 NEW trigger type)\n- \ud83d\udcd3 Notion \u2014 fetch release notes page (NEW: database query)\n- \ud83e\udd16 OpenAI \u2014 rewrite to spoken script (NEW: different prompt purpose)\n- \ud83c\udf99\ufe0f ElevenLabs TTS API \u2014 audio generation (NEW: TTS node)\n- \u2601\ufe0f UploadToURL \u2014 host the MP3 file (mandatory)\n- \ud83d\udccb Aggregate Node \u2014 bundle subscriber emails (NEW node type)\n- \ud83c\udf10 HTML Node \u2014 compose rich email body (NEW node type)\n- \ud83d\udce7 Gmail \u2014 send newsletter to subscribers (NEW: email delivery)\n- \ud83d\udcac Slack \u2014 post to #product-updates channel (NEW: Slack node)\n- \ud83d\udd04 Notion Update \u2014 write-back audio URL to source page (NEW: bidirectional)\n\n**Setup Requirements:**\n1. GitHub credentials (personal access token with `repo` read scope)\n2. Notion Integration Token \u2014 share your Changelog database with the integration\n3. Notion Database ID for your changelog (from the database page URL)\n4. OpenAI API credentials\n5. ElevenLabs API Key + your preferred Voice ID (from elevenlabs.io/voices)\n6. UploadToURL endpoint configured in upload node\n7. Gmail OAuth2 credentials\n8. Google Sheets with subscriber emails \u2014 sheet named `Subscribers` with column `Email`\n9. Slack Bot Token with `chat:write` scope \u2014 set channel to `#product-updates`\n10. Notion credentials again for the write-back step" }, "typeVersion": 1 }, { "id": "6eeaf206-5041-41fd-bd21-2e434d5e9389", "name": "\ud83d\udcdd Note \u2014 GitHub Trigger, Parse & Notion Fetch", "type": "n8n-nodes-base.stickyNote", "position": [ 704, 128 ], "parameters": { "color": 7, "width": 616, "height": 616, "content": "### \ud83d\udc19 Step 1 \u2014 GitHub Release Trigger & Notion Fetch\n**GitHub Trigger:** Fires on every new GitHub Release published to your repo (uses GitHub webhooks \u2014 not polling). Captures tag name, release name, release body (raw markdown changelog), author, and release URL.\n**Code \u2014 Parse Release:** Cleans the raw markdown changelog into plain text. Extracts version number, release date, and categorises changes into `features`, `fixes`, and `improvements` arrays by scanning bullet prefixes.\n**Notion \u2014 Query Database:** Searches your Notion Changelog database for a page matching the version tag. Retrieves the richer formatted description, product area tags, and any manually added context \u2014 supplements the raw GitHub release body." }, "typeVersion": 1 }, { "id": "aa818069-eff9-43f7-9f2d-143ba805908c", "name": "\ud83d\udcdd Note \u2014 Script, TTS & UploadToURL", "type": "n8n-nodes-base.stickyNote", "position": [ 1328, 112 ], "parameters": { "color": 7, "width": 1128, "height": 632, "content": "### \ud83c\udf99\ufe0f Step 2 \u2014 Script Writing, TTS Generation & Upload\n**OpenAI \u2014 Spoken Script:** Rewrites the combined GitHub + Notion content into a warm, conversational podcast-style spoken announcement (60-90 seconds when read aloud). Avoids markdown, bullet points, and jargon.\n**ElevenLabs TTS:** Sends the script to ElevenLabs `/v1/text-to-speech/{voice_id}` endpoint. Returns raw MP3 binary audio. Voice, stability, and similarity boost are all configurable.\n**UploadToURL:** Uploads the MP3 binary and returns a permanent public URL \u2014 this URL is used in the email embed, Slack message, and Notion write-back." }, "typeVersion": 1 }, { "id": "bb19ab3c-6d68-4732-82fa-ca35a56ddecf", "name": "\ud83d\udcdd Note \u2014 Subscribers, HTML Build & Gmail Send", "type": "n8n-nodes-base.stickyNote", "position": [ 2496, 112 ], "parameters": { "color": 7, "width": 1032, "height": 632, "content": "### \ud83d\udce7 Step 3 \u2014 Subscriber Load, HTML Email & Gmail Send\n**Google Sheets \u2014 Load Subscribers:** Reads all rows from the `Subscribers` sheet. Each row contains at minimum an `Email` field. Returns one item per subscriber.\n**Aggregate Node:** Bundles all subscriber email addresses into a single comma-separated string \u2014 used as the Gmail BCC list so one send covers all subscribers.\n**HTML Node:** Composes a fully formatted HTML email with: audio player embed (using `