> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeplo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Messages

> Send text and template messages via WhatsApp from the command line

Message commands let you send free-form text messages and pre-approved template messages to any phone number. These commands are useful for testing, triggering notifications from scripts, or sending one-off messages without opening a full conversation view.

## zeplo messages send

Send a text message to a phone number. The number must include the country code without any plus signs or dashes.

```bash theme={null}
zeplo messages send <phone> <text> [--media <url>]
```

### Arguments

| Argument | Description |
| - | - |
| `<phone>` | Recipient phone number with country code (e.g., `15551234567`) |
| `<text>` | The message body text |

### Options

| Flag | Description |
| - | - |
| `--media <url>` | Attach media to the message. Supports image, video, and document URLs |

### Examples

```bash theme={null}
# Send a simple text message
zeplo messages send 15551234567 "Hello, this is a test message"

# Send a message with an image attachment
zeplo messages send 15551234567 "Here is your invoice" --media https://example.com/invoice.pdf

# Send a message from a script with a variable phone number
PHONE=15551234567
zeplo messages send "$PHONE" "Your order #1234 has shipped"
```

## zeplo messages send-template

Send a pre-approved WhatsApp template message to a phone number. The template must have `APPROVED` status before it can be sent.

```bash theme={null}
zeplo messages send-template <phone> <name> [--params <json>]
```

### Arguments

| Argument | Description |
| - | - |
| `<phone>` | Recipient phone number with country code (e.g., `15551234567`) |
| `<name>` | The exact name of the approved template |

### Options

| Flag | Description |
| - | - |
| `--params <json>` | Template parameters as a JSON string. Positional placeholders `{{1}}`, `{{2}}`, etc. are filled from the array order |

### Examples

```bash theme={null}
# Send a template without parameters
zeplo messages send-template 15551234567 welcome_message

# Send a template with a single parameter
zeplo messages send-template 15551234567 order_confirmation --params '["Order #1234"]'

# Send a template with multiple parameters
zeplo messages send-template 15551234567 shipping_update \
  --params '["Order #5678", "FedEx", "2026-05-07"]'

# Use in a shell script for automated notifications
CUSTOMER_PHONE=15551234567
zeplo messages send-template "$CUSTOMER_PHONE" appointment_reminder \
  --params '["Dr. Smith", "May 10 at 2:00 PM"]'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.