Skip to main content

Mentioning a member

Method#

/send-text#

POST https://api.z-api.io/instances/YOUR_INSTANCE/token/YOUR_TOKEN/send-text

Header#

KeyValue
Client-TokenACCOUNT SECURITY TOKEN

Concept#

This method is responsible for mentioning participants in a group.

image


Attributes#

Required#

AttributesTypeDescription
phonestringThe group ID where the participants will be mentioned.
messagestringText to be sent. It should include the @ symbol with the number.
mentionedarrayNumbers to be mentioned.

Opcionais#

AtributosTipoDescrição
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",
"message": "Welcome to *Z-API group* @number",
"mentioned": [number]
}

Mention everyone in the group.#

This method allows you to mention multiple members of a WhatsApp group without the need to explicitly include the '@' before the numbers. This is useful for tagging multiple members at once.

{
"phone": "5511999999999-group",
"message": "Welcome to *Z-API group*",
"mentioned": [number,number,number,number,number,number]
}

Response#

200#

AtributosTipoDescrição
zaapIdstringid on z-api
messageIdstringid on whatsapp
idstringAdded for compatibility with Zapier, it has the same value as the messageId.

Exemplo

{
"zaapId": "3999984263738042930CD6ECDE9VDWSA",
"messageId": "D241XXXX732339502B68",
"id": "D241XXXX732339502B68"
}

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 to webhook response (on receipt)

Webhook


Code#