Skip to main content

Forward message

Method#

/forward-message#

POST https://api.z-api.io/instances/YOUR_INSTANCE/token/YOUR_TOKEN/forward-message

Header#

KeyValue
Client-TokenACCOUNT SECURITY TOKEN

Concept#

Simple and straightforward, in this method, you can forward messages through the API by providing the messageId of the message you want to forward and the phone number of the chat where this messageId is located.

Attention

To use this method it is necessary to configure the webhook, if it has not yet been configured, the message will not be forwarded.

image


Attributes#

Required#

AttributesTypeDescription
phonestringRecipient (or group ID in case you want to send it to a group) telephone number in the format DDI DDD NUMERS Ex: 551199999999. IMPORTANT only send numbers without formatting or a mask
messageIdstringMessage ID that will be forwarded
messagePhonestringPhone number of the chat where the messageId is located

Optional#

AttributesTypeDescription
delayMessagenumberIn this attribute a delay is added to the message. You can decide between a range of 1 - 15 secs (this is for how many seconds it will wait to send the next message EX: “delayMessage”:5,). The default delay is between 1 - 3 secs.

Request Body#

{
"phone": "5511999999999",
"messageId": "3999984263738042930CD6ECDE9VDWSA",
"messagePhone": "5511888888888"
}

Response#

200#

AtributosTipoDescrição
zaapIdstringid no z-api

Example

{
"zaapId": "3999984263738042930CD6ECDE9VDWSA"
}

405#

In this case certify that you are sending the correct specification of the method. This means, verify if you sent a POST or GET as specified at the beginning of this topic.

415#

In case you receive 415 error, make sure to add the “Content-Type” of the object you are sending in the request headers, mostly “application/json”


Webhook Response#

Link para a response do webhook (ao receber)

Webhook


Code#