Skip to main content

Send catalog

Method#

/send-catalog#

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

Header#

KeyValue
Client-TokenACCOUNT SECURITY TOKEN

Concept#

In this method, you can send messages with a link to your catalog. The catalog feature is only available for business WhatsApp accounts. It is also necessary for the account to have products and a configured catalog. Operations related to products and collections can be found in the WhatsApp Business section of our documentation.

image


Attributes#

Required#

AttributeTypeDescription
phonestringRecipient's phone number (or group ID for group messages) in the format DDI DDD NUMBER E.g., 551199999999. IMPORTANT Send only numbers, without formatting or mask
catalogPhonestringPhone number of the business account to which the catalog belongs.

Request Body#

{
"phone": "5511999999999",
"catalogPhone": "5511999999999"
}

Response#

200#

AttributeTypeDescription
zaapIdstringid in z-api
messageIdstringid in WhatsApp
idstringAdded for compatibility with Zapier, it has the same value as messageId

Example

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

405#

In this case, make sure you are correctly sending the method specification, i.e., check if you sent the POST or GET as specified at the beginning of this topic.

415#

If you receive a 415 error, make sure to add the "Content-Type" of the object you are sending to the headers of the request, mostly "application/json"


Webhook Response#

Link to the webhook response (upon receipt)

Webhook


Code#