Cómo enviar mensajes con la API de Telegram: sendMessage paso a paso

Actualizado: 29 de octubre de 2026 · 7 min de lectura

La API de Telegram para enviar mensajes es el método sendMessage de la Bot API: haces una petición a https://api.telegram.org/bot<token>/sendMessage con chat_id y text, y Telegram entrega el mensaje como tu bot. Aquí tienes ejemplos listos para copiar en curl, Python y JavaScript, además de formato, botones y los errores más comunes.

Formato de la petición sendMessage

Puedes usar GET o POST y enviar los parámetros como query string, application/x-www-form-urlencoded, application/json o multipart/form-data. Solo dos son obligatorios:

• chat_id: id numérico del chat o @username de un canal o supergrupo público. Si no lo tienes, consulta cómo obtener el chat id.
• text: de 1 a 4096 caracteres después de procesar el formato.

La respuesta siempre trae ok. Si es true, en result recibes el Message enviado, con su message_id; si es false, llegan error_code y description.

Enviar un mensaje con curl, Python y JavaScript

curl -X POST "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{"chat_id": 123456789, "text": "Hola desde la Bot API"}'

import requests

TOKEN = "123456789:AAEexampleTokenReplaceWithYours"

resp = requests.post(
    f"https://api.telegram.org/bot{TOKEN}/sendMessage",
    json={"chat_id": 123456789, "text": "Hola desde Python"},
    timeout=10,
)
data = resp.json()
print(data["result"]["message_id"] if data["ok"] else data["description"])

// Node.js 18+ (módulo ES): fetch viene incluido
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";

const res = await fetch(`https://api.telegram.org/bot${TOKEN}/sendMessage`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ chat_id: 123456789, text: "Hola desde JavaScript" }),
});
const data = await res.json();
console.log(data.ok ? data.result.message_id : data.description);

Ejecuta este código en tu servidor, nunca en una página web pública: cualquiera podría leer el token en el JavaScript del navegador.

Formato del texto: parse_mode HTML y MarkdownV2

Con "parse_mode": "HTML" puedes usar <b>, <i>, <u>, <s>, <tg-spoiler>, <a href="…">, <code>, <pre> y <blockquote>, además de sus variantes <strong>, <em>, <ins>, <del> y <blockquote expandable>. Todo <, > o & que no forme parte de una etiqueta debe escribirse como <, > y &; en Python, html.escape() lo hace por ti.

{
  "chat_id": 123456789,
  "parse_mode": "HTML",
  "text": "<b>Pedido #154</b> confirmado\nTotal: <code>1250 MXN</code>\n<a href=\"https://example.com/pedidos/154\">Ver pedido</a>"
}

Con "parse_mode": "MarkdownV2" la sintaxis es más corta (*negrita*, _cursiva_, [enlace](https://example.com)), pero fuera de las entidades hay que escapar con \ estos caracteres: _ * [ ] ( ) ~ ` > # + - = | { } . !. Olvidarlo es la causa más común del error 400 Bad Request: can't parse entities. Una función de escape en Python:

import re

def escape_md2(text: str) -> str:
    return re.sub(r"([_*\[\]()~`>#+\-=|{}.!\\])", r"\\\1", text)

text = "*Total:* " + escape_md2("1,250.00 MXN (pagado!)")

Ojo: si escribes el texto a mano dentro de un JSON, la barra invertida también se escapa, así que \. se convierte en "\\.".

Botones: teclado inline con reply_markup

{
  "chat_id": 123456789,
  "text": "¿Confirmas tu pedido?",
  "reply_markup": {
    "inline_keyboard": [[
      {"text": "Ver en el sitio", "url": "https://example.com/pedidos/154"},
      {"text": "Confirmar", "callback_data": "confirmar:154"}
    ]]
  }
}

Cada fila es un arreglo de botones. Un botón url abre un enlace; uno con callback_data (de 1 a 64 bytes: los acentos y emojis ocupan más de un byte) envía a tu bot una actualización callback_query. Respóndela siempre con answerCallbackQuery, porque hasta entonces el cliente muestra un indicador de progreso. Si envías los parámetros como formulario en lugar de JSON, reply_markup debe ir serializado como cadena JSON.

Enviar a grupos, canales y temas

• Grupos: usa el id negativo del grupo (en supergrupos empieza por -100). El bot debe ser miembro.
• Canales: el bot debe ser administrador con permiso para publicar. En canales públicos sirve "chat_id": "@nombredelcanal"; en privados, el id -100….
• Temas de foro: añade message_thread_id para publicar en un tema concreto.

Mensajes silenciosos, vista previa de enlaces y respuestas

{
  "chat_id": 123456789,
  "text": "Reporte diario: https://example.com/reporte",
  "disable_notification": true,
  "protect_content": true,
  "link_preview_options": {"is_disabled": true},
  "reply_parameters": {"message_id": 42}
}

• disable_notification: el usuario recibe la notificación sin sonido.
• link_preview_options: is_disabled quita la vista previa; también puedes indicar otra url, prefer_large_media o show_above_text.
• protect_content: impide reenviar y guardar el mensaje.
• reply_parameters: responde a un mensaje concreto.

Errores comunes al enviar mensajes

Como referencia: no más de 1 mensaje por segundo en un mismo chat, 20 por minuto en un grupo y unos 30 por segundo en envíos masivos. Un reintento sencillo en Python:

import time
import requests

def send(token, chat_id, text):
    url = f"https://api.telegram.org/bot{token}/sendMessage"
    while True:
        data = requests.post(url, json={"chat_id": chat_id, "text": text}, timeout=10).json()
        if data.get("error_code") != 429:
            return data
        time.sleep(data["parameters"]["retry_after"])

Antes de escribir código, prueba tus parámetros en sendMessage en Bot API Tester (Ctrl+Enter ejecuta la petición) y consulta la referencia del método, en inglés. Si además tu bot debe recibir mensajes en un servidor, sigue con la guía de webhook para bots de Telegram.