API de cuenta atrás para email: guía para desarrolladores
Integra cuentas atrás dinámicas en tu stack de email con una simple llamada a la API.
Crea tu cuenta atrás — gratis 10.000 impresiones gratis al mes · Sin marca de agua
- Sin SDK ni clave API
- Funciona en los principales clientes de correo
- Más de 900 Google Fonts
- 10.000 impresiones gratis al mes
¿Por qué usar una API de cuenta atrás?
Si creas campañas de email a gran escala, crear a mano una cuenta atrás para cada envío simplemente no funciona. Un enfoque basado en API te permite generar temporizadores de forma programática, insertarlos en plantillas y personalizar cada detalle — de los colores a las fuentes, pasando por el comportamiento al expirar — sin salir de tu código.
El enfoque de ClickTimer es de una sencillez elegante: construyes una URL con los parámetros que quieras y devuelve una cuenta atrás en GIF que se actualiza en tiempo real cada vez que el destinatario abre su email. Sin JavaScript, sin problemas de renderizado entre clientes de correo. Simplemente funciona — en Gmail, Outlook, Apple Mail, Yahoo y el resto de clientes principales.
Esta guía te explica todo lo que necesitas para integrar cuentas atrás en tu infraestructura de email, tanto si usas una plataforma de automatización de marketing como un sistema de email propio o un servicio de email transaccional como SendGrid.
Cómo funciona la API de ClickTimer
ClickTimer genera cuentas atrás como imágenes GIF animadas servidas mediante una URL. El temporizador se renderiza en el servidor y se recalcula en cada petición HTTP: cada vez que alguien abre un email, ve una cuenta atrás exacta y en tiempo real.
Insértalo como imagen
El patrón de integración es sencillo: construye una URL del temporizador con tus parámetros, insértala como etiqueta <img> en el HTML de tu email y listo. No hay SDK que instalar, ni webhook que configurar, ni token de autenticación que gestionar para la generación básica de temporizadores.
Crea URL de forma visual
Para los desarrolladores que necesitan gestionar temporizadores de forma programática — crearlos, actualizarlos o seguir su uso —, ClickTimer ofrece un panel y una interfaz de configuración en clicktimer.co/#config, donde puedes generar URL de temporizadores con un editor visual y luego usarlas en tu código.
Patrones de integración por plataforma
La gran ventaja de un sistema de temporizadores basado en URL es su compatibilidad universal. Así encaja en las arquitecturas de email más habituales:
| Tipo de plataforma | Método de integración | Ejemplo |
|---|---|---|
| ESP (Klaviyo, Mailchimp) | Pega la URL del temporizador en un bloque de imagen | Arrastra y suelta una imagen → pega la URL |
| Transaccional (SendGrid, SES) | Inserta <img> en la plantilla HTML | URL dinámica en una variable de la plantilla |
| Automatización de marketing (HubSpot) | Módulo HTML personalizado con la URL del temporizador | Plantilla HubL con fecha personalizada |
| Sistemas propios | Genera la URL en el servidor e insértala en el HTML | Un script Python/Node crea la URL para cada destinatario |
| WordPress / WooCommerce | Shortcode o bloque HTML en el plugin de email | Consulta nuestra guía de WordPress |
Cómo crear URL de temporizador dinámicas
Si tu equipo envía campañas personalizadas, te interesa construir las URL de los temporizadores de forma dinámica. Los parámetros clave son la fecha/hora objetivo, la zona horaria, el idioma de visualización, la fuente (elige entre más de 900 Google Fonts), los colores de los dígitos, las etiquetas y el fondo, y las dimensiones del temporizador.
Un patrón habitual es generar una URL de temporizador única por destinatario según su fecha límite concreta. Por ejemplo, una empresa SaaS que envía recordatorios de fin de prueba calcularía la fecha de fin de prueba de cada usuario y la codificaría en la URL del temporizador. El resultado: cada destinatario ve una cuenta atrás hasta su propia fecha límite, no una fecha genérica de campaña.
Esto es especialmente potente en combinación con plataformas como Klaviyo o HubSpot, donde puedes usar etiquetas de combinación o tokens de personalización para fijar dinámicamente la fecha de la cuenta atrás de cada destinatario.
Ejemplos de implementación en el servidor
Tanto si trabajas con Python, Node.js, PHP o cualquier otro lenguaje, la integración sigue el mismo patrón: construye una cadena de URL con tus parámetros e insértala en el HTML de tu email como fuente de imagen. No hay librería que instalar ni clave de API que gestionar: la propia URL es la API.
En campañas por lotes, puedes generar cientos de URL de temporizador únicas en un bucle, cada una con una fecha objetivo distinta, e insertarlas en tus plantillas antes del envío. Los servidores de ClickTimer se encargan de todo el renderizado de los GIF sobre la marcha.
Para los equipos que usan integraciones de Zapier, incluso se puede automatizar la creación de temporizadores dentro de flujos más amplios: activar temporizadores personalizados cuando un usuario se registra, abandona un carrito o alcanza un hito en tu producto.
Referencia rápida para desarrolladores
Datos clave para planificar tu integración:
- Formato: GIF animado — funciona en el 100 % de los clientes de correo
- Renderizado: En el servidor, recalculado en cada apertura del email
- Fuentes: Más de 900 Google Fonts disponibles
- Autenticación: No se necesita para generar temporizadores (basado en URL)
- Límites de uso: Pago por uso según las impresiones
- Plan gratuito: 10.000 impresiones/mes — sin marca de agua
- Precios: 0,23 €/10K (hasta 150K), 0,15 €/10K (hasta 1M), 0,06 €/10K (más de 1M)
Crea la URL de tu temporizador
Configúralo de forma visual y reutiliza la URL en tu código. 10.000 impresiones gratis al mes, sin tarjeta de crédito.
¿Ya tienes una cuenta?
Enviar email de prueba
Introduce tu email para recibir una vista previa de cómo se ve esta cuenta atrás en las campañas de email.
Gestión de errores y casos límite
Cuando termina la cuenta atrás
¿Qué pasa cuando una cuenta atrás llega a cero? Por defecto, ClickTimer muestra un estado estático «00:00:00». Puedes personalizar este comportamiento desde el panel de configuración: mostrar un mensaje personalizado u ocultar el temporizador por completo tras la expiración.
Zonas horarias
Para las zonas horarias, indica siempre la zona de forma explícita en la URL del temporizador en lugar de fiarte de los valores por defecto. Así garantizas la coherencia en toda tu base de destinatarios, sobre todo en campañas globales. ClickTimer admite todos los identificadores de zona horaria IANA estándar.
URL mal formadas
Si una URL de temporizador está mal formada o le faltan parámetros obligatorios, ClickTimer devuelve una imagen alternativa en lugar del icono de imagen rota, así que tus emails nunca se ven rotos, aunque haya un bug en tu lógica de construcción de URL.
Escalabilidad
La infraestructura de ClickTimer está pensada para envíos de gran volumen. Tanto si envías 1.000 como 10 millones de emails, cada temporizador se renderiza bajo demanda: no hay paso de pregeneración ni cola que gestionar por tu parte.
Para optimizar costes a gran escala, los precios escalonados de ClickTimer juegan a tu favor: cuantas más impresiones usas, menor es el coste por impresión. A partir de 1M de impresiones pagas solo 0,06 € por cada 10.000, bastante más barato que competidores como MailTimers (49 €/mes) o Deadline Funnel (49 $/mes), que cobran una suscripción fija sea cual sea tu volumen.
Los créditos son prepago y nunca caducan, así que puedes comprar en grandes cantidades durante una temporada de campañas intensa y usarlos a lo largo del año sin preocuparte por renovaciones mensuales ni cuotas de suscripción desperdiciadas.
Preguntas frecuentes
¿Necesito una clave de API para generar temporizadores?
No. ClickTimer genera los temporizadores a partir de una URL: construyes una URL con tus parámetros y la insertas directamente. No se necesita autenticación para crear un temporizador básico.
¿Puedo generar temporizadores dinámicos para cada destinatario?
Sí. Construye la URL del temporizador en el servidor con la fecha límite concreta de cada destinatario e inserta esa URL única en su email. Funciona para fines de prueba, recordatorios de citas o fechas límite de ofertas personalizadas.
¿Qué pasa cuando la cuenta atrás llega a cero?
Por defecto, el temporizador muestra un «00:00:00» estático. Puedes personalizar el comportamiento tras la expiración desde el panel de ClickTimer.
¿Hay un límite de peticiones de temporizador?
ClickTimer usa un modelo basado en impresiones: no hay límites de peticiones como tales, pero pagas por cada 10K impresiones. El plan gratuito incluye 10.000 impresiones sin marca de agua.
¿Qué clientes de correo admiten los temporizadores GIF?
Todos. El GIF es compatible con Gmail, Outlook, Apple Mail, Yahoo Mail y el resto de clientes de correo principales. Por eso ClickTimer usa el formato GIF en lugar de animaciones JavaScript o CSS.
Genera la URL de tu primer temporizador
Crea tu primera cuenta atrás en 30 segundos.