setManagedBotAccessSettings
Define as configurações de acesso de um bot gerenciado (Bot API 10.0).
Retorno: Em caso de sucesso, retorna True.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
user_id | Integer | Sim | ID do bot gerenciado |
is_access_restricted | Boolean | Sim | Restringir acesso (apenas usuários selecionados) |
added_user_ids | Array of Integer | Opcional | Array JSON de IDs de usuários com acesso (máx. 10) |
Exemplo de requisição
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/setManagedBotAccessSettings" \
-H "Content-Type: application/json" \
-d '{"user_id":123456789,"is_access_restricted":true}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/setManagedBotAccessSettings",
json={
"user_id": 123456789,
"is_access_restricted": True
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/setManagedBotAccessSettings`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"user_id": 123456789,
"is_access_restricted": true
}),
});
console.log(await res.json());
Guia passo a passo: Como criar um bot no Telegram grátis: do BotFather à primeira mensagem
Métodos relacionados
getMeRetorna informações sobre o bot.getMyCommandsRetorna a lista atual de comandos do bot.setMyCommandsDefine a lista de comandos do bot.deleteMyCommandsApaga os comandos do bot.getMyNameRetorna o nome do bot.setMyNameDefine o nome do bot.getMyDescriptionRetorna a descrição do bot.setMyDescriptionDefine a descrição do bot.getMyShortDescriptionRetorna a descrição curta do bot.setMyShortDescriptionDefine a descrição curta do bot.setMyProfilePhotoDefine a foto de perfil do bot.removeMyProfilePhotoRemove a foto de perfil do bot.