Skip to main content

Change Business Hours

Method#

/business/hours#

POST https://api.z-api.io/instances/{{instanceId}}/token/{{instanceToken}}/business/hours

Header#

KeyValue
Client-TokenACCOUNT SECURITY TOKEN

Concept#

Through this method, it is possible to change the operating hours of the company.

Important

This method is only available for Business WhatsApp accounts.


Attributes#

Required#

AttributesTypeDescription
timezonestringTimezone location

Optional#

AttributesTypeDescription
modestringOperating mode (specificHours, open24h, appointmentOnly)
daysarray objectDays of the week when the company operates

Object (days)

AttributesTypeDescription
dayOfWeekstringDay of the week (SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY)
openTimestringOpening time (hh:mm format)
closeTimestringClosing time (hh:mm format)

Request Body#

{
"timezone": "America/Sao_Paulo",
"days": [
{
"dayOfWeek": "MONDAY",
"openTime": "08:00",
"closeTime": "12:00"
},
{
"dayOfWeek": "MONDAY",
"openTime": "14:00",
"closeTime": "18:00"
}
],
"mode": "specificHours"
}
Tip

To set all days as "closed," simply send the "days" attribute as empty.


Response#

201#

AttributesTypeDescription
successbooleantrue if successful, false in case of failure

Example

{
"success": true
}

405#

In this case, ensure that you are sending the method specification correctly, i.e., check if you sent the POST or PUT 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 in the request headers, in most cases, it should be "application/json".


Code#