API de Anuncios de Telegram e Integraciones: Automatiza Tu Flujo de Trabajo

Telegram no publica ninguna API para anunciantes: su sitio para desarrolladores enumera una Bot API, una API de cliente, TDLib, una Gateway API y una Payments API, y ninguna de ellas crea campañas publicitarias ni informa sobre ellas. ADSLY se conecta a tus cuentas publicitarias mediante una sesión autorizada y pone encima tres superficies de integración: una API REST que lee tus estadísticas y, si tú lo permites, gestiona tus campañas; webhooks firmados; y un endpoint que recibe conversiones de tu tracker.

Cómo funciona la «API» de Telegram Ads

La plataforma publicitaria de Telegram vive en ads.telegram.org y se maneja desde su interfaz web. Revisamos la documentación para desarrolladores de Telegram en octubre de 2026: core.telegram.org presenta la Bot API (con una Payments API para bots), TDLib, la Gateway API y la Telegram API para crear aplicaciones cliente. Sus dos artículos relacionados con anuncios son Sponsored Messages, que explica a las aplicaciones cliente cómo mostrar anuncios, y otro sobre los ingresos publicitarios de los dueños de canales y bots; ninguno está pensado para un anunciante que gestiona campañas. La guía de inicio de la propia plataforma tampoco menciona ninguna API.

Por eso ADSLY trabaja a través de una sesión de la cuenta de Telegram que es dueña de la cuenta publicitaria. Puedes conectar una cuenta de tres maneras: introducir tu número de teléfono y confirmar la solicitud en Telegram, usar nuestra extensión de navegador mientras tienes la sesión abierta en ads.telegram.org, o pegar tú mismo el token de sesión. La solicitud conecta solo la cuenta publicitaria, no tu Telegram personal. Las cuentas procedentes de Adstat se conectan con tu usuario de Adstat. Una vez conectadas, las cuentas Euro, TON y Stars se manejan igual.

Qué hace ADSLY una vez conectada la cuenta

Todo lo que en la interfaz web se hace a base de clics se convierte en una acción del panel:

Creación de campañas — una campaña con todos sus ajustes, o una construcción masiva: varios textos × varios enlaces × una lista de canales, con la opción de separar en una campaña por país, por tema o por dispositivo.

Cambios de CPM y presupuesto — fijar, subir o bajar la puja de todas las campañas seleccionadas, por un importe o por un porcentaje; añadir presupuesto, reducirlo o retirar lo que queda.

Pausar, reanudar y eliminar — para una selección, un grupo o todas las campañas que cumplan el filtro actual.

Sincronización de estadísticas — vistas, clics, acciones, gasto, CTR y CPM se guardan una vez por hora para cada campaña.

Edición de texto, título y medios — en bloque, sin recrear las campañas.

Control de saldos — el panel principal lista cada cuenta con su saldo y su número de campañas activas, en revisión, rechazadas y detenidas, actualizados en cada sincronización.

Exportación de datos y reportes

El panel conserva más historial del que muestra una pestaña de estadísticas y te deja sacarlo:

Exportación a Excel, CSV y PDF — un archivo de datos con las columnas que elijas, o un reporte en PDF, para una cuenta entera, un grupo o las campañas seleccionadas. Disponible en Pro y Agency.

Datos de rendimiento por hora — una instantánea por campaña y hora, conservada 30 días; los periodos más largos usan totales diarios. No tenemos una medición por hora del día entre cuentas, así que usa el gráfico por hora de tus propias campañas para encontrar tus horas.

Analítica de todas las cuentas — la página Analítica suma vistas, clics y acciones de cada cuenta a la que tienes acceso. El gasto se mantiene separado por moneda: euros, TON y Stars nunca se suman.

Historial de cambios — cada cambio de estado, de puja y de presupuesto de una campaña queda registrado con quién o qué lo hizo, incluidas las reglas y Auto CPM.

Hooks de automatización

Las reglas y las acciones automáticas se ejecutan después de cada sincronización horaria, sin nadie mirando el panel:

Reglas IF/THEN — condiciones sobre vistas, clics, acciones, CTR, CVR, gasto, CPC, CPA, CPM y presupuesto, cada una medida sobre todo el historial o sobre las últimas 1–168 horas. Acciones: pausar, activar, fijar el CPM, subirlo o bajarlo por un importe o un porcentaje, añadir o reducir presupuesto, o solo notificar. Ejemplo: SI el CPM supera €2,50 en las últimas 6 horas, ENTONCES bajar la puja un 15%. Una regla puede aplicarse a una campaña, a un grupo, a una selección o a toda la cuenta.

Reglas sobre tus propias conversiones — cuando tu tracker envía postbacks, el mismo motor puede actuar sobre leads, conversiones, compras, ingresos, ROAS, coste por lead y coste por venta. Una cuenta que no envía postbacks nunca queda pausada por una regla así: la falta de datos se trata como desconocida, no como cero.

Borradores de reglas para varias cuentas — un borrador guardado vive en tu usuario de ADSLY, y Aplicar a cuentas (Apply to cabinets) lo copia en cada cuenta que marques.

Auto CPM — una vez por hora el panel comprueba si el anuncio se muestra de verdad en los canales y bots a los que apunta. Se muestra en la mayoría: la puja baja un 10%. No se muestra en la mayoría: sube un 10%. Necesita dos comprobaciones seguidas que coincidan, espera tres horas entre cambios y hace como máximo seis al día por campaña.

Recrear y AI Recreate — un anuncio rechazado se vuelve a enviar automáticamente; con AI Recreate cada intento lleva el texto reformulado. No publicamos ningún porcentaje de recuperación.

Casos de integración para agencias

Cuatro montajes que estas piezas hacen posibles:

Reportes a clientes — exporta un PDF o un Excel por cuenta de cliente o por grupo, o lleva /v1/stats a la herramienta de reportes que ya usas.

Alertas — una regla con la acción de notificar aparece en el resumen horario, que llega por Telegram, por correo o dentro de la aplicación. Para tus propios sistemas, el webhook status_change se dispara cuando una campaña pasa a Declined, Active o cualquier otro estado.

Paneles propios — /v1/stats/total devuelve totales y puntos de gráfico por cuenta; una sincronización típica son tres o cuatro peticiones, muy por debajo de las 60 por minuto que admite una clave.

Cerrar el ciclo con un tracker — envía leads y ventas al endpoint de postbacks y la tabla de campañas muestra el coste por lead y por venta junto a las columnas de Telegram. El panel trae plantillas de postback listas para pegar para Keitaro, RedTrack, Binom y Voluum.

API REST y webhooks de ADSLY

La API está activa para cuentas Pro y Agency. Abre API en el menú, pulsa + Nueva clave (+ New key) y elige a qué cuentas llega la clave —una, varias o todas— y si además puede gestionar campañas. Puede haber hasta cinco claves activas a la vez.

URL base: https://app.adsly.pro/api/v1 · Autenticación: cabecera X-API-Key · Límite: 60 peticiones por minuto por clave

Cualquier clave puede leer:

• GET /v1/account/info — las cuentas que ve esta clave

• GET /v1/campaigns — campañas con sus métricas; filtros por estado, título, nombre de usuario del bot o canal, dominio de la página de destino y tipo de anuncio; paginación por cursor

• GET /v1/stats — estadísticas por campaña para un periodo, agrupadas por cuenta

• GET /v1/stats/total — totales y puntos de gráfico por cuenta

• GET /v1/stats/analytics — analítica del periodo con las campañas principales

• GET /v1/campaigns/:adId/history — una campaña a lo largo de un periodo

• GET /v1/conversions — conversiones recibidas por postback, por campaña

Gestionar campañas (Manage campaigns). Mientras no actives esta opción en una clave, la clave solo lee. Con ella activada, además crea campañas (hasta 100 por llamada), edita texto, enlace, CPM y tope diario, pausa y reanuda, añade presupuesto o retira lo que queda, copia, lanza acciones masivas sobre hasta 1.000 campañas de una vez, elimina y sube medios. Ninguna clave puede sacar dinero de una cuenta: el presupuesto solo se mueve entre el saldo de la cuenta y sus campañas. Cada cambio hecho por la API aparece en el historial de la campaña en el panel, y las llamadas de creación, presupuesto, copia y acciones masivas aceptan un Idempotency-Key, así que reintentar tras un timeout no ejecuta nada dos veces.

La documentación completa está en adsly.pro/docs/api (en inglés), con una versión Markdown de cada página y un índice llms.txt para asistentes de IA.

Hay dos cosas en las que tropiezan las primeras integraciones. Los campos monetarios (spent, budget, cpm, cpc, cpa, ctr) llegan como cadenas para conservar la precisión, así que conviértelos antes de hacer cuentas. Y ad_id es único solo dentro de una cuenta —Telegram reutiliza los identificadores—, de modo que guárdalo siempre junto con account_id.

Webhooks. Pon una Postback URL en una clave y ADSLY le enviará JSON firmado: status_change cuando el estado de una campaña cambia en la sincronización, y hourly_digest cinco minutos después de cada hora en punto, con vistas, clics, gasto y acciones por campaña de la hora que acaba de cerrarse. Cada petición lleva una firma HMAC-SHA256 en X-Adsly-Signature, una marca de tiempo y un identificador de entrega único. El endpoint debe ser HTTPS público; una entrega fallida se reintenta una vez.

Conversiones entrantes. Activa Recibir postbacks (Receive postbacks) en una clave y después envía POST /v1/postback desde tu backend con la clave en la cabecera, o dale a tu tracker la URL de solo escritura que sale de Generar URL para el tracker (Generate tracker URL). Los eventos son lead, conversion y purchase, con importe y moneda opcionales; caben hasta 1.000 eventos en una petición y una clave acepta 20 eventos por segundo. Un evento se asocia a su campaña por el valor que lleva el enlace del anuncio: el parámetro ?start= en anuncios de bots, el parámetro de tu tracker en anuncios de sitios web.

Seguridad y acceso

Estas cuentas manejan presupuestos reales, así que cada superficie es estrecha a propósito:

Sesión, no contraseña — una cuenta de Telegram Ads se conecta confirmando una solicitud en Telegram, con la extensión de navegador o con un token de sesión. La conexión cubre la cuenta publicitaria, no tu Telegram personal.

Solo lectura por defecto, guardadas con hash — una clave solo lee hasta que su dueño activa Gestionar campañas, e incluso entonces no puede sacar dinero de una cuenta. Las claves se guardan como hashes SHA-256, por lo que una clave perdida no se puede recuperar, solo revocar y sustituir.

Webhooks firmados — verifica la firma HMAC y rechaza las peticiones cuya marca de tiempo tenga más de cinco minutos. ADSLY se niega a entregar a direcciones sin HTTPS, de loopback o privadas.

Acceso del equipo por cuenta — en el plan Agency cada miembro recibe el nivel Viewer, Manager o ningún acceso para cada cuenta. Los miembros crean sus propias claves de API, y cada clave llega solo a las cuentas compartidas con ese miembro: de solo lectura donde es Viewer, con cambios permitidos donde es Manager.

Automatiza tu flujo de trabajo en Telegram Ads. ADSLY gestiona 500,000+ campañas, y una cuenta Euro se abre para cualquier país. Los tres tipos de cuenta (TON, Euro, Stars). Reglas IF/THEN, operaciones masivas, una API para estadísticas y gestión de campañas, webhooks y exportación. Empieza gratis — prueba Pro de 3 días →

Preguntas frecuentes

¿Existe una API pública de Telegram Ads?

Para anunciantes, no. El sitio para desarrolladores de Telegram enumera la Bot API, la API de cliente, TDLib, una Gateway API y una Payments API (consultado en octubre de 2026); ninguna gestiona campañas publicitarias, y la sección Sponsored Messages es para las aplicaciones que muestran anuncios. La plataforma publicitaria de ads.telegram.org se maneja desde su interfaz web. ADSLY trabaja sobre ella mediante una sesión autorizada.

¿Cómo se conecta ADSLY a mi cuenta de Telegram Ads?

Mediante una sesión de la cuenta de Telegram que es dueña de la cuenta publicitaria. Confirmas una solicitud en Telegram tras introducir tu número de teléfono, usas la extensión de navegador o pegas el token de sesión. La solicitud conecta solo la cuenta publicitaria. Así se conectan las cuentas Euro, TON y Stars; las cuentas procedentes de Adstat se conectan con un usuario de Adstat.

¿Están seguros mis datos de Telegram Ads en ADSLY?

Las superficies de integración son estrechas por diseño. Las claves de API solo leen mientras no actives Gestionar campañas, nunca pueden sacar dinero de una cuenta y se guardan como hashes; cada cambio hecho por la API queda en el historial de la campaña; los webhooks van firmados con un secreto propio de cada clave y solo se envían a endpoints HTTPS públicos; la URL de solo escritura para el tracker puede enviar conversiones pero no leer nada; y en el plan Agency el acceso se concede por cuenta y por persona.

¿Puedo exportar los datos de Telegram Ads a Google Sheets?

No hay un conector directo con Google Sheets. Exporta un archivo CSV o Excel desde el panel e impórtalo, o lee la API desde un script: /v1/stats devuelve los números por campaña para cualquier periodo.

¿ADSLY admite webhooks para Telegram Ads?

Sí. Una clave con Postback URL recibe status_change cada vez que cambia el estado de una campaña y hourly_digest una vez por hora con vistas, clics, gasto y acciones por campaña. Ambos van firmados con HMAC-SHA256, y el botón Test de la clave envía un ping para que compruebes tu receptor.

¿Ya está disponible la API REST de ADSLY?

Sí, en los planes Pro y Agency, y las claves las creas tú mismo en el panel. Cualquier clave lee la lista de cuentas, campañas, estadísticas, analítica, historial por campaña y conversiones recibidas, a 60 peticiones por minuto por clave. Una clave con Gestionar campañas activado también crea, edita, pausa, reanuda, recarga, copia y elimina campañas y sube medios. Documentación: adsly.pro/docs/api.