> 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-dms.md).

# For WhatsApp DMs

### What are WhatsApp DM Automations

WhatsApp Direct Messaging (DM) automations allows you to consume codewords workflows that have been connected to your WhatsApp number.&#x20;

### CodeWords WhatsApp Business Number

**+447424366129** — the official CodeWords WhatsApp Business account.

* All **user** messages come from this verified number
* Users can save it as a contact
* Available **24/7** for automation

### Setting Up Your First DM Automation

{% stepper %}
{% step %}

#### Build the Automation through chat

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

Example: "Create a WhatsApp assistant that’s connected to an LLM and automatically responds to any message that I send back. Also make sure that its connected to my google calendar, such that It has access to view, edit, list and create events on my calendar. "
{% endstep %}

{% step %}

#### Provide your phone number

Cody will ask which phone number you want your AI assistant to connect to. Once connected and the Assistant is built your Assistant will send you a welcome message.
{% endstep %}

{% step %}

#### Test your Automation

Send any message — the assistant will detect it and respond through your Custom WhatsApp DM Assistant.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Note**: While you can create multiple direct messaging automations that send messages, only **one trigger-**&#x62;ased 2-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 Direct Messaging Automations?

#### 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 pm” </p><p>Assistant: “Meeting created foe Dec 10”</p> |

### Supported Message Types

| Type     | When You Can Send            | Use For                               |
| -------- | ---------------------------- | ------------------------------------- |
| Template | Anytime                      | All notifications, first contact      |
| Text     | Within 24h of **user** reply | Assistant conversations               |
| Image    | Within 24h of **user** reply | Screenshots, receipts, 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 Direct Messaging vs WhatsApp Group Automations

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

### FAQ

<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. All interactions occur via the verified 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/)


---

# 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-dms.md?ask=<question>&goal=<endgoal>
```

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