mailinapp
Documentation menu

Bloque de tarea

Trabajo o tarea escolar con una fecha límite: un título, instrucciones, un valor en puntos opcional, cualquier número de enlaces de recursos, y un control de envío. Es el bloque del estudio para convertir un correo en una tarea real en lugar de solo el anuncio de una.

Cómo funciona

La fecha límite se renderiza como una imagen de cuenta regresiva en vivo en el correo enviado, usando la misma técnica de GIF animado renderizado en el servidor que usa el propio bloque de cuenta regresiva. Ese endpoint realmente se comparte; el bloque de tarea no ejecuta su propio codificador de imágenes. Junto a ella hay una línea de texto simple "Vence en Xd Yh Zm" o "Vencido". Ese emparejamiento importa porque es lo que mantiene el plazo preciso, tanto si un cliente dado renderiza la imagen como si no. La línea de texto se calcula en el momento del envío a partir de la apertura del propio destinatario, así que se lee correctamente incluso en un cliente que no muestra ninguna imagen, mientras el GIF sigue contando para los clientes que sí lo hacen.

El envío tiene tres formas, elegidas por el campo Envío:

  • Marcar como hecho — una acción de valor fijo, así que recibe el mismo tratamiento de enlace primero que una opción de encuesta o una ficha de calificación: un <form> real dentro del correo que se envía al endpoint de interacciones (nivel cinético) junto a un enlace de alternativa simple hacia la página de confirmación alojada (/v/[token]/act), ambos envolviendo el mismo control "Marcar como hecho". Como el valor enviado nunca varía, la ruta de solo enlace de nivel 2 funciona bien aquí, a diferencia de los dos modos de abajo.
  • Respuesta de texto corto / Respuesta de enlace — estos llevan un valor de forma libre que ningún enlace GET simple puede precompletar, así que — al igual que la alternativa de formulario completo del bloque de cuestionario — la ruta de nivel 2 es un enlace hacia la propia vista en vivo alojada, donde un <input> real (de tipo text o type url respectivamente, con un marcador de posición adecuado) recolecta la respuesta y la envía. No hay escritura dentro del correo para estos dos modos en clientes que no pueden renderizar el formulario cinético; en su lugar, abren la vista en vivo.

Cualquiera sea el modo configurado, un envío llega como un evento de interacción normal y se deduplica por destinatario de la misma forma que un voto de encuesta — un clic repetido en el propio enlace del destinatario es un no-op, no un segundo envío. Si la fecha límite del bloque ya pasó cuando llega un envío, igual se registra, solo que marcado como tardío más adelante (mira el resumen de Libro de calificaciones abajo). El bloque de tarea nunca bloquea el registro de un envío tardío; solo lo marca.

En cualquier otro lugar (Outlook, o cualquier cliente que no respete ni el nivel cinético ni pueda renderizar la imagen de cuenta regresiva de forma significativa), la alternativa es simplemente la línea de texto de fecha límite estática más la lista de enlaces de recursos. Ambas siempre se renderizan sin importar el nivel, junto al control de envío que corresponda (ficha o enlace a la vista en vivo).

Campos configurables:

  • Título e Instrucciones, más sus propios colores y tamaños de fuente.
  • Vence en — una fecha/hora; la imagen de cuenta regresiva y el texto "Vence en…"/"Vencido" solo se renderizan cuando esto está definido.
  • Puntos — 0 significa sin calificar (la misma convención de "0 = sin definir" que usa el campo de inventario del bloque de producto); un valor distinto de cero agrega "(N pts)" junto al título.
  • Enlaces de recursos — cualquier número de pares de etiqueta/URL, renderizados como una lista simple de enlaces debajo de las instrucciones.
  • Envío — Marcar como hecho / Respuesta de texto corto / Respuesta de enlace, como arriba.
  • Color de fondo, relleno, borde, radio de borde, y una anulación de color de botón compartida para el control de envío.

Ejemplos

Subject

New assignment: Chapter 4 reading response

Un recordatorio semanal de tarea para un curso en línea combina naturalmente con Marcar como hecho — mira Educación para el patrón más amplio de gestionar tareas y recordatorios por correo. Una tarea de respuesta escrita ("resume el capítulo 3 en dos oraciones") usa Respuesta de texto corto para que la propia respuesta llegue al Libro de calificaciones en lugar de requerir un portal de envío separado. Una tarea basada en proyecto ("envía el enlace de tu documento compartido") usa Respuesta de enlace, con Enlaces de recursos apuntando a la rúbrica y cualquier material de referencia. Define una fecha límite real para que la cuenta regresiva le dé a los estudiantes una sensación genuina de urgencia a medida que se acerca.

Cómo se ve la alternativa estática

<div style="margin:12px 0;background-color:transparent">
  <p style="margin:0 0 4px;font-weight:700;font-size:18px;color:#111827">
    Chapter 3 reading response (10 pts)
  </p>
  <p style="margin:0 0 6px;font-size:13px;font-weight:600;color:#111827">
    Due in 2d 4h 30m
  </p>
  <img src="https://mailinapp.com/api/countdown?t=1737936000000&c=111827&s=..."
       width="220" height="40" alt="Due in 2d 4h 30m"
       style="display:block;max-width:100%;height:auto;margin-bottom:8px" />
  <div style="text-align:center;margin-top:8px">
    <a href="https://mailinapp.com/v/eyJhbGci..."
       style="display:inline-block;padding:10px 20px;background-color:#4f46e5;
              color:#ffffff;border-radius:6px;text-decoration:none;
              font-size:14px;font-weight:600">
      Submit answer
    </a>
  </div>
</div>

Esto muestra la alternativa del modo Respuesta de texto corto: como la respuesta no se puede precompletar en un enlace simple, la alternativa es un enlace hacia la vista en vivo alojada en lugar de una página de confirmación /act.

Relacionado