---
title: "Tokens"
description: "Cada token que puedes poner en un mensaje, con qué lo rellena Pyn, el texto al que recurre cuando falta el valor, y cómo se formatean las fechas y los nombres."
sidebar:
  order: 3
area: flows
feature: steps
appPath: /flows/home
lastVerified: 2026-11-15
version: "2026-10-23"
audience: admin
related:
  - flows/steps/format-a-message
  - flows/steps/choose-recipients-and-cc
  - flows/automations/enroll-from-a-spreadsheet
  - integrations/hibob/field-mapping
intercom:
  - id: "6024180"
    title: List of supported tokens
    url: https://intercom.help/pyn/en/articles/6024180-list-of-supported-tokens
    note: Pyn 1 article
  - id: "6010962"
    title: Add personalization tokens
    url: https://intercom.help/pyn/en/articles/6010962-add-personalization-tokens
    note: Pyn 1 article
  - id: "6005713"
    title: Personalize your content using tokens and custom senders
    url: https://intercom.help/pyn/en/articles/6005713-personalize-your-content-using-tokens-and-custom-senders
    note: Pyn 1 article
  - id: "6023197"
    title: Personalize your Buddy Pyns with Tokens
    url: https://intercom.help/pyn/en/articles/6023197-personalize-your-buddy-pyns-with-tokens
    note: Pyn 1 article
translation:
  source: flows/steps/reference-tokens.mdx
  sourceSha: e10e1379be5cfe5ae62f7a0ec7a37e8c261fc545
---

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](https://support.pyn.ai/es/directory/employees/).

## 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

Un correo Raw HTML o un [Raw HTML Block](https://support.pyn.ai/es/flows/steps/format-a-message/#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

- `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](https://support.pyn.ai/es/flows/automations/enroll-from-a-spreadsheet/).
- 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

- 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.

## 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

- [Da formato a un mensaje](https://support.pyn.ai/es/flows/steps/format-a-message/) para insertar tokens, tokens personalizados y campos del empleado.
- [Elige destinatarios y Cc](https://support.pyn.ai/es/flows/steps/choose-recipients-and-cc/) para saber quién es el principal y quién el destinatario en cada paso.
- [Inscribe desde una hoja de cálculo](https://support.pyn.ai/es/flows/automations/enroll-from-a-spreadsheet/) para las columnas de tokens personalizados.
- [Mapeo de campos de HiBob](https://support.pyn.ai/es/integrations/hibob/field-mapping/) para el campo de Bob que hay detrás de cada token cuando HiBob está conectado.
