---
sidebar_position: 8
---

# Forward message
 Forwards an existing message to the current dialog box



`Function ForwardMessage(Val Token, Val MessageID, Val FromChatID, Val ChatID, Val Text = "") Export`

  | Parameter | CLI option | Type | Description |
  |-|-|-|-|
  | Token | --token | String | Bot token |
  | MessageID | --message | String, Number | Original message ID |
  | FromChatID | --fromid | String, Number | Source chat ID |
  | ChatID | --chatid | String, Number | Chat ID for message sending |
  | Text | --text | String | Additional message text |

  
  Returns:  HTTPResponse - Forward message

<br/>

:::tip
Only the chatId from events can be passed to the FromChatID (the code from the chat link is not suitable))

 Method at API documentation: [GET /messages/sendText](https://teams.vk.com/botapi/#/messages/get_messages_sendText)
:::
<br/>


```bsl title="Code example"
  Token      = FunctionParameters["VkTeams_Token"];
  ChatID     = FunctionParameters["VkTeams_ChatID"];
  FromChatID = FunctionParameters["VkTeams_ChatID2"];
  MessageID  = FunctionParameters["VkTeams_MessageID"];
  
  Result = OPI_VKTeams.ForwardMessage(Token, MessageID, FromChatID, ChatID);
  
  OPI_TestDataRetrieval.WriteLog(Result, "ForwardMessage (simple)", "VkTeams");
  
  Text = "Additional text";
  
  Result = OPI_VKTeams.ForwardMessage(Token, MessageID, FromChatID, ChatID, Text);
```



```sh title="CLI command example"
    
  oint vkteams ForwardMessage --token "001.3501506236.091..." --message "7402287649739767956" --fromid "689203963@chat.agent" --chatid "AoLI0egLWBSLR1Ngn2w" --text "Additional text"

```

```json title="Result"

```