waha_delete_message
Remove a specific message from a WhatsApp chat using the WAHA MCP Server. This destructive operation permanently deletes the selected message.
Instructions
Delete a specific message from a chat. This is a destructive operation and cannot be undone.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chatId | Yes | Chat ID (format: number@c.us) | |
| messageId | Yes | Message ID to delete (format: {fromMe}_{chat}_{message_id}[_{participant}]) |
Implementation Reference
- src/index.ts:165-183 (registration)Tool registration including schema and description in ListToolsRequestSchema handler
}, { name: "waha_delete_message", description: "Delete a specific message from a chat. This is a destructive operation and cannot be undone.", inputSchema: { type: "object", properties: { chatId: { type: "string", description: "Chat ID (format: number@c.us)", }, messageId: { type: "string", description: "Message ID to delete (format: {fromMe}_{chat}_{message_id}[_{participant}])", }, }, required: ["chatId", "messageId"], }, }, - src/index.ts:1340-1362 (handler)Main MCP tool handler that validates parameters, calls WAHAClient.deleteMessage, and returns formatted success response
private async handleDeleteMessage(args: any) { const chatId = args.chatId; const messageId = args.messageId; if (!chatId) { throw new Error("chatId is required"); } if (!messageId) { throw new Error("messageId is required"); } await this.wahaClient.deleteMessage(chatId, messageId); return { content: [ { type: "text", text: `Successfully deleted message ${messageId} from chat ${chatId}.`, }, ], }; } - src/index.ts:169-182 (schema)Input schema definition for the tool, specifying required chatId and messageId parameters
inputSchema: { type: "object", properties: { chatId: { type: "string", description: "Chat ID (format: number@c.us)", }, messageId: { type: "string", description: "Message ID to delete (format: {fromMe}_{chat}_{message_id}[_{participant}])", }, }, required: ["chatId", "messageId"], }, - src/client/waha-client.ts:298-314 (helper)WAHAClient helper method that performs the actual HTTP DELETE request to the WAHA API endpoint for deleting a message
async deleteMessage(chatId: string, messageId: string): Promise<void> { if (!chatId) { throw new WAHAError("chatId is required"); } if (!messageId) { throw new WAHAError("messageId is required"); } const endpoint = `/api/${this.session}/chats/${encodeURIComponent( chatId )}/messages/${encodeURIComponent(messageId)}`; await this.request<void>(endpoint, { method: "DELETE", }); }