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:

{
  "conversationId": "conv_abc123",
  "content": "Your order #12345 has been shipped!",
  "senderType": "agent"
}

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:

{
  "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:

{
  "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
}

Getting Started

Tools Reference

Resources

Message Tools

Message Tools

message_get

message_send_text

message_send_template

message_stats

​Message Tools

​message_get

​message_send_text

​message_send_template

​message_stats

Message Tools

message_get

message_send_text

message_send_template

message_stats