Encaminhar Mensagem - 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"
}

Descrição

⚠️ Este endpoint ainda não está implementado. Este endpoint permitirá encaminhar mensagens existentes para outros contatos ou grupos no WhatsApp, mantendo o formato e conteúdo original da mensagem.

Body

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

Parâmetros do Body

Propriedade	Tipo	Obrigatório	Descrição
`sessionId`	`string`	✅ Sim	ID da sessão autenticada que encaminhará a mensagem
`jid`	`string`	✅ Sim	Identificador do destinatário (JID do WhatsApp). Formato: `5511999999999@s.whatsapp.net` para contatos ou `120363XXXXX@g.us` para grupos
`messageId`	`string`	✅ Sim	ID da mensagem a ser encaminhada
`fromJid`	`string`	✅ Sim	JID do chat de origem da mensagem

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

Códigos de Status

200 - Mensagem encaminhada com sucesso
400 - Parâmetros inválidos
401 - Sessão não autorizada
404 - Sessão não encontrada
501 - Não implementado

Exemplo de Uso

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

Sua chave de API do Wappfy (obtenha em 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

Nome da sessão (instanceName)

Example:

"my-session"

Response

201 - application/json

string

required

ID da mensagem

Example:

"false_11111111111@c.us_AAAAAAAAAAAAAAAAAAAA"

timestamp

number

required

Timestamp Unix de quando a mensagem foi criada

Example:

1666943582

from

string

required

ID do chat para o qual esta mensagem foi enviada

Example:

"5511999999999@c.us"

fromMe

boolean

required

Indica se a mensagem foi enviada pelo usuário atual

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

Para grupos - participante que enviou a mensagem

body

string

required

Conteúdo da mensagem

hasMedia

boolean

required

Indica se a mensagem possui mídia disponível para download

ack

enum<number>

required

Status de confirmação (ACK) da mensagem

Available options:

-1,

0,

1,

2,

3,

4

ackName

string

required

Nome do status de confirmação da mensagem

media

object

Objeto de mídia da mensagem, se houver e foi baixada

Show child attributes

author

string

Se a mensagem foi enviada para um grupo, este campo conterá o usuário que enviou a mensagem

location

object

Informações de localização contidas na mensagem

Show child attributes

vCards

string[]

Lista de vCards contidos na mensagem

_data

object

Mensagem em formato bruto do WhatsApp. Pode mudar a qualquer momento, use com cautela!

replyTo

object

Show child attributes

Link Preview Customizado Adicionar Reação

​Descrição

​Body

​Parâmetros do Body

​Códigos de Status

​Exemplo de Uso

Authorizations

Body

Response

Descrição

Body

Parâmetros do Body

Códigos de Status

Exemplo de Uso