setMySettings
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ámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
supports_inline_queries | Boolean | Opcional | Activa (true) o desactiva (false) el modo inline |
inline_query_placeholder | String | Opcional | Texto de ejemplo de la consulta inline en el campo de entrada (cadena vacía = default) |
needs_inline_query_location | Boolean | Opcional | Solicitar la ubicación del usuario con cada consulta inline |
inline_feedback_share_denominator | Integer | Opcional | Proporción de resultados inline elegidos que se reciben: 1 de N (1, 10, 100, 1000; 0 = ninguno) |
can_join_groups | Boolean | Opcional | Permitir añadir el bot a grupos |
can_read_all_group_messages | Boolean | Opcional | true = desactivar el modo de privacidad (leer todos los mensajes del grupo) |
can_connect_to_business | Boolean | Opcional | Permitir conectar el bot a cuentas empresariales |
can_manage_bots | Boolean | Opcional | Permitir que el bot cree bots administrados |
supports_guest_queries | Boolean | Opcional | Permitir consultas de invitado desde chats de los que el bot no es miembro |
supports_join_request_queries | Boolean | Opcional | Permitir asignar el bot para procesar solicitudes para unirse |
has_topics_enabled | Boolean | Opcional | Activar el modo de temas del foro en chats privados con el bot |
allows_users_to_create_topics | Boolean | Opcional | Permitir a los usuarios crear y eliminar temas en chats privados |
has_topic_sidebar | Boolean | Opcional | Mostrar los temas del chat privado en una barra lateral (Bot API 10.5) |
can_communicate_with_bots | Boolean | Opcional | Permitir que el bot se comunique con otros bots |
callback_query_mode | String | Opcional | Modo de consultas de callback: default, auto o inline (inline_message_id en lugar de message) |
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
Métodos relacionados
getMeDevuelve información del bot (BotFullInfo desde Bot API 10.5).getMyCommandsDevuelve la lista actual de comandos del bot.setMyCommandsEstablece la lista de comandos del bot.deleteMyCommandsElimina los comandos del bot.getMyNameDevuelve el nombre del bot.setMyNameEstablece el nombre del bot.getMyDescriptionDevuelve la descripción del bot.setMyDescriptionEstablece la descripción del bot.getMyShortDescriptionDevuelve la descripción corta del bot.setMyShortDescriptionEstablece la descripción corta del bot.setMyProfilePhotoEstablece la foto de perfil del bot.removeMyProfilePhotoElimina la foto de perfil del bot.