Forward Message - Wappfy API

cURL

curl --request POST \
  --url https://{host}/api/forwardMessage \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "chatId": "5511999999999@c.us",
  "messageId": "false_11111111111@c.us_AAAAAAAAAAAAAAAAAAAA",
  "session": "my-session"
}
'

import requests

url = "https://{host}/api/forwardMessage"

payload = {
    "chatId": "5511999999999@c.us",
    "messageId": "false_11111111111@c.us_AAAAAAAAAAAAAAAAAAAA",
    "session": "my-session"
}
headers = {
    "apikey": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {apikey: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    chatId: '5511999999999@c.us',
    messageId: 'false_11111111111@c.us_AAAAAAAAAAAAAAAAAAAA',
    session: 'my-session'
  })
};

fetch('https://{host}/api/forwardMessage', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{host}/api/forwardMessage",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'chatId' => '5511999999999@c.us',
    'messageId' => 'false_11111111111@c.us_AAAAAAAAAAAAAAAAAAAA',
    'session' => 'my-session'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "apikey: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{host}/api/forwardMessage"

	payload := strings.NewReader("{\n  \"chatId\": \"5511999999999@c.us\",\n  \"messageId\": \"false_11111111111@c.us_AAAAAAAAAAAAAAAAAAAA\",\n  \"session\": \"my-session\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("apikey", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{host}/api/forwardMessage")
  .header("apikey", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"chatId\": \"5511999999999@c.us\",\n  \"messageId\": \"false_11111111111@c.us_AAAAAAAAAAAAAAAAAAAA\",\n  \"session\": \"my-session\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{host}/api/forwardMessage")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["apikey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"chatId\": \"5511999999999@c.us\",\n  \"messageId\": \"false_11111111111@c.us_AAAAAAAAAAAAAAAAAAAA\",\n  \"session\": \"my-session\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "messageId": "3EB0XXXXXX"
}

POST

api

forwardMessage

cURL

curl --request POST \
  --url https://{host}/api/forwardMessage \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "chatId": "5511999999999@c.us",
  "messageId": "false_11111111111@c.us_AAAAAAAAAAAAAAAAAAAA",
  "session": "my-session"
}
'

import requests

url = "https://{host}/api/forwardMessage"

payload = {
    "chatId": "5511999999999@c.us",
    "messageId": "false_11111111111@c.us_AAAAAAAAAAAAAAAAAAAA",
    "session": "my-session"
}
headers = {
    "apikey": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {apikey: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    chatId: '5511999999999@c.us',
    messageId: 'false_11111111111@c.us_AAAAAAAAAAAAAAAAAAAA',
    session: 'my-session'
  })
};

fetch('https://{host}/api/forwardMessage', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{host}/api/forwardMessage",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'chatId' => '5511999999999@c.us',
    'messageId' => 'false_11111111111@c.us_AAAAAAAAAAAAAAAAAAAA',
    'session' => 'my-session'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "apikey: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{host}/api/forwardMessage"

	payload := strings.NewReader("{\n  \"chatId\": \"5511999999999@c.us\",\n  \"messageId\": \"false_11111111111@c.us_AAAAAAAAAAAAAAAAAAAA\",\n  \"session\": \"my-session\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("apikey", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{host}/api/forwardMessage")
  .header("apikey", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"chatId\": \"5511999999999@c.us\",\n  \"messageId\": \"false_11111111111@c.us_AAAAAAAAAAAAAAAAAAAA\",\n  \"session\": \"my-session\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{host}/api/forwardMessage")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["apikey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"chatId\": \"5511999999999@c.us\",\n  \"messageId\": \"false_11111111111@c.us_AAAAAAAAAAAAAAAAAAAA\",\n  \"session\": \"my-session\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "messageId": "3EB0XXXXXX"
}

Description

⚠️ This endpoint is not yet implemented. This endpoint will allow forwarding existing messages to other contacts or groups on WhatsApp, maintaining the original format and content of the message.

Body

{
  "sessionId": "my-session",
  "jid": "5511999999999@s.whatsapp.net",
  "messageId": "3EB0XXXXXX",
  "fromJid": "5511999999999@s.whatsapp.net"
}

Body Parameters

Property	Type	Required	Description
`sessionId`	`string`	✅ Yes	Authenticated session ID that will forward the message
`jid`	`string`	✅ Yes	Recipient identifier (WhatsApp JID). Format: `5511999999999@s.whatsapp.net` for contacts or `120363XXXXX@g.us` for groups
`messageId`	`string`	✅ Yes	Message ID to be forwarded
`fromJid`	`string`	✅ Yes	Source chat JID of the message

{
  "success": true,
  "messageId": "3EB0XXXXXX"
}

Status Codes

200 - Message forwarded successfully
400 - Invalid parameters
401 - Unauthorized session
404 - Session not found
501 - Not implemented

Usage Example

curl -X POST https://api.wappfy.com.br/api/forwardMessage \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "my-session",
    "jid": "5511999999999@s.whatsapp.net",
    "messageId": "3EB0XXXXXX",
    "fromJid": "5511888888888@s.whatsapp.net"
  }'

const response = await fetch('https://api.wappfy.com.br/api/forwardMessage', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    sessionId: 'my-session',
    jid: '5511999999999@s.whatsapp.net',
    messageId: '3EB0XXXXXX',
    fromJid: '5511888888888@s.whatsapp.net'
  })
});
const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.wappfy.com.br/api/forwardMessage',
    json={
        'sessionId': 'my-session',
        'jid': '5511999999999@s.whatsapp.net',
        'messageId': '3EB0XXXXXX',
        'fromJid': '5511888888888@s.whatsapp.net'
    }
)
data = response.json()
print(data)

Authorizations

apikey

string

header

required

Your Wappfy API key (get it at dash.wappfy.com.br)

Body

application/json

chatId

string

required

Example:

"5511999999999@c.us"

messageId

string

required

Example:

"false_11111111111@c.us_AAAAAAAAAAAAAAAAAAAA"

session

string

required

Session name (instanceName)

Example:

"my-session"

Response

201 - application/json

string

required

Message ID

Example:

"false_11111111111@c.us_AAAAAAAAAAAAAAAAAAAA"

timestamp

number

required

Unix timestamp of when the message was created

Example:

1666943582

from

string

required

Chat ID to which this message was sent

Example:

"5511999999999@c.us"

fromMe

boolean

required

Indicates if the message was sent by the current user

source

enum<string>

required

The device that sent the message - either API or APP. Available in events (webhooks/websockets) only and only "fromMe: true" messages.

Available options:

api,

app

Example:

"api"

string

required

ID for who this message is for.
If the message is sent by the current user, it will be the Chat to which the message is being sent.
If the message is sent by another user, it will be the ID for the current user.

Example:

"5511999999999@c.us"

participant

string

required

For groups - participant who sent the message

body

string

required

Message content

hasMedia

boolean

required

Indicates if the message has media available for download

ack

enum<number>

required

Message acknowledgement (ACK) status

Available options:

-1,

0,

1,

2,

3,

4

ackName

string

required

Message acknowledgement status name

media

object

Message media object, if any and downloaded

Show child attributes

author

string

If the message was sent to a group, this field will contain the user who sent the message

location

object

Location information contained in the message

Show child attributes

vCards

string[]

List of vCards contained in the message

_data

object

Message in raw WhatsApp format. May change at any time, use with caution!

replyTo

object

Show child attributes

Custom Link Preview Add Reaction

​Description

​Body

​Body Parameters

​Status Codes

​Usage Example

Authorizations

Body

Response

Description

Body

Body Parameters

Status Codes

Usage Example