Telegram Bot API

setMySettings

Categoria: Info do bot · Bot API 10.5 · Documentação oficial

Histórico de versões: Adicionado na Bot API 10.5

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âmetroTipoObrigatórioDescrição
supports_inline_queriesBooleanOpcionalAtiva (true) ou desativa (false) o modo inline
inline_query_placeholderStringOpcionalTexto de exemplo da consulta inline no campo de entrada (string vazia = default)
needs_inline_query_locationBooleanOpcionalSolicitar a localização do usuário a cada consulta inline
inline_feedback_share_denominatorIntegerOpcionalFração dos resultados inline escolhidos recebidos: 1 de N (1, 10, 100, 1000; 0 = nenhum)
can_join_groupsBooleanOpcionalPermitir adicionar o bot a grupos
can_read_all_group_messagesBooleanOpcionaltrue = desativar o modo de privacidade (ler todas as mensagens do grupo)
can_connect_to_businessBooleanOpcionalPermitir conectar o bot a contas comerciais
can_manage_botsBooleanOpcionalPermitir que o bot crie bots gerenciados
supports_guest_queriesBooleanOpcionalPermitir consultas de convidado de chats dos quais o bot não é membro
supports_join_request_queriesBooleanOpcionalPermitir designar o bot para processar solicitações de entrada
has_topics_enabledBooleanOpcionalAtivar o modo de tópicos do fórum em chats privados com o bot
allows_users_to_create_topicsBooleanOpcionalPermitir que usuários criem e apaguem tópicos em chats privados
has_topic_sidebarBooleanOpcionalExibir os tópicos do chat privado em uma barra lateral (Bot API 10.5)
can_communicate_with_botsBooleanOpcionalPermitir que o bot se comunique com outros bots
callback_query_modeStringOpcionalModo de consultas de callback: default, auto ou inline (inline_message_id em vez de message)

As descrições dos parâmetros são resumos concisos; consulte a documentação oficial para ver o texto completo.

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