Módulo 12 · Notificaciones
Notificaciones de eventos en tu propio bot de Telegram
Un postback puede ir a otro sitio, no solo a tu tracker. La misma petición puede arrancar un escenario en Make y llegarte a Telegram como mensaje: registro, depósito, comisión — con el importe, la campaña y tu etiqueta de fuente ya dentro.
01
Cómo funciona la cadena
Entre la acción del trader y el mensaje en tu chat hay tres pasos. El sistema de afiliados envía un postback, Make lo recibe y arma el texto, y tu bot lo entrega.
01
El trader genera un evento
Un registro, un depósito, un retiro o una comisión ya acreditada.
02
La petición llega a Make
El postback va a la dirección del webhook y el escenario arranca.
03
Filtro y texto
El escenario comprueba qué evento llegó y construye el mensaje con los parámetros de la petición.
04
El bot envía el mensaje
Escribe en tu chat privado, grupo o canal — normalmente en segundos.
Make no calcula ni cambia nada. Recibe los mismos datos que recibe tu tracker y los muestra en un formato legible.
El postback de Telegram es un postback adicional, no un sustituto del que va al tracker. Pregunta a tu manager si se permite un segundo destino para el mismo evento; si no, deja el tracker como principal y reenvía la petición desde Make con un módulo HTTP.
02
Qué preparar
Tres cosas antes de empezar. Llevan unos diez minutos y después el escenario se arma sin pausas.
Make
Una cuenta en Make
El plan gratuito basta para empezar: 1 000 operaciones al mes. Una notificación entregada gasta dos — recibir la petición y enviar el mensaje.
BotFather
Tu propio bot y su token
Envía a @BotFather el comando /newbot, elige un nombre y un usuario, y recibirás un token parecido a 8123456789:AAH… Es la contraseña del bot: nunca lo publiques ni lo reenvíes a un chat compartido.
Chat ID
El id del chat
Chat privado: envía /start al bot y abre api.telegram.org/botTOKEN/getUpdates en el navegador, con tu propio token en lugar de TOKEN — la respuesta trae el chat id. Grupo: añade primero el bot; el id de un grupo empieza con un signo menos. Canal: haz al bot administrador.
Un bot no puede escribir primero a quien nunca le ha escrito. Si no llega nada a tu chat privado, abre el bot y pulsa Start.
03
Paso 1. El webhook de Make
Un webhook es una dirección que espera una petición. Va primero, porque la URL del postback se construye sobre esa dirección.
- Crea un escenarioEn Make, abre Scenarios y pulsa Create a new scenario.
- Añade el módulo WebhooksPulsa «+», busca Webhooks y elige Custom webhook.
- Crea el webhookAdd → ponle un nombre, por ejemplo PocketPartners Events → Save. Make devuelve una dirección receptora.
- Copia la dirección enteraUsa Copy address to clipboard. La región cambia según la cuenta — eu1, eu2 o us1 —, así que usa tu propia dirección y no la del ejemplo.
- No le añadas nadaNo hace falta que agregues parámetros propios: todos los valores llegan desde el postback.
https://hook.eu2.make.com/9f31c2ad74qz8mvb1kxs
Esa es la dirección receptora. En el siguiente paso se convierte en el comienzo de la URL del postback.
04
Paso 2. Un postback a esa dirección
Ahora crea en tu panel de partner el postback que envía los eventos a Make. La regla es la misma que para un tracker: un evento, un postback.
- Abre Postbacks → Add New PostbackEl tipo Global envía los eventos de toda la cuenta; Campaign envía solo los de la campaña que elijas.
- Elige el eventoRegistration, First Deposit, Re-deposit, Withdrawal o Commission. Cada evento que quieras recibe su propio postback.
- Arma la URLLa dirección del webhook, después ?event= con tu propio valor y después los parámetros con sus macros. El primer parámetro siempre va tras un ?, y cada uno de los siguientes tras un &.
- Envía todo lo que quieras ver en el mensajeUn valor solo llega a Make si su macro está en la URL. Si la ficha del evento activa y desactiva parámetros, activa los mismos que pusiste en la URL: un parámetro desactivado no se envía.
- Guárdalo y repite con los demás eventosCada evento lleva su propio valor de event=. Ese valor es lo que permite al escenario distinguir un registro de un depósito.
https://hook.eu2.make.com/9f31c2ad74qz8mvb1kxs?event=registration&trader_id={trader_id}&cid={cid}&ac={ac}&country={country}&date_time={date_time}
A la izquierda, la dirección del webhook, sin cambios. event=registration es tu propia etiqueta del evento. Después vienen los nombres de parámetros y los macros: el sistema los rellena con valores reales al enviar la petición.
Para la lista completa de macros y un constructor de URL, mira Postbacks: para qué sirven y cómo construir la URL.
05
Paso 3. Un evento de prueba
Make no sabe qué campos van a llegar hasta que ve la primera petición. Por eso el texto del mensaje se escribe después de la prueba, no antes.
- Ponte a la escuchaEn el escenario, pulsa Run once — el webhook queda esperando una única petición.
- Envía un eventoLa vía rápida: abre en el navegador la URL que armaste con los macros sustituidos por cualquier valor. La comprobación completa es un registro de prueba con tu propio enlace de afiliado.
- Mira qué llegóEn el módulo aparece un contador, y en su salida se listan los campos: event, trader_id, cid y todo lo demás que hayas enviado.
- Vuelve a determinar la estructura tras cada cambio¿Añadiste un parámetro al postback? Pulsa Re-determine data structure y envía el evento otra vez, o el campo nuevo no aparecerá en la lista.
Una salida vacía casi siempre significa una cosa: a la URL del postback le faltan parámetros o está mal armada. Comprueba que el primer parámetro va tras un ? y no tras un &.
06
Paso 4. Filtro y mensaje
Quedan dos módulos: un filtro descarta los eventos que no pediste y Telegram envía el texto. Arma el texto aquí abajo — el constructor mapea los campos de Make y muestra cómo llegará el mensaje al chat.
El filtro entre el webhook y TelegramLa condición se pone en la conexión entre los módulos: a la izquierda el campo event del webhook, el operador Equals y a la derecha el valor del evento. Sin filtro, al chat llegan todos los eventos.
EventosMarca los eventos de los que quieres notificaciones. Cada uno recibe su propio texto y su propio valor de filtro.
Qué muestra el mensajeA la izquierda, el valor que llega del postback; a la derecha, la etiqueta con la que aparece en el chat. Reescribe cualquier etiqueta a tu gusto.
El módulo de Telegram
- Add a module → Telegram Bot → Send a Text MessageVa después del filtro, el último del escenario.
- Create a connectionPega el token de @BotFather. El token vive en la conexión — nunca debe aparecer en el texto del mensaje.
- Chat IDEl id del chat al que escribir. El id de un grupo lleva un signo menos.
- TextPega el texto ya listo del constructor de arriba.
- Guarda el escenario y enciéndeloEl interruptor del escenario tiene que estar en ON: un escenario apagado no capta eventos.
Deja Parse mode vacío. Con Markdown o HTML el mensaje falla en cuanto un valor contiene _, * o <: Telegram responde con un error 400.
07
Comprobaciones y errores frecuentes
Repasa la lista antes de empezar a depender de las notificaciones. Casi todo lo que falla aquí tiene una de dos causas: una URL de postback incompleta o un escenario apagado.
Lo que más se rompe
| Síntoma | Causa | Qué hacer |
|---|---|---|
| A Make solo llega event | Los demás macros faltan en la URL del postback, o sus interruptores están apagados | Añade los macros a la URL, guarda y pulsa Re-determine data structure |
| No llega ningún mensaje | El bot no puede escribir primero, el chat id es incorrecto o el escenario está apagado | Pulsa Start en el chat con el bot, revisa el chat id y enciende el escenario |
| Telegram responde con un error 400 | El texto está vacío, o Parse mode falla por un carácter dentro de los datos | Deja Parse mode vacío y activa el marcador para los valores vacíos |
| Al chat llegan todos los eventos | No hay filtro entre el webhook y Telegram | Añade un filtro por el valor de event en cada escenario |
| La campaña llega vacía | La URL del postback no lleva los macros {cid} y {ac} | Añade los dos y vuelve a determinar la estructura de datos |
| Los mensajes llegan dos veces | Hay dos postbacks o dos escenarios configurados para el mismo evento | Revisa qué postback tienes configurado en el panel y qué escenarios están activos en Make |
| Las notificaciones se cortaron a mitad de mes | Se agotaron las operaciones del plan | Deja notificaciones solo para los eventos con dinero: primer depósito, depósito repetido, comisión |
Para saber qué hacer después con estos eventos, mira la lección Analítica y crecimiento.