# For WhatsApp DMs

### What are WhatsApp automations for DMs

WhatsApp direct message (DM) automations let you run CodeWords workflows and AI agents in 1:1 chats through a shared CodeWords bot number.

### Shared CodeWords DM bot number

**+447424366129** — the shared CodeWords bot number for WhatsApp DM workflows and AI agents.

* Used for 1:1 workflow automations, notifications, and AI assistants built in CodeWords
* Messages to and from your DM automation flow through this shared bot number
* Not a support or contact number for reaching the CodeWords team

### Setting up your first DM automation

{% stepper %}
{% step %}
**Build the automation through chat**

Describe the kind of WhatsApp automation you want to create, along with its trigger.

Example: "Create a WhatsApp assistant connected to an LLM that responds to every message I send. Also connect it to my Google Calendar so it can view, edit, list, and create events."
{% endstep %}

{% step %}
**Provide your phone number**

Cody asks which phone number you want to register for the DM workflow. This tells CodeWords which 1:1 conversations should route into your automation. Once connected and built, your assistant sends a welcome message from the shared DM bot number.
{% endstep %}

{% step %}
**Test your automation**

Send any message to the shared DM bot number. The assistant detects it and responds through your custom WhatsApp DM workflow.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Note**: You can create multiple direct messaging automations that send messages, but only one trigger-based two-way assistant can be active at a time.
{% endhint %}

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.

### What can you build with the WhatsApp automations for direct messaging?

#### Type 1: One-way notifications (Simple)

Perfect for broadcast-style updates without needing user replies.

| Use Case              | What It Does                                     | Example                                             |
| --------------------- | ------------------------------------------------ | --------------------------------------------------- |
| Appointment Reminders | Send scheduled reminders                         | “Reminder: Dental appointment tomorrow at 3 PM”     |
| Shipping Updates      | Track package status from your emails            | “Your package is out for delivery.”                 |
| Payment Alerts        | Confirm transactions from emails or payment apps | “Payment received: $99.00. Thank you!”              |
| Daily Digests         | Regular summaries                                | “Your daily news: 3 new articles, 2 tasks due”      |
| Service Alerts        | System notifications                             | “Your subscription renews in 3 days—update payment” |

#### Type 2: Two-way assistant (Interactive)

Build intelligent conversations where **users** ask questions and get instant help.

| Use Case          | Example Conversation                                                                                                          |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| FAQ Assistant     | <p>User: “What does our documentation say about opening times?”</p><p>Assistant: “Mon–Fri 9–6, Sat 10–4!”</p>                 |
| Meeting Assistant | <p>User: “Create a meeting with <johndoe@gmail.com> for Dec 10 at 2:00 PM”</p><p>Assistant: “Meeting created for Dec 10.”</p> |

### Supported message types

| Type     | When You Can Send                   | Use For                                   |
| -------- | ----------------------------------- | ----------------------------------------- |
| Template | Anytime                             | All notifications, first contact          |
| Text     | Within 24 hours of a **user** reply | Assistant conversations                   |
| Image    | Within 24 hours of a **user** reply | Screenshots, receipts, and product photos |

### Pricing

| Automation actions                  | Cost                                                           |
| ----------------------------------- | -------------------------------------------------------------- |
| Receiving messages                  | Free                                                           |
| Sending messages(All Message types) | €0.002 per message (≈ 0.2¢) + Cost of executing the Automation |

### WhatsApp automations for direct messaging vs groups

| Feature         | Direct Messaging (this guide)                                              | Group                                 |
| --------------- | -------------------------------------------------------------------------- | ------------------------------------- |
| Who you message | Individual **users** (1:1)                                                 | WhatsApp groups                       |
| Best for        | Notifications, support, sales flows                                        | Team/community coordination           |
| Service window  | The 24-hour rule applies for & No service window for one-way notifications | No window limits                      |
| Setup           | Simple (\~5 min)                                                           | Medium (two-phase link)               |
| Message types   | Templates, Text, Images                                                    | Text, media, polls, events            |
| Event types     | Messages                                                                   | Messages, reactions, updates, changes |

You can use both! Many teams use **Direct Messaging** for user specific needs and **Group** for internal groups.

### FAQs

<details>

<summary>Can I have multiple WhatsApp automations?</summary>

Yes, you can create multiple WhatsApp automations that send messages.\
However, only one trigger-based two-way assistant (that can both send and receive messages) can be active at a time.

</details>

<details>

<summary>How do I manage or delete a WhatsApp trigger?</summary>

You can manage all triggers from the Triggers page to pause, edit, or delete them anytime.\
Alternatively, simply ask Cody:

“Delete my WhatsApp trigger.”\
Cody will remove it automatically.

</details>

<details>

<summary>How is this different from WhatsApp Group Automations?</summary>

* **Direct Messaging Automations** handle personal, one-on-one interactions.
* **Group Automations** manage team or community conversations inside group chats.\
  Many teams use both — direct messages for private tasks and groups for internal workflows.

***

</details>

<details>

<summary>Is my WhatsApp data secure?</summary>

Yes. DM automations run through a verified shared CodeWords WhatsApp Business account, and messages are encrypted through WhatsApp’s secure infrastructure. Your number and connected data remain private and under your control.

</details>

### Getting help

If your Assistant isn’t responding:

1. Ask Cody to verify if the setup is correct
2. Check in-app support or use live chat at [codewords.ai](https://codewords.agemo.ai/)

## Popular DM Bot Templates

Get started with a pre-built WhatsApp DM automation 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>Personal AI Assistant</strong></td><td>Your own Jarvis on WhatsApp — manages calendar, email, tasks, and answers questions in your style.</td><td><a href="https://codewords.agemo.ai/chat?sendAutomatically=true&#x26;initialMessage=SSB3YW50IHRvIGJ1aWxkIGEgcGVyc29uYWwgV2hhdHNBcHAgQUkgYXNzaXN0YW50IGZvciBETXMgdGhhdCBtYW5hZ2VzIG15IGNhbGVuZGFyLCB0YXNrcywgYW5kIHJlbWluZGVycy4gSGVscCBtZSBnZXQgc3RhcnRlZC4%3D">https://codewords.agemo.ai/chat?sendAutomatically=true&#x26;initialMessage=SSB3YW50IHRvIGJ1aWxkIGEgcGVyc29uYWwgV2hhdHNBcHAgQUkgYXNzaXN0YW50IGZvciBETXMgdGhhdCBtYW5hZ2VzIG15IGNhbGVuZGFyLCB0YXNrcywgYW5kIHJlbWluZGVycy4gSGVscCBtZSBnZXQgc3RhcnRlZC4%3D</a></td></tr><tr><td><strong>Voice Note Transcriber</strong></td><td>Automatically transcribe and summarize every voice note you receive — never replay a 5-minute audio again.</td><td><a href="https://codewords.agemo.ai/chat?sendAutomatically=true&#x26;initialMessage=SSB3YW50IHRvIGJ1aWxkIGEgV2hhdHNBcHAgdm9pY2Ugbm90ZSB0cmFuc2NyaWJlciBmb3IgbXkgRE1zIHRoYXQgdHJhbnNjcmliZXMgYW5kIHN1bW1hcml6ZXMgZXZlcnkgdm9pY2UgbWVzc2FnZSBJIHJlY2VpdmUuIEhlbHAgbWUgc2V0IGl0IHVwLg%3D%3D">https://codewords.agemo.ai/chat?sendAutomatically=true&#x26;initialMessage=SSB3YW50IHRvIGJ1aWxkIGEgV2hhdHNBcHAgdm9pY2Ugbm90ZSB0cmFuc2NyaWJlciBmb3IgbXkgRE1zIHRoYXQgdHJhbnNjcmliZXMgYW5kIHN1bW1hcml6ZXMgZXZlcnkgdm9pY2UgbWVzc2FnZSBJIHJlY2VpdmUuIEhlbHAgbWUgc2V0IGl0IHVwLg%3D%3D</a></td></tr><tr><td><strong>Budget Tracker</strong></td><td>Text your expenses throughout the day and get spending breakdowns, category reports, and budget alerts.</td><td><a href="https://codewords.agemo.ai/chat?sendAutomatically=true&#x26;initialMessage=SSB3YW50IHRvIGJ1aWxkIGEgV2hhdHNBcHAgYnVkZ2V0IHRyYWNrZXIgZm9yIERNcyB3aGVyZSBJIGNhbiB0ZXh0IG15IGV4cGVuc2VzIGFuZCBnZXQgc3BlbmRpbmcgcmVwb3J0cy4gSGVscCBtZSBjdXN0b21pemUgaXQu">https://codewords.agemo.ai/chat?sendAutomatically=true&#x26;initialMessage=SSB3YW50IHRvIGJ1aWxkIGEgV2hhdHNBcHAgYnVkZ2V0IHRyYWNrZXIgZm9yIERNcyB3aGVyZSBJIGNhbiB0ZXh0IG15IGV4cGVuc2VzIGFuZCBnZXQgc3BlbmRpbmcgcmVwb3J0cy4gSGVscCBtZSBjdXN0b21pemUgaXQu</a></td></tr><tr><td><strong>Lead Qualifier</strong></td><td>Engage new contacts via WhatsApp DM, qualify them through natural conversation, and sync results to your CRM.</td><td><a href="https://codewords.agemo.ai/chat?sendAutomatically=true&#x26;initialMessage=SSB3YW50IHRvIGJ1aWxkIGEgV2hhdHNBcHAgbGVhZCBxdWFsaWZpZXIgZm9yIERNcyB0aGF0IGVuZ2FnZXMgbmV3IGNvbnRhY3RzLCBxdWFsaWZpZXMgdGhlbSwgYW5kIHN5bmNzIHRvIG15IENSTS4gSGVscCBtZSBzZXQgaXQgdXAu">https://codewords.agemo.ai/chat?sendAutomatically=true&#x26;initialMessage=SSB3YW50IHRvIGJ1aWxkIGEgV2hhdHNBcHAgbGVhZCBxdWFsaWZpZXIgZm9yIERNcyB0aGF0IGVuZ2FnZXMgbmV3IGNvbnRhY3RzLCBxdWFsaWZpZXMgdGhlbSwgYW5kIHN5bmNzIHRvIG15IENSTS4gSGVscCBtZSBzZXQgaXQgdXAu</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/automations/whatsapp/whatsapp-automations/for-whatsapp-dms.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.
