Send Images over Telegram from Google Apps Script - Complete Guide

🚀 Automate Telegram Image Sharing with Google Apps Script

Looking to automate Telegram image sharing directly from Google Workspace? This guide walks you through sending images 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 image delivery 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. Image in Google Drive - Have the image 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 image 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:

• Line 3: Replace 12025550108 with the target phone number (including the country code)
• Line 4: Replace butterfly_flower.jpg with the filename of your image in Google Drive
• Line 17: Replace YOUR_INSTANCE_ID_HERE with your Telegram gateway instance ID
• Lines 18-19: Update YOUR_CLIENT_ID_HERE and YOUR_CLIENT_SECRET_HERE with your Client ID and Secret
• Line 43: Also update the hardcoded filename butterfly_flower.jpg to match your image filename

4. Upload Your Image to Google Drive

1. Upload your image 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 demoSendTelegramImageInDrive 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:

• Google Sheets automation - Send images via Telegram based on spreadsheet data or triggers
• Google Forms responses - Automatically send images when form submissions are received
• Google Drive workflows - Share images from Drive folders via Telegram automatically
• Scheduled reports - Use time-driven triggers to send daily/weekly image reports
• Business automation - Integrate Telegram image sharing with Google Workspace business processes
• Educational tools - Share educational images or materials via Telegram from Google Classroom workflows

🚀 Get Started Today

Ready to automate your image 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 images within minutes!

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