Skip to main content
Glama

manage_whatsapp_message_interactions

Manage WhatsApp message interactions including replies, forwards, reactions, and poll voting. Handle all message interaction operations with action-based approach for comprehensive message engagement functionality.

Input Schema

NameRequiredDescriptionDefault
chatYesWhatsApp chat ID (e.g., 1234567890@c.us for phone numbers, 123456789000000000@g.us for groups, 123456789000000@newsletter for WhatsApp channels)
voteNoVote details (required for vote action)
agentNoAgent ID (24 character hex string)
quoteNoMessage ID to reply to (required for reply action)
actionYesAction to perform for WhatsApp message interactions
deviceNoTarget WhatsApp device ID (24 character hex string) used for message delivery. Only required if you have multiple WhatsApp numbers connected. Use MCP tool "get_whatsapp_devices" to retrieve a list of available devices.
forwardNoForward message details (required for forward action)
messageNoReply message content (required for reply action)
reactionNoEmoji reaction to send, use "-" to remove reaction (required for reaction action)
selectIdNoID of selected button/list option when replying to interactive messages (for reply action)
referenceNoCustom reference ID for message tracking
reactionMessageNoMessage ID to react to (required for reaction action)

Schema Changelog

Changes observed during successful MCP inspections.

No schema history has been recorded yet.

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full disclosure burden and adds nothing behavioral: it does not say that reply/forward/reaction actually send outbound content, whether a reaction can be undone, what permissions are needed, or what is returned. The schema carries the only concrete behavioral hint ('-' removes a reaction), leaving the description redundant.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The first sentence is front-loaded and useful; the second sentence restates the same idea in abstractions ('action-based approach', 'comprehensive message engagement functionality') without adding information. Net result is short but roughly one third wasted.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 12 parameters, nested objects, and no annotations or output schema, the description is thin but the richly documented schema covers the action-to-parameter mapping, so an agent can construct a valid call. What remains missing is the behavioral framing (outbound effects, device selection implications) rather than the mechanics.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, and the schema itself flags which parameters belong to which action (e.g. 'required for reply action', 'required for forward action'). The description adds no mapping or format detail beyond the action names already listed in the enum, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb (manage) and resource (WhatsApp message interactions) and enumerates the four concrete operations matching the action enum: replies, forwards, reactions, poll voting. However, it does not distinguish this from close siblings like send_whatsapp_message or manage_whatsapp_channel_messages, so an agent must still infer the boundary.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to use this tool versus sending a new message via send_whatsapp_message, nor any exclusion for channel messages. The only usage-like statement, 'action-based approach for comprehensive message engagement functionality', is filler rather than a condition.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources