> For the complete documentation index, see [llms.txt](https://docs.codewords.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codewords.ai/~/revisions/CBsznWzxyNtIJHNMAo7I/whatsapp-automations/for-whatsapp-groups.md).
# For WhatsApp Groups
### What are WhatsApp Group Automations
**WhatsApp Group Automations** help you manage your group chats. They can:
* Listen to messages and respond automatically
* Run predefined workflows
* Send announcements, reminders, and polls
* Welcome new members
* Track engagement and group activity
* Analyze messages to share insights
They are workflow automations that you can use to keep your WhatsApp groups active, organized, and responsive — even when you’re offline.
### Why Build WhatsApp Automations with CodeWords
CodeWords makes it easy to build, run, and manage your automations with natural language and no coding required.
Here’s why users choose to build automations for WhatsApp on CodeWords :
1. Build WhatsApp Automations by telling **Cody** what you want
2. Connect WhatsApp automations with 2,700+ apps and AI models
3. Secure & private as your data stays protected
4. Launch a working WhatsApp automation in under 10 minutes
### What WhatsApp Group Automations Can You Build
| Use Case | What It Does | Example |
| ------------------ | ----------------------------------------------- | -------------------------------------------------------------- |
| Team Assistant | Answers FAQs instantly | “What’s the Wi-Fi password?” → Assistant replies automatically |
| Welcome Assistant | Greets new members | “Welcome, John! Here’s our group guide 📘” |
| Daily Digest | Sends group summaries | “Yesterday: 45 messages, Here is the summary" |
| Poll Tracker | Monitors and reports poll results | “🎉 Poll closed! Pizza wins with 10 votes 🍕” |
| Engagement Tracker | Tracks reactions and member activity | Weekly leaderboard of top contributors |
| Community Manager | Schedules events and sends reminders | “Team meeting tomorrow at 10 AM 📅” |
| Execute Workflows | Executes a workflow you have built on CodeWords | "Run Linkedin Scraper and store summary in Notion" |
### How WhatsApp Automations Work
{% stepper %}
{% step %}
#### The Group
You add the **CodeWords WhatsApp number** (+447466216790) to your WhatsApp group to link an automation.
{% endstep %}
{% step %}
#### Event detection
The configured automation listens for your defined trigger, key events — like messages, reactions, or new members.
{% endstep %}
{% step %}
#### Trigger your Automation
When a trigger event happens, CodeWords automatically runs your custom Whatsapp Automation.
{% endstep %}
{% step %}
#### Processes & Responds
The workflow automation uses AI to analyze the message, take action, and send a response back to the group — just like a real assistant.
{% endstep %}
{% endstepper %}
### Event Types the WhatsApp Automations on CodeWords can Detect
| Event Type | When It Happens | Example Uses |
| ------------------ | ---------------------------- | ------------------------------------ |
| `message:in:new` | When someone sends a message | Reply, log, or summarize content |
| `group:update` | Members join or leave | Welcome messages, update tracking |
| `message:update` | Polls or event changes | Share updated results |
| `message:reaction` | Emoji reaction added | Track engagement or popular messages |
### Setting Up Your First WhatsApp Assistant
{% stepper %}
{% step %}
#### Build the Assistant through chat
Describe the kind of WhatsApp Assistant you want to create with your defined trigger, this can be a workflow automation.
Example 1: "Create a WhatsApp Assistant for my group that’s connected to an LLM and automatically responds to any message from group members."
Example 2: "Create a WhatsApp Assistant for my group that takes article URLs posted, adds it to my notion table with metadata. Only trigger if there is URL that is posted."
{% endstep %}
{% step %}
#### Register your number
Tell **Cody** your number:
> “Register my phone number +447000000000 for the WhatsApp group Assistant.”
Cody will create your registration and send setup instructions.
{% endstep %}
{% step %}
#### Add the CodeWords number to your WhatsApp group
1. Open your group → Tap group name → “Add participant”
2. Add +447466216790
3. Confirm addition
You’ll see:
{% hint style="success" %}
"+447466216790 was added"
{% endhint %}
{% endstep %}
{% step %}
#### Mention the Assistant
In your group, type:
```
@CodeWords
```
You’ll get confirmation:
{% hint style="success" %}
Assistant Successfully Linked!
{% endhint %}
{% endstep %}
{% step %}
#### Test your Assistant
Send any message in the group — the Assistant will detect any trigger and respond through your Custom WhatsApp Group Assistant.
{% endstep %}
{% endstepper %}
### Connect an existing WhatsApp Automation template
{% stepper %}
{% step %}
#### Access the template
Go to the Run Page for the WhatsApp Automation template and review its description to understand how it works.
{% endstep %}
{% step %}
#### Run the template
Enter your phone number (including country code), then run the Automation template & register your number with the autuomation.
You’ll see:
{% hint style="success" %}
Workflow automation registration created successfully!
{% endhint %}
Follow the instructions thats shown.
{% endstep %}
{% step %}
#### Add the CodeWords to your WhatsApp group
1. Open your group → Tap group name → “Add participant”
2. Add +447466216790
3. Confirm addition
You’ll see:
{% hint style="success" %}
"+447466216790 was added"
{% endhint %}
{% endstep %}
{% step %}
#### Mention CodeWords
In your group, type:
```
@CodeWords
```
You’ll get confirmation:
{% hint style="success" %}
Automation Successfully Linked!
{% endhint %}
{% endstep %}
{% step %}
#### Test your Automation
Send any message in the group — the Assistant will detect it and respond through your Custom WhatsApp Group Assistant.
{% endstep %}
{% endstepper %}
Once your automation is set up, you can manage its WhatsApp trigger directly from the [Triggers](https://codewords.agemo.ai/workflows/triggers) page including pausing or deleting it at any time.\
Alternatively, you can simply ask **Cody** to remove the trigger if you no longer want the automation to run.
### Cost
| Automation Message Type | Cost per Message | Examples |
| ----------------------------- | ----------------------------------------- | ------------------------------------------ |
| Text, Poll, Event, Location | €0.002 + Cost of executing the Automation | “Daily update,” “New event added” |
| Image, Video, Audio, Document | €0.004 + Cost of executing the Automation | Reports, media summaries |
| Receiving messages | Free | You only pay for what the Automation sends |
### Privacy & Data Handling
#### Key Principle: Ephemeral by Default
Your Automation runs in short-lived sandboxes — fresh for every event and deleted right after.\
Each run lasts 2–30 seconds, then the environment is destroyed.
* Created new for each event
* Deleted after execution
* No local storage between runs
* No automatic data retention
**Meaning:**
* Your bot forgets everything after each run.
* Data is only kept if you *explicitly choose* to store it.
* This ensures privacy-first design — no accidental data retention.
### Getting Help
If your Assistant isn’t responding:
1. Confirm it’s linked (@CodeWords)
2. Ask Cody to verify your linked groups
3. Check in-app support or use live chat at [codewords.ai](https://codewords.agemo.ai/)
### FAQ
What’s the difference between WhatsApp Automation for Groups and Direct Messages?
| Who you message | WhatsApp **groups** (teams, communities) | Individuals (1:1) |
| ---------------- | ------------------------------------------- | -------------------------------------------------- |
| CodeWords number | +447466216790 | +447424366129 |
| Service window | No restrictions | 24-hour window after customer reply |
| Events | Messages, reactions, updates, group changes | Messages only |
| Message types | Text, media, polls, events, docs, etc. | Templates, text, images |
| Best for | Team coordination, community management | Notifications, support, sales, personal assistants |
Do I need to know how to code?
No. Describe what you want to Cody; it asks clarifying questions, builds, tests, and deploys.\
Developers: Full code patterns are available if you want to customize.
How do I set up a WhatsApp Group Automation?
Two phases:
1. Register your phone with Cody by running a WhatsApp Group automation template or register while building your own automation.
2. Add the CodeWords number (+447466216790) to the group and mention `@CodeWords bot`.\
You’ll see a ✅ confirmation; events start flowing to your Worklow Automation.
Do I register for each group?
Yes, you can refer to the steps [here](https://app.gitbook.com/o/7isqlJn3eTzit1bZKstj/s/C0KQHHlFG9y1F0pBotb8/~/changes/396/assistants/whatsapp-group-assistant#connect-an-existing-whatsapp-assistant-template).
What happens when I mention CodeWords?
The bot captures the **group ID**, links it to your registration, posts a **success** message, and starts forwarding events to your Workflow.
Can one automation template handle multiple groups?
Yes. Enter your phone number (with country code) on the Assistant’s Run Page and start it.\
Then in WhatsApp:
1. Add the CodeWords number to the group you want to link
2. Mention it by sending: `@CodeWords`
You’ll receive a “CodeWords workflow Successfully Linked!” confirmation.
Follow the exact steps shared [here](https://app.gitbook.com/o/7isqlJn3eTzit1bZKstj/s/C0KQHHlFG9y1F0pBotb8/~/changes/396/assistants/whatsapp-group-assistant#connect-an-existing-whatsapp-assistant-template).
What’s the CodeWords number I should add?
**Group Assistant**: +447466216790 (add to groups)\
**Direct Messaging Assistant**: +447424366129 (1:1 DMs)
I mentioned the CodeWords before registering—now what?
You’ll see “**No Active Registration.**”\
Fix: Register your phone with Cody, then mention CodeWords again in the group.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.codewords.ai/~/revisions/CBsznWzxyNtIJHNMAo7I/whatsapp-automations/for-whatsapp-groups.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.