Skip to content
All tools

whatsapp_forward_message

WhatsApp · macOS · Windows

Effect: send (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

macOS

Purpose

Forwards one WhatsApp message (text, document, image, video or voice note/audio) to another chat, marked as forwarded. chat_id and message_id come from whatsapp_read_messages; to_chat_id MUST come from whatsapp_list_chats — never fabricate IDs. This is a write operation: the first call (confirm=false) returns a preview without sending; set confirm=true to actually send.

Required inputs

Permissions and confirmation

Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.

Full input schema — macOS
{
  "properties": {
    "account": {
      "description": "Which linked WhatsApp account to use: its label or id from whatsapp_list_accounts. Leave it out to use the default account.",
      "type": "string"
    },
    "chat_id": {
      "description": "Chat ID the message is in, from whatsapp_read_messages",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually send. Without it, returns a preview.",
      "type": "boolean"
    },
    "message_id": {
      "description": "message_id of the message to forward, from whatsapp_read_messages",
      "type": "string"
    },
    "remember": {
      "description": "With confirm: true, also stop asking for this kind of action from now on. Only when the person said so (\"don't ask again\"). The person can revoke it in LMCP or with set_always_allowed.",
      "type": "boolean"
    },
    "to_chat_id": {
      "description": "Chat ID to forward it to, from whatsapp_list_chats",
      "type": "string"
    }
  },
  "required": [
    "chat_id",
    "message_id",
    "to_chat_id"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "chat_id": "12025550123@s.whatsapp.net",
  "confirm": false,
  "message_id": "3EB0DEMO0001",
  "to_chat_id": "12025550124@s.whatsapp.net"
}

Windows

Purpose

Forwards one WhatsApp message (text, document, image, video or voice note/audio) to another chat, marked as forwarded. chat_id and message_id come from whatsapp_read_messages; to_chat_id MUST come from whatsapp_list_chats — never fabricate IDs. This is a write operation: the first call (confirm=false) returns a preview without sending; set confirm=true to actually send.

Required inputs

Permissions and confirmation

Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.

Full input schema — Windows
{
  "properties": {
    "account": {
      "description": "Which linked WhatsApp account to use: its label or id from whatsapp_list_accounts. Leave it out to use the default account.",
      "type": "string"
    },
    "chat_id": {
      "description": "Chat ID the message is in, from whatsapp_read_messages",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually send. Without it, returns a preview.",
      "type": "boolean"
    },
    "message_id": {
      "description": "message_id of the message to forward, from whatsapp_read_messages",
      "type": "string"
    },
    "remember": {
      "description": "With confirm=true, and only after the person said so: do this kind of action without asking from now on («don't ask me again»). The preview names the family.",
      "type": "boolean"
    },
    "to_chat_id": {
      "description": "Chat ID to forward it to, from whatsapp_list_chats",
      "type": "string"
    }
  },
  "required": [
    "chat_id",
    "message_id",
    "to_chat_id"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "chat_id": "12025550123@s.whatsapp.net",
  "confirm": false,
  "message_id": "3EB0DEMO0001",
  "to_chat_id": "12025550124@s.whatsapp.net"
}