Add ForwardMessages method

Author: olegius88

README.md

@@ -159,6 +159,7 @@ This method will be called when an incoming message is received. Next, process m
 | `sending.sendLocation`                 | The method is aimed for sending a location message                                                                                                                                                  | [SendLocation.md](https://github.com/green-api/docs/blob/master/ru/docs/api/sending/SendLocation.md)                                     |
 | `sending.sendMessage`                  | The method is aimed for sending a text message to a personal or a group chat                                                                                                                        | [SendMessage.md](https://github.com/green-api/docs/blob/master/ru/docs/api/sending/SendMessage.md)                                       |
 | `sending.sendTemplateButtons`          | The method is aimed for sending a message with template list interactive buttons to a personal or a group chat                                                                                      | [SendTemplateButtons.md](https://github.com/green-api/docs/blob/master/ru/docs/api/sending/SendTemplateButtons.md)                       |
+| `sending.forwardMessages`              | The method is intended for forwarding messages to a personal or group chat                                                                                                                          | [ForwardMessages.md](https://github.com/green-api/docs/blob/master/ru/docs/api/sending/ForwardMessages.md)                               |
 | `serviceMethods.checkWhatsapp`         | The method checks WhatsApp account availability on a phone number                                                                                                                                   | [CheckWhatsapp.md](https://github.com/green-api/docs/blob/master/ru/docs/api/service/CheckWhatsapp.md)                                   |
 | `serviceMethods.getAvatar`             | The method returns a user or a group chat avatar                                                                                                                                                    | [GetAvatar.md](https://github.com/green-api/docs/blob/master/ru/docs/api/service/GetAvatar.md)                                           |
 | `serviceMethods.getContactInfo`        | The method is aimed for getting information on a contact                                                                                                                                            | [GetContactInfo.md](https://github.com/green-api/docs/blob/master/ru/docs/api/service/GetContactInfo.md)                                 |

README_RUS.md

@@ -157,6 +157,7 @@ body | тело сообщения (json)
 | `sending.sendLocation`                 | Метод предназначен для отправки сообщения геолокации                                                                                                                                            | [SendLocation.md](https://github.com/green-api/docs/blob/master/ru/docs/api/sending/SendLocation.md)                                     |
 | `sending.sendMessage`                  | Метод предназначен для отправки текстового сообщения в личный или групповой чат                                                                                                                 | [SendMessage.md](https://github.com/green-api/docs/blob/master/ru/docs/api/sending/SendMessage.md)                                       |
 | `sending.sendTemplateButtons`          | Метод предназначен для отправки сообщения с интерактивными кнопками из перечня шаблонов в личный или групповой чат                                                                              | [SendTemplateButtons.md](https://github.com/green-api/docs/blob/master/ru/docs/api/sending/SendTemplateButtons.md)                       |
+| `sending.forwardMessages`              | Метод предназначен для пересылки сообщений в личный или групповой чат                                                                                                                           | [ForwardMessages.md](https://github.com/green-api/docs/blob/master/ru/docs/api/sending/ForwardMessages.md)                               |
 | `serviceMethods.checkWhatsapp`         | Метод проверяет наличие аккаунта WhatsApp на номере телефона                                                                                                                                    | [CheckWhatsapp.md](https://github.com/green-api/docs/blob/master/ru/docs/api/service/CheckWhatsapp.md)                                   |
 | `serviceMethods.getAvatar`             | Метод возвращает аватар корреспондента или группового чата                                                                                                                                      | [GetAvatar.md](https://github.com/green-api/docs/blob/master/ru/docs/api/service/GetAvatar.md)                                           |
 | `serviceMethods.getContactInfo`        | Метод предназначен для получения информации о контакте                                                                                                                                          | [GetContactInfo.md](https://github.com/green-api/docs/blob/master/ru/docs/api/service/GetContactInfo.md)                                 |

src/tools/Sending.php

@@ -373,4 +373,29 @@ public function sendTemplateButtons(
 		return $this->greenApi->request( 'POST',
 			'{{host}}/waInstance{{idInstance}}/SendTemplateButtons/{{apiTokenInstance}}', $requestBody );
 	}
+
+	/**
+	 * The method is intended for forwarding messages to a personal or group chat. The forwarded messages will be added
+	 * to the send queue. Checking whatsapp authorization on the phone (i.e. availability in linked devices) is not performed.
+	 * The message will be kept for 24 hours in the queue and will be sent immediately after phone authorization.
+	 * The rate at which messages are sent from the queue is managed by Message sending delay parameter.
+	 *
+	 * @param string $chatId
+	 * @param string $chatIdFrom
+	 * @param array $messages
+	 *
+	 * @return stdClass
+	 * @link https://green-api.com/en/docs/api/sending/ForwardMessages/
+	 */
+	public function forwardMessages( string $chatId, string $chatIdFrom, array $messages ): stdClass {
+
+		$requestBody = [
+			'chatId' => $chatId,
+			'chatIdFrom' => $chatIdFrom,
+			'messages' => $messages
+		];
+
+		return $this->greenApi->request( 'POST',
+			'{{host}}/waInstance{{idInstance}}/ForwardMessages/{{apiTokenInstance}}', $requestBody );
+	}
 }