Tokens
Un token es una marca que Pyn sustituye cuando formatea un mensaje para un destinatario. Teclea @ en el editor para insertar uno; en un correo Raw HTML o en un Raw HTML Block escríbelo como una etiqueta Liquid, {{ principal.preferredName }}. Los tokens principal hablan del empleado inscrito, y los tokens recipient, de la persona que recibe el mensaje; en un mensaje al empleado ambos son la misma persona.
Cuando falta un valor, el token muestra su texto de respaldo, el que ves en las tablas de abajo, a menos que definas tu propio respaldo en el token. Los nombres, los departamentos y los puestos vienen del registro del empleado en Directory.
Tokens en el editor
Sección titulada «Tokens en el editor»| Token | Valor | Respaldo |
|---|---|---|
date.reference |
La fecha de referencia del enrollment | reference date |
principal.preferredName |
El nombre preferido; si no, la primera palabra del nombre para mostrar | Employee |
principal.firstName |
La primera palabra del nombre para mostrar (o del nombre legal) | Employee |
principal.preferredFullName |
El nombre preferido más el apellido del nombre para mostrar | Employee |
principal.legalName |
El nombre legal; si no, el nombre para mostrar | Employee |
principal.jobTitle |
El puesto | Job Title |
principal.department |
El departamento | department |
principal.location |
La ubicación | location |
principal.startDate |
La fecha de inicio | start date |
principal.startDate.dayAfter |
El día siguiente a la fecha de inicio | start date |
principal.startDate.nextBusinessDay |
El siguiente día laborable después de la fecha de inicio | start date |
principal.tenure |
Años completos desde la fecha de antigüedad (o la de inicio) en el momento del envío: “1 year”, “3 years” | tenure |
principal.birthday |
El cumpleaños como día y mes, por ejemplo “28 Jul” | Birthday |
principal.nextBirthday |
El siguiente cumpleaños en la fecha de referencia o después | next Birthday |
principal.nextAnniversary |
El siguiente aniversario de la fecha de inicio en la fecha de referencia o después | next Anniversary |
principal.managerName |
El nombre para mostrar del manager | Manager |
principal.managerPreferredName |
El nombre preferido del manager | Manager |
principal.managerEmail |
El correo de trabajo del manager | manager email |
principal.buddy.name |
El nombre para mostrar del buddy | Buddy |
principal.buddy.preferredName |
El nombre preferido del buddy | Buddy |
principal.buddy.preferredFullName |
El nombre preferido y el apellido del buddy | Buddy |
principal.buddy.email |
El correo de trabajo del buddy | buddy email |
principal.buddy.startDate.nextBusinessDay |
El día laborable siguiente a la fecha de inicio del buddy | start date |
principal.hrbp.name |
El nombre para mostrar del HR business partner | HRBP |
principal.hrbp.preferredName |
El nombre preferido del HR business partner | HRBP |
principal.hrbp.preferredFullName |
El nombre preferido y el apellido del HR business partner | HRBP |
principal.hrbp.email |
El correo de trabajo del HR business partner | HRBP email |
recipient.preferredName, recipient.firstName, recipient.preferredFullName, recipient.legalName |
Como arriba, para el destinatario | Employee |
recipient.department, recipient.location |
Como arriba, para el destinatario | department, location |
recipient.startDate |
La fecha de inicio del destinatario | start date |
recipient.birthday, recipient.nextBirthday, recipient.nextAnniversary |
Como arriba, para el destinatario | Birthday, next Birthday, next Anniversary |
recipient.surveyLink |
Un enlace guardado en el registro del destinatario; se muestra como enlace, o no se muestra nada |
El Subject de un correo ofrece un conjunto más reducido: el nombre preferido, el cumpleaños, el siguiente cumpleaños y el siguiente aniversario del principal y del destinatario. El Summary y la Description de un ticket de Jira ofrecen doce tokens principal: principal.department, principal.email, principal.employeeNumber, principal.jobTitle, principal.legalName, principal.location, principal.managerEmail, principal.managerName, principal.name, principal.preferredFullName, principal.preferredName y principal.startDate.
Tokens para Raw HTML
Sección titulada «Tokens para Raw HTML»Un correo Raw HTML o un Raw HTML Block resuelve todos los tokens de arriba por su nombre Liquid, y además estos:
| Token | Valor | Respaldo |
|---|---|---|
company.name |
El nombre de la empresa del workspace | company |
date.today |
La fecha de envío | today |
date.tomorrow |
El día siguiente a la fecha de envío | tomorrow |
principal.name, recipient.name |
El nombre para mostrar | Employee |
principal.email, recipient.email |
El correo de trabajo | email address |
principal.personalEmail, recipient.personalEmail |
El correo personal | personal email address |
principal.endDate, recipient.endDate |
La fecha de baja | end date |
principal.city, principal.country, recipient.city, recipient.country |
La ciudad y el país | city, country |
recipient.jobTitle |
El puesto del destinatario | Job Title |
recipient.tenure |
Los años desde la fecha de antigüedad (o la de inicio) del destinatario en el momento del envío, redondeados al año más cercano y mostrados como 1 year o N years |
tenure |
Un nombre Liquid que Pyn no conoce se deja en el correo tal como se escribió.
Tokens personalizados y de campos del empleado
Sección titulada «Tokens personalizados y de campos del empleado»custom.<column>: una columna de la hoja de cálculo de combinación de correspondencia con la que se inscribió a la persona, escrita en camel case (Start Locationpasa a sercustom.startLocation). Insértalo con Insert widget, Custom Token. Recurre al nombre de la columna; un Custom Token Block sin valor muestra tu respaldo, o nada. Consulta Inscribe desde una hoja de cálculo.- Tokens de campo del empleado: cualquier campo del registro del empleado, elegido con Insert token, Employee Field, aplicado al principal o al destinatario, con un respaldo opcional que escribes tú. Sin él, un valor ausente no muestra nada.
Formato
Sección titulada «Formato»- Las fechas se muestran en la configuración regional del destinatario como día de la semana, día, mes y año, por ejemplo “Thu, 22 Oct 2026”. Los cumpleaños se muestran como día y mes.
date.todayydate.tomorrowse toman de la hora programada de la entrega; en una vista previa sin hora de envío muestran su respaldo.- La antigüedad se redondea a años completos, así que para alguien con once meses aparece “1 year”.
- Un token dentro de un tramo en negrita o con color conserva ese formato.
Nombres que Pyn ya no rellena
Sección titulada «Nombres que Pyn ya no rellena»Los siguientes nombres de Pyn Classic se aceptan, pero no muestran nada: date.nextBusinessDay, todos los tokens manager.* (usa principal.managerName, principal.managerPreferredName y principal.managerEmail), principal.homeAddress, principal.employeeNumber, principal.employmentType, principal.mobilePhone, principal.brand, principal.buddy.jobTitle, principal.buddy.location, principal.buddy.startDate, principal.buddy.startDate.dayAfter, principal.returnsFromLeaveOn, los equivalentes recipient de todos ellos, y recipient.startDate.dayAfter y recipient.startDate.nextBusinessDay.
Relacionado
Sección titulada «Relacionado»- Da formato a un mensaje para insertar tokens, tokens personalizados y campos del empleado.
- Elige destinatarios y Cc para saber quién es el principal y quién el destinatario en cada paso.
- Inscribe desde una hoja de cálculo para las columnas de tokens personalizados.
- Mapeo de campos de HiBob para el campo de Bob que hay detrás de cada token cuando HiBob está conectado.