Send Voice Notes over Telegram from Google Apps Script - Complete Guide

Automate Telegram Voice Note Sharing with Google Apps Script

Looking to automate Telegram voice note sharing directly from Google Workspace? This guide walks you through sending voice note files (OPUS format) to Telegram users using Google Apps Script and the WhatsMate Telegram Gateway REST API. Perfect for Google Workspace users, spreadsheet automation enthusiasts, and anyone who wants to integrate Telegram voice messaging with Google Drive, Sheets, or other Google services.

📋 Prerequisites

Before you begin, ensure you have:

1. A WhatsMate Telegram Gateway account - Required for API access
2. Recipient registration - Each recipient must register with the Gateway first
3. Google account - Access to Google Drive and Google Apps Script
4. Basic JavaScript knowledge - Familiarity with Google Apps Script (JavaScript-based)
5. Voice note file in Google Drive - Have the OPUS file you want to send uploaded to your Google Drive
6. Google Apps Script access - Ability to create and run scripts in Google’s script editor

⚠️ Important: Recipients must register with the WhatsMate Telegram Gateway before they can receive messages. Unregistered users will not receive any messages from the Gateway. Registration instructions are available on the official WhatsMate site.

📝 Step-by-Step Implementation

Follow these steps to send your first voice note to a Telegram user from Google Apps Script:

1. Create a New Google Apps Script Project

1. Go to script.google.com
2. Click “New Project”
3. Delete the default function and paste the following code:

2. Copy the Google Apps Script Code Template

Copy the following source code into your Apps Script project:

3. Configure a few Parameters

Customize these key parameters in the Google Apps Script code:

• Lines 2-5: Update the demoSendTelegramOpusInDrive function parameters:
  • Line 2: Replace 12025550108 with the target phone number (including the country code)
  • Line 3: Replace martin-luther-king.opus with the filename of your OPUS file in Google Drive
  • Line 4: Replace anyname.opus with your preferred filename for the recipient
  • Line 5: Replace I have a dream with your desired caption
• Lines 18-20: Update the sendTelegramOpus function parameters:
  • Line 18: Replace YOUR_INSTANCE_ID_HERE with your Telegram gateway instance ID
  • Lines 19-20: Update YOUR_CLIENT_ID_HERE and YOUR_CLIENT_SECRET_HERE with your Client ID and Secret

4. Upload Your Voice Note File to Google Drive

1. Upload your OPUS voice note file to Google Drive
2. Ensure the filename matches exactly what you specified in the script
3. Note: The script searches for files by name, so filenames must be unique in your Drive

5. Run Your Google Apps Script

1. Save your script project
2. Select the demoSendTelegramOpusInDrive function from the dropdown
3. Click the “Run” button (▶️)
4. Authorize the script when prompted (first time only)
5. Check the execution log for success confirmation

🔧 Common Use Cases

This automation approach is ideal for:

• AI/TTS integration - Generate voice messages using text-to-speech (TTS) APIs and deliver them to Telegram for automated announcements, notifications, or interactive voice responses
• Google Sheets automation - Send voice note notifications or messages via Telegram based on spreadsheet data or triggers
• Google Forms responses - Automatically send voice notes when form submissions are received
• Scheduled voice message delivery - Use time-driven triggers to send daily/weekly voice content
• Customer service automation - Send voice responses or information to clients via Telegram

🚀 Get Started Today

Ready to automate your voice note sharing over Telegram from Google Apps Script? You’ll need a trial account to access the API. Sign up for a 2-week trial and start sending voice notes within minutes!

Next Steps: Once you’ve mastered basic voice note sending, explore advanced features like sending audio files, images, or documents through the WhatsMate Telegram Gateway API documentation.