Ir al contenido
PynPyn

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.

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.

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 Location pasa a ser custom.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.
  • 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.today y date.tomorrow se 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.

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.