Telegram Bot API

setMySettings

Categoría: Info del bot · Bot API 10.5 · Documentación oficial

Historial de versiones: Agregado en la Bot API 10.5

Cambia la configuración del bot: modo inline, privacidad, grupos, temas y modo de consultas de callback (Bot API 10.5).

Devuelve: Si la llamada tiene éxito, devuelve True.

Parámetros

ParámetroTipoObligatorioDescripción
supports_inline_queriesBooleanOpcionalActiva (true) o desactiva (false) el modo inline
inline_query_placeholderStringOpcionalTexto de ejemplo de la consulta inline en el campo de entrada (cadena vacía = default)
needs_inline_query_locationBooleanOpcionalSolicitar la ubicación del usuario con cada consulta inline
inline_feedback_share_denominatorIntegerOpcionalProporción de resultados inline elegidos que se reciben: 1 de N (1, 10, 100, 1000; 0 = ninguno)
can_join_groupsBooleanOpcionalPermitir añadir el bot a grupos
can_read_all_group_messagesBooleanOpcionaltrue = desactivar el modo de privacidad (leer todos los mensajes del grupo)
can_connect_to_businessBooleanOpcionalPermitir conectar el bot a cuentas empresariales
can_manage_botsBooleanOpcionalPermitir que el bot cree bots administrados
supports_guest_queriesBooleanOpcionalPermitir consultas de invitado desde chats de los que el bot no es miembro
supports_join_request_queriesBooleanOpcionalPermitir asignar el bot para procesar solicitudes para unirse
has_topics_enabledBooleanOpcionalActivar el modo de temas del foro en chats privados con el bot
allows_users_to_create_topicsBooleanOpcionalPermitir a los usuarios crear y eliminar temas en chats privados
has_topic_sidebarBooleanOpcionalMostrar los temas del chat privado en una barra lateral (Bot API 10.5)
can_communicate_with_botsBooleanOpcionalPermitir que el bot se comunique con otros bots
callback_query_modeStringOpcionalModo de consultas de callback: default, auto o inline (inline_message_id en lugar de message)

Las descripciones de los parámetros son resúmenes breves; consulta la documentación oficial para ver el texto completo.

Ejemplo de solicitud

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());

Guía paso a paso: Cómo crear un bot en Telegram paso a paso: de BotFather a tu primer mensaje