Setup: GroupMe Copilot Image Bot

Step 1: Configure Your Bot & Generate Script

Fill out the form below with your details. Once complete, click the "Generate & Download Script" button at the bottom. This will create a personalized Code.gs file for you.

GroupMe Access Token * Find this at dev.groupme.com/applications. This single token is used for both reading and sending messages.

Image Forwarding Email * The email address where all forwarded images will be sent. Use your phone's SMS/MMS gateway email for easy saving.

Group ID * Get the Group ID from the URL when viewing the group on GroupMe's website (e.g., .../web/groups/12345678).

Group's Friendly Name * A name for your group, used in email subjects for clarity.

Advanced Email Settings (Optional)

Admin Email for Logs Your email, for reference in the script's execution logs in case of errors.

CC Emails Comma-separated list of emails to CC on forwarded image emails.

BCC Emails Comma-separated list of emails to BCC on forwarded image emails.

Custom Subject for Non-Copilot Emails Customize the subject for images from regular users. Uses placeholders like {{senderName}}.

Custom Body Intro for Non-Copilot Emails HTML is allowed. Use the same placeholders as the subject line.

Step 2: Google Apps Script Project Setup

Go to script.google.com and click "+ New project".
Rename the project to something descriptive (e.g., "GroupMe Copilot Bot").
The editor opens with a Code.gs file. Delete all the default content inside it.
Open the Code.gs file you just downloaded from this page. Copy its entire content.
Paste the content into the empty Code.gs file in your Apps Script project.
Click the Save project icon (💾).

Step 3: Deploy as a Web App

In the Apps Script editor, click the blue "Deploy" button (top right) and select "New deployment".
Click the gear icon (⚙️) next to "Select type" and choose "Web app".
Fill in the details:
- Description: e.g., "GroupMe Bot v6"
- Execute as: "Me (your.email@example.com)"
- Who has access: "Anyone"
Click "Deploy".
Authorize Permissions: A new window will pop up. Click "Authorize access", choose your Google account, click "Advanced", then "Go to [Project Name] (unsafe)", and finally "Allow".
After authorizing, a "Deployment successfully updated" window appears. Copy the Web app URL. You'll need it in the next step.

Step 4: Create the GroupMe Bot

Go to https://dev.groupme.com/bots and click "Create Bot".
Select the GroupMe group where the bot will live.
Give your bot a name (e.g., "Copilot Listener").
In the "Callback URL" field, paste the Web app URL you copied from the previous step.
Click "Submit". Your bot is now in your group!

Step 5: Set Up Time-Driven Triggers

These triggers automatically check for new images, ensuring nothing is missed even if the callback fails.

In your Apps Script project, click the "Triggers" icon (⏰ clock) on the left sidebar.
Click "+ Add Trigger" (bottom right).
Configure the first trigger for Copilot images:
- Choose which function to run: checkAndEmailCopilotImages
- Select event source: Time-driven
- Select type of time-based trigger: Minutes timer
- Select minute interval: Every minute
- Failure notification settings: Notify me immediately
- Click Save.
Configure the second trigger for other images:
- Choose which function to run: manuallyProcessRecentGroupMeImages
- Select event source: Time-driven
- Select type of time-based trigger: Minutes timer
- Select minute interval: Every minute
- Click Save.

Step 6: Testing

Your bot should now be fully operational. Here's how to test it:

'+' Command: In your GroupMe chat, type + tell me a joke. The bot should immediately (acting as you) post a new message: @Copilot tell me a joke.
Copilot Image Emailing: Ask Copilot for an image (e.g., @Copilot show me a picture of a cat). When it posts an image, you should receive an email at the address you configured. This may take up to a minute due to the trigger.
Other User Image Emailing: Post any image to the group yourself. You should receive an email at the same address. This may also take up to a minute.
Troubleshooting: If something doesn't work, go to the "Executions" page (📊 icon) in your Apps Script project to view logs and identify errors.

Unlock the Bot Generator