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.
Campos de todos los pasos
Sección titulada «Campos de todos los pasos»| 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.
Pasos de mensaje
Sección titulada «Pasos de mensaje»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. |
Destinatarios
Sección titulada «Destinatarios»| 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. |
Otros tipos de paso
Sección titulada «Otros tipos de paso»| 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). |
Hitos de una plantilla de campaña
Sección titulada «Hitos de una plantilla de campaña»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.
Relacionado
Sección titulada «Relacionado»- Programa un paso para los campos de programación tal como los muestra la app.
- Elige destinatarios y Cc para las formas de destinatario.
- Tokens para lo que va dentro de
messageyhtml. - For agents para las salidas legibles por máquina de este sitio.