# 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 is 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:00.”                              |
| 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 and responses**

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 and register your number with the automation.

You’ll see:

{% hint style="success" %}
Workflow automation registration created successfully!
{% endhint %}

Follow the instructions 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 and data handling

#### Key principle: Ephemeral by default

Each run executes in a fresh sandbox that is destroyed after completion. Most runs complete in seconds, with a maximum lifetime of 30 minutes for complex workflows.

* 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/)

### FAQs

<details>

<summary>What’s the difference between WhatsApp Automation for Groups and Direct Messages?</summary>

| 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 |

</details>

<details>

<summary>Do I need to know how to code?</summary>

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.

</details>

<details>

<summary>How do I set up a WhatsApp Group Automation?</summary>

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, and events start flowing to your workflow automation.

</details>

<details>

<summary>Do I register for each group?</summary>

Yes, you can refer to the steps [here](#connect-an-existing-whatsapp-assistant-template).

</details>

<details>

<summary>What happens when I mention CodeWords?</summary>

The bot captures the **group ID**, links it to your registration, posts a **success** message, and starts forwarding events to your Workflow.

</details>

<details>

<summary>Can one automation template handle multiple groups?</summary>

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](#connect-an-existing-whatsapp-assistant-template).

</details>

<details>

<summary>What’s the CodeWords number I should add?</summary>

**Group Assistant**: +447466216790 (add to groups)\
**Direct Messaging Assistant**: +447424366129 (1:1 DMs)

</details>

<details>

<summary>I mentioned the CodeWords before registering—now what?</summary>

You’ll see “**No Active Registration.**”\
Fix: Register your phone with Cody, then mention CodeWords again in the group.

</details>

## Popular Group Bot Templates

Get started with a pre-built WhatsApp group bot template. Click any card to customize it with Cody.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Group Q&#x26;A Bot</strong></td><td>Add an AI assistant to your group that answers questions from a shared knowledge base — FAQs, docs, or wikis.</td><td><a href="https://codewords.agemo.ai/chat?sendAutomatically=true&#x26;initialMessage=SSB3YW50IHRvIGJ1aWxkIGEgV2hhdHNBcHAgZ3JvdXAgUSZBIGJvdCB0aGF0IGFuc3dlcnMgcXVlc3Rpb25zIGZyb20gYSBzaGFyZWQga25vd2xlZGdlIGJhc2UuIEhlbHAgbWUgc2V0IGl0IHVwLg%3D%3D">https://codewords.agemo.ai/chat?sendAutomatically=true&#x26;initialMessage=SSB3YW50IHRvIGJ1aWxkIGEgV2hhdHNBcHAgZ3JvdXAgUSZBIGJvdCB0aGF0IGFuc3dlcnMgcXVlc3Rpb25zIGZyb20gYSBzaGFyZWQga25vd2xlZGdlIGJhc2UuIEhlbHAgbWUgc2V0IGl0IHVwLg%3D%3D</a></td></tr><tr><td><strong>Group Moderator Bot</strong></td><td>Automatically enforce group rules, summarize long discussions, and manage membership requests.</td><td><a href="https://codewords.agemo.ai/chat?sendAutomatically=true&#x26;initialMessage=SSB3YW50IHRvIGJ1aWxkIGEgV2hhdHNBcHAgZ3JvdXAgbW9kZXJhdG9yIGJvdCB0aGF0IGVuZm9yY2VzIHJ1bGVzLCBzdW1tYXJpemVzIGRpc2N1c3Npb25zLCBhbmQgbWFuYWdlcyBtZW1iZXJzaGlwLiBIZWxwIG1lIGN1c3RvbWl6ZSBpdC4%3D">https://codewords.agemo.ai/chat?sendAutomatically=true&#x26;initialMessage=SSB3YW50IHRvIGJ1aWxkIGEgV2hhdHNBcHAgZ3JvdXAgbW9kZXJhdG9yIGJvdCB0aGF0IGVuZm9yY2VzIHJ1bGVzLCBzdW1tYXJpemVzIGRpc2N1c3Npb25zLCBhbmQgbWFuYWdlcyBtZW1iZXJzaGlwLiBIZWxwIG1lIGN1c3RvbWl6ZSBpdC4%3D</a></td></tr><tr><td><strong>Engagement Analyzer</strong></td><td>Track group participation, identify trending topics, and generate weekly engagement reports.</td><td><a href="https://codewords.agemo.ai/chat?sendAutomatically=true&#x26;initialMessage=SSB3YW50IHRvIGJ1aWxkIGEgV2hhdHNBcHAgZ3JvdXAgZW5nYWdlbWVudCBhbmFseXplciB0aGF0IHRyYWNrcyBwYXJ0aWNpcGF0aW9uLCBpZGVudGlmaWVzIHRyZW5kaW5nIHRvcGljcywgYW5kIGdlbmVyYXRlcyB3ZWVrbHkgcmVwb3J0cy4gSGVscCBtZSBzZXQgaXQgdXAu">https://codewords.agemo.ai/chat?sendAutomatically=true&#x26;initialMessage=SSB3YW50IHRvIGJ1aWxkIGEgV2hhdHNBcHAgZ3JvdXAgZW5nYWdlbWVudCBhbmFseXplciB0aGF0IHRyYWNrcyBwYXJ0aWNpcGF0aW9uLCBpZGVudGlmaWVzIHRyZW5kaW5nIHRvcGljcywgYW5kIGdlbmVyYXRlcyB3ZWVrbHkgcmVwb3J0cy4gSGVscCBtZSBzZXQgaXQgdXAu</a></td></tr><tr><td><strong>Group Expense Tracker</strong></td><td>Split bills, track who owes what, and send automated payment reminders to group members.</td><td><a href="https://codewords.agemo.ai/chat?sendAutomatically=true&#x26;initialMessage=SSB3YW50IHRvIGJ1aWxkIGEgV2hhdHNBcHAgZ3JvdXAgZXhwZW5zZSB0cmFja2VyIGZvciBzcGxpdHRpbmcgYmlsbHMsIHRyYWNraW5nIHdobyBvd2VzIHdoYXQsIGFuZCBzZW5kaW5nIHBheW1lbnQgcmVtaW5kZXJzLiBIZWxwIG1lIGN1c3RvbWl6ZSBpdC4%3D">https://codewords.agemo.ai/chat?sendAutomatically=true&#x26;initialMessage=SSB3YW50IHRvIGJ1aWxkIGEgV2hhdHNBcHAgZ3JvdXAgZXhwZW5zZSB0cmFja2VyIGZvciBzcGxpdHRpbmcgYmlsbHMsIHRyYWNraW5nIHdobyBvd2VzIHdoYXQsIGFuZCBzZW5kaW5nIHBheW1lbnQgcmVtaW5kZXJzLiBIZWxwIG1lIGN1c3RvbWl6ZSBpdC4%3D</a></td></tr></tbody></table>


---

# Agent Instructions: 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:

```
GET https://docs.codewords.ai/more-features/whatsapp-automations/for-whatsapp-groups.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
