Ir al contenido
PynPyn

Opciones de un paso

Las tablas nombran cada campo que lleva un paso tal como lo etiqueta la app, con el valor que contiene. Esa misma forma es la que usan las herramientas MCP y las exportaciones, así que es la referencia para quien automatice Pyn.

Campo Etiqueta en la app Valores
id Un id único que asigna Pyn.
title Step title Texto libre; vacío muestra el tipo de paso.
type Se elige en Add Step send-message, send-channel-message, invite-to-calendar-event, send-channel-invite, raise-ticket, add-message-to-context; consulta más abajo.
state Enabled / Disabled enabled o disabled. Un paso deshabilitado nunca se envía.
schedule.type relative o elapsed (After trigger) en una automation, absolute en una campaña.
schedule.offset Schedule Para relative: una duración como { "days": -7 } o { "weeks": 2 }; un valor negativo es antes de la fecha de referencia. Para elapsed: una duración positiva después del momento del trigger en minutes, hours, days o weeks, como { "hours": 1 }; {} es Immediately.
schedule.date Scheduled date Para absolute: una fecha de calendario, 2026-03-02.
schedule.hour, schedule.minute at De 0 a 23 y de 0 a 59.
schedule.timezone in recipient, o el nombre de una zona horaria como Australia/Sydney.
schedule.deliverOn Days of Week Uno o varios de MONDAY a SUNDAY.
schedule.onSkippableDate On Non-Delivery Days deliver-anyway, deliver-before (el día de entrega anterior) o deliver-after (el día de entrega siguiente).
audience Pestaña Audience lifecycle (cualquiera de current, joiner, leave, terminated), includeGroups, excludeGroups (ids de grupo). Si falta, solo empleados actuales.
skipIfOverdue Skip if overdue at enrollment true para omitir un paso cuya fecha ya pasó cuando alguien se inscribe.
reminders Reminders Hasta tres en el panel lateral del paso (Add reminder desaparece al llegar a tres), cada uno con offset (días después del envío), enabled y un message opcional que el panel lateral no establece. Un paso escrito a través de la API o de un servidor MCP puede llevar hasta diez.

schedule.hour, schedule.minute, schedule.timezone, schedule.deliverOn y schedule.onSkippableDate solo existen en una programación relative o absolute. Una programación elapsed lleva únicamente type y offset, y un paso de campaña no puede usarla.

send-message (un mensaje directo o un correo) y send-channel-message (una publicación en un canal) añaden:

Campo Etiqueta Valores
medium Fijado por el tipo de paso slack o email.
sender From El id de un sender. Si falta, el predeterminado del workspace.
conditionalSender From El id de un sender condicional. Un paso tiene sender o conditionalSender, nunca ambos.
recipient To Un destinatario, consulta más abajo. El destinatario de una publicación en un canal es un canal.
ccRecipients Cc Destinatarios, en cualquier número, tras el enlace Cc junto a To en el panel lateral del paso.
subject Subject Un documento de una sola línea. En un correo es el asunto; en un mensaje directo de Slack es el asunto del correo que se envía cuando fallbackToEmail está definido.
message El editor El mensaje redactado.
body, html Email body body: "html" con el HTML Liquid en html para un correo Raw HTML; si no, el message redactado es el cuerpo. Solo en correos.
emailFormat Email format left o full-width; si falta, significa Centered. Da formato solo a un correo compuesto; un correo Raw HTML se envía tal como está escrito.
hideSignature Include the sender’s signature (verified email senders) true cuando el interruptor está desmarcado; si falta, significa que la firma de un sender de correo verificado cierra el correo. Solo en correos compuestos.
deactivateUnfurlLinks, deactivateUnfurlMedia Advanced true para desactivar las vistas previas de Slack.
fallbackToEmail, fallbackEmailSender Send by email if the recipient is not in Slack, y el From que hay debajo true, con el id de un sender de correo, en un mensaje directo de Slack: a un destinatario que no está en Slack se le envía el mensaje por correo desde ese sender, con el subject del paso. Una automation no se puede publicar mientras fallbackToEmail esté definido sin un sender y un asunto. Consulta Envía un mensaje directo por correo cuando alguien no está en Slack.
escalations Escalations Hasta tres, cada una con offset (días después del envío), recipient (cualquier destinatario salvo un grupo o un destinatario condicional) y enabled.
Forma Etiqueta Campos
Relativo Employee, Manager, Skip-level Manager, Buddy, HRBP type: "relative", recipient uno de employee, manager, skip-manager, buddy, hrbp; address opcional, primary o personal.
Una persona People type: "employee", recipient el id del empleado, address opcional.
Un grupo Groups (pasos de campaña) type: "group", recipient el id del grupo. Todos los miembros reciben el paso.
Un canal Channels type: "channel", recipient el id del canal.
Una dirección de correo personalizada Custom Email Recipients type: "custom-email", recipient el id del destinatario de correo personalizado.
Un destinatario condicional Conditional Recipients type: "conditional", recipient el id del destinatario condicional. Se resuelve para cada empleado inscrito a partir de sus reglas; se rechaza en pasos de campaña.
Tipo Etiqueta en Add Step Campos adicionales
invite-to-calendar-event Invite to Calendar Event recipient (Employee por defecto; el panel lateral no tiene control para cambiarlo); eventId (el evento de calendario); inviteTo con next-occurrence, next-occurrence-reference-date o all-occurrences.
send-channel-invite Add to Channel sender; recipient (a quién se añade); channel (el id del canal); medium: "slack".
raise-ticket Raise Ticket integration (la conexión con Jira), project, issueType, summary (una sola línea), description; medium: "jira". Sin destinatario.
add-message-to-context Add Message to Employee Context y las demás filas de AI & Context recipient (de quién es el contexto).

Una plantilla de campaña es una lista de hitos, cada uno con id, title, emoji, color (un color hexadecimal), date (una fecha de calendario) y steps (pasos como los de arriba, con programaciones absolutas). Inscribir un hito lo convierte en una campaña con esa fecha como fecha de referencia. Consulta Campaign Templates.