Bloqueio de usuários

POST/DELETE/GET /v1/accounts/{id}/block-users — bloqueie, desbloqueie e liste números bloqueados em uma conexão WhatsApp.

Gerencie a lista de bloqueio de uma conexão: bloqueie, desbloqueie e liste números.

POST /v1/accounts/{id}/block-users

Bloqueia até 1000 números por chamada.

POST /v1/accounts/{id}/block-users 200400401404429

Path: id (string, obrig.) — account_id.

Body (JSON):

{ "users": ["+5511999990000"] }

Campo	Tipo	Obrigatório	Regras
`users`	string[]	Sim	obrig., 1 a 1000 itens, números em E.164

A Meta só permite bloquear quem te mandou mensagem nas últimas 24h. Números fora dessa janela aparecem em failedUsers, sem erro.

Resposta 200

{
"addedUsers": ["5511999990000"],
"failedUsers": []
}

Campo	Descrição
`addedUsers`	Números bloqueados com sucesso
`failedUsers`	Números que não puderam ser bloqueados (ex.: sem mensagem nas últimas 24h) — sem erro

Exemplo

curl -X POST https://api.wablastmessage.com/v1/accounts/ckv.../block-users \
-H "Authorization: Bearer wak_sua_chave" \
-H "Content-Type: application/json" \
-d '{
  "users": ["+5511999990000"]
}'

const res = await fetch('https://api.wablastmessage.com/v1/accounts/ckv.../block-users', {
method: 'POST',
headers: {
  'Authorization': 'Bearer ' + process.env.WABLAST_API_KEY,
  'Content-Type': 'application/json',
},
body: JSON.stringify({ users: ['+5511999990000'] }),
});
console.log(res.status, await res.json());

import os, requests

res = requests.post(
  'https://api.wablastmessage.com/v1/accounts/ckv.../block-users',
  headers={'Authorization': 'Bearer ' + os.environ['WABLAST_API_KEY']},
  json={'users': ['+5511999990000']},
)
print(res.status_code, res.json())

<?php
$ch = curl_init('https://api.wablastmessage.com/v1/accounts/ckv.../block-users');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ' . getenv('WABLAST_API_KEY'),
'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
'users' => ['+5511999990000'],
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE) . " " . $res;

DELETE /v1/accounts/{id}/block-users

Desbloqueia números. Mesmo body e limites do bloqueio (users: array de E.164, 1 a 1000 itens).

DELETE /v1/accounts/{id}/block-users 200400401404429

Resposta 200

{
"removedUsers": ["5511999990000"]
}

Exemplo

curl -X DELETE https://api.wablastmessage.com/v1/accounts/ckv.../block-users \
-H "Authorization: Bearer wak_sua_chave" \
-H "Content-Type: application/json" \
-d '{
  "users": ["+5511999990000"]
}'

const res = await fetch('https://api.wablastmessage.com/v1/accounts/ckv.../block-users', {
method: 'DELETE',
headers: {
  'Authorization': 'Bearer ' + process.env.WABLAST_API_KEY,
  'Content-Type': 'application/json',
},
body: JSON.stringify({ users: ['+5511999990000'] }),
});
console.log(res.status, await res.json());

import os, requests

res = requests.delete(
  'https://api.wablastmessage.com/v1/accounts/ckv.../block-users',
  headers={'Authorization': 'Bearer ' + os.environ['WABLAST_API_KEY']},
  json={'users': ['+5511999990000']},
)
print(res.status_code, res.json())

<?php
$ch = curl_init('https://api.wablastmessage.com/v1/accounts/ckv.../block-users');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ' . getenv('WABLAST_API_KEY'),
'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
'users' => ['+5511999990000'],
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE) . " " . $res;

GET /v1/accounts/{id}/block-users

Lista os números bloqueados (paginado).

GET /v1/accounts/{id}/block-users 200401404429

Path: id (string, obrig.) — account_id.

Query:

Campo	Tipo	Obrigatório	Regras
`limit`	int	Não	opcional
`cursor`	string	Não	opcional — nextCursor da página anterior

Resposta 200

{
"users": ["5511999990000"],
"nextCursor": "..."
}

Quando houver mais páginas, passe nextCursor como cursor na chamada seguinte.

Exemplo

curl "https://api.wablastmessage.com/v1/accounts/ckv.../block-users?limit=100" \
-H "Authorization: Bearer wak_sua_chave"

const res = await fetch('https://api.wablastmessage.com/v1/accounts/ckv.../block-users?limit=100', {
headers: { 'Authorization': 'Bearer ' + process.env.WABLAST_API_KEY },
});
console.log(res.status, await res.json());

import os, requests

res = requests.get(
  'https://api.wablastmessage.com/v1/accounts/ckv.../block-users',
  headers={'Authorization': 'Bearer ' + os.environ['WABLAST_API_KEY']},
  params={'limit': 100},
)
print(res.status_code, res.json())

<?php
$ch = curl_init('https://api.wablastmessage.com/v1/accounts/ckv.../block-users?limit=100');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ' . getenv('WABLAST_API_KEY'),
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE) . " " . $res;