setMySettings
Altera as configurações do bot: modo inline, privacidade, grupos, tópicos, modo de consultas de callback (Bot API 10.5).
Retorno: Em caso de sucesso, retorna True.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
supports_inline_queries | Boolean | Opcional | Ativa (true) ou desativa (false) o modo inline |
inline_query_placeholder | String | Opcional | Texto de exemplo da consulta inline no campo de entrada (string vazia = default) |
needs_inline_query_location | Boolean | Opcional | Solicitar a localização do usuário a cada consulta inline |
inline_feedback_share_denominator | Integer | Opcional | Fração dos resultados inline escolhidos recebidos: 1 de N (1, 10, 100, 1000; 0 = nenhum) |
can_join_groups | Boolean | Opcional | Permitir adicionar o bot a grupos |
can_read_all_group_messages | Boolean | Opcional | true = desativar o modo de privacidade (ler todas as mensagens do grupo) |
can_connect_to_business | Boolean | Opcional | Permitir conectar o bot a contas comerciais |
can_manage_bots | Boolean | Opcional | Permitir que o bot crie bots gerenciados |
supports_guest_queries | Boolean | Opcional | Permitir consultas de convidado de chats dos quais o bot não é membro |
supports_join_request_queries | Boolean | Opcional | Permitir designar o bot para processar solicitações de entrada |
has_topics_enabled | Boolean | Opcional | Ativar o modo de tópicos do fórum em chats privados com o bot |
allows_users_to_create_topics | Boolean | Opcional | Permitir que usuários criem e apaguem tópicos em chats privados |
has_topic_sidebar | Boolean | Opcional | Exibir os tópicos do chat privado em uma barra lateral (Bot API 10.5) |
can_communicate_with_bots | Boolean | Opcional | Permitir que o bot se comunique com outros bots |
callback_query_mode | String | Opcional | Modo de consultas de callback: default, auto ou inline (inline_message_id em vez de message) |
Exemplo de requisição
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/setMySettings" \
-H "Content-Type: application/json" \
-d '{
"supports_inline_queries": true,
"can_read_all_group_messages": false,
"callback_query_mode": "auto"
}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/setMySettings",
json={
"supports_inline_queries": True,
"can_read_all_group_messages": False,
"callback_query_mode": "auto"
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/setMySettings`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"supports_inline_queries": true,
"can_read_all_group_messages": false,
"callback_query_mode": "auto"
}),
});
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 do bot (BotFullInfo a partir do Bot API 10.5).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.