curl --request GET \
--url https://api.wppfy.com/instance/wa_messages_limits \
--header 'token: <api-key>'import requests
url = "https://api.wppfy.com/instance/wa_messages_limits"
headers = {"token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {token: '<api-key>'}};
fetch('https://api.wppfy.com/instance/wa_messages_limits', 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://api.wppfy.com/instance/wa_messages_limits",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"token: <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"
"net/http"
"io"
)
func main() {
url := "https://api.wppfy.com/instance/wa_messages_limits"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.wppfy.com/instance/wa_messages_limits")
.header("token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.wppfy.com/instance/wa_messages_limits")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["token"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"provider": "whatsapp",
"reachable": true,
"can_send_new_messages": false,
"error_key": "WHATSAPP_REACHOUT_TIMELOCK",
"message": "WhatsApp indicates that the currently connected account is under a temporary restriction for starting new conversations. This is not an internal API error.",
"message_ptbr": "O WhatsApp indica que a conta atualmente conectada está sob uma restrição temporária para iniciar novas conversas. Isso não é um erro interno da API.",
"provider_message": "WhatsApp reported that the currently connected account is under a temporary restriction for starting new conversations, usually related to sending volume or quality.",
"provider_message_ptbr": "O WhatsApp informou que a conta atualmente conectada está sob uma restrição temporária para iniciar novas conversas, normalmente relacionada a volume ou qualidade de envios.",
"diagnostics_endpoint": "/instance/wa_messages_limits",
"new_chat_message_capping": {
"available": true,
"status": "CAPPED",
"used_quota": 10,
"total_quota": 10,
"cycle_end": "2026-04-30T23:59:59Z",
"ote_status": "EXHAUSTED",
"mv_status": "ACTIVE"
},
"reachout_timelock": {
"available": true,
"active": true,
"until": "2026-04-07T12:00:00Z",
"enforcement_type": "BIZ_QUALITY"
}
}Consultar limites atuais de novas conversas no WhatsApp
Consulta o estado atual de limitação do WhatsApp para a conta atualmente conectada.
Este endpoint é útil para:
- diagnosticar erros de envio com
provider_code: 463 - verificar se o WhatsApp indica que a conta atualmente conectada pode iniciar novas conversas
- exibir informações de suporte antes de campanhas ou envios de alto volume
A resposta consolida duas fontes internas do WhatsApp:
new_chat_message_capping: limite de mensagens para iniciar novas conversasreachout_timelock: restrição temporária para iniciar novas conversas
Observações:
- este endpoint depende de sessão ativa e conectada
- se o WhatsApp não retornar os dados esperados, a resposta pode marcar os blocos como indisponíveis via
available: falseelookup_error messagedescreve o estado atual da conta atualmente conectadaprovider_messagedetalha o motivo reportado pelo WhatsApp quando houver restrição ativa
curl --request GET \
--url https://api.wppfy.com/instance/wa_messages_limits \
--header 'token: <api-key>'import requests
url = "https://api.wppfy.com/instance/wa_messages_limits"
headers = {"token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {token: '<api-key>'}};
fetch('https://api.wppfy.com/instance/wa_messages_limits', 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://api.wppfy.com/instance/wa_messages_limits",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"token: <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"
"net/http"
"io"
)
func main() {
url := "https://api.wppfy.com/instance/wa_messages_limits"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.wppfy.com/instance/wa_messages_limits")
.header("token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.wppfy.com/instance/wa_messages_limits")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["token"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"provider": "whatsapp",
"reachable": true,
"can_send_new_messages": false,
"error_key": "WHATSAPP_REACHOUT_TIMELOCK",
"message": "WhatsApp indicates that the currently connected account is under a temporary restriction for starting new conversations. This is not an internal API error.",
"message_ptbr": "O WhatsApp indica que a conta atualmente conectada está sob uma restrição temporária para iniciar novas conversas. Isso não é um erro interno da API.",
"provider_message": "WhatsApp reported that the currently connected account is under a temporary restriction for starting new conversations, usually related to sending volume or quality.",
"provider_message_ptbr": "O WhatsApp informou que a conta atualmente conectada está sob uma restrição temporária para iniciar novas conversas, normalmente relacionada a volume ou qualidade de envios.",
"diagnostics_endpoint": "/instance/wa_messages_limits",
"new_chat_message_capping": {
"available": true,
"status": "CAPPED",
"used_quota": 10,
"total_quota": 10,
"cycle_end": "2026-04-30T23:59:59Z",
"ote_status": "EXHAUSTED",
"mv_status": "ACTIVE"
},
"reachout_timelock": {
"available": true,
"active": true,
"until": "2026-04-07T12:00:00Z",
"enforcement_type": "BIZ_QUALITY"
}
}Autorizações
Resposta
Diagnóstico atual dos limites de novas conversas da conta atualmente conectada
"whatsapp"
Indica se ao menos uma das consultas ao WhatsApp retornou dados úteis
true
Indica se o WhatsApp sinaliza que a conta atualmente conectada pode iniciar novas conversas.
Pode ser null quando não foi possível concluir o diagnóstico.
false
Chave de erro derivada do diagnóstico atual
"WHATSAPP_REACHOUT_TIMELOCK"
Mensagem técnica principal em inglês
"WhatsApp indicates that the currently connected account is under a temporary restriction for starting new conversations. This is not an internal API error."
Mensagem principal traduzida para pt-BR
"O WhatsApp indica que a conta atualmente conectada está sob uma restrição temporária para iniciar novas conversas. Isso não é um erro interno da API."
Motivo detalhado reportado pelo WhatsApp em inglês
"WhatsApp reported that the currently connected account is under a temporary restriction for starting new conversations, usually related to sending volume or quality."
Motivo detalhado reportado pelo WhatsApp em pt-BR
"O WhatsApp informou que a conta atualmente conectada está sob uma restrição temporária para iniciar novas conversas, normalmente relacionada a volume ou qualidade de envios."
"/instance/wa_messages_limits"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
