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

# Message Tools

> Send text and template messages, and view message statistics with the Zeplo MCP Server.

# Message Tools

Tools for sending messages and viewing message statistics.

## message\_get

Get a single message by ID.

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `id` | string | Yes | Message ID |

***

## message\_send\_text

Record a text message sent to a conversation.

**Parameters:**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `conversationId` | string | Yes | — | Conversation ID |
| `content` | string | Yes | — | Message text content |
| `senderType` | enum | No | `"agent"` | Who is sending: `agent`, `user`, `system` |
| `dryRun` | boolean | No | `false` | Validate without writing |

**Example:**

```json theme={null}
{
  "conversationId": "conv_abc123",
  "content": "Your order #12345 has been shipped!",
  "senderType": "agent"
}
```

> [!NOTE]
>
> This records the message in the database and updates the conversation's last message. It does not directly invoke the WhatsApp API to deliver the message.

***

## message\_send\_template

Record a template message sent to a conversation.

**Parameters:**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `conversationId` | string | Yes | — | Conversation ID |
| `templateName` | string | Yes | — | WhatsApp template name |
| `templateLanguage` | string | No | `"en_US"` | Template language |
| `templateParams` | object | No | — | Template parameter key-value pairs |
| `dryRun` | boolean | No | `false` | Validate without writing |

**Example:**

```json theme={null}
{
  "conversationId": "conv_abc123",
  "templateName": "order_confirmation",
  "templateLanguage": "en_US",
  "templateParams": {
    "order_id": "12345",
    "delivery_date": "May 10, 2026"
  }
}
```

***

## message\_stats

Get message statistics for a time range.

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `channelId` | string | No | Filter by channel |
| `startDate` | string | No | Start date (ISO format) |
| `endDate` | string | No | End date (ISO format) |

**Response:**

```json theme={null}
{
  "period": {
    "start": "2026-05-01",
    "end": "2026-05-08"
  },
  "breakdown": [
    { "direction": "inbound", "status": "delivered", "count": 1200 },
    { "direction": "outbound", "status": "delivered", "count": 3400 },
    { "direction": "outbound", "status": "failed", "count": 45 }
  ],
  "total": 4645
}
```


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