# Emails personalizados

Con esta función podrás personalizar los emails que envíamos a tus clientes de forma sencilla pero muy flexible.

{% hint style="info" %}
Debes considerar que puedes modificar el contenido bajo un diseño que nosotros disponemos, por lo que para casos más exigentes deberás contactarnos a <support@videsk.io>.
{% endhint %}

## Modo de uso

Puedes crear cuantas plantillas necesites, así como cuantos calendarios necesites. De esta manera, si necesitas una plantilla personalizada para cada calendario podrás gestionarlo sin problema.

Contamos con 6 tipos de plantillas de emails que son enviados a tus agentes y clientes.

* Confirmación de agendamiento con servicio `cliente`
* Confirmación de agendamiento con agente `cliente`
* Recordatorio de reunión `cliente`
* Cancelación de agendamiento `cliente y agente`
* Recordatorio de reunión `agente`
* Notificación de nuevo agendamiento `agente`

El modo de uso es bastante simple y consta de secciones del email que puedes personalizar y estos son:

* Asunto
* Nombre del remitente
* Título principal
* Párrafos

{% hint style="info" %}
Tu logotipo lo podrás definir a nivel de calendario, no a nivel de plantillas.
{% endhint %}

<img src="/files/ftSuLvrZZcqetD2RU8xA" alt="Wireframe de email" class="gitbook-drawing">

## Párrafos

Puedes añadir todos los párrafos que necesites, pero deberás considerar que entre párrafos existe un salto de línea.

{% hint style="info" %}
Existe un valor numérico que verás al lado izquierdo del campo de texto, el cual representa el orden de los párrafos, los cuales comienzan desde el número cero en adelante.

Si deseas invertir el orden los párrafos deberás cambiar el orden de los números.
{% endhint %}

## Variables por plantilla

Dependiendo de la plantilla a personalizar, contarás con variables que deberás usar para entregar información a tu cliente como enlace de acceso, reagendamiento, cancelación, nombre del calendario, fecha, etc.

Para hacer uso de variables debes utilizar la sintaxis `{{variable}}` , es decir, el nombre de las variables deben ir entre corchetes `{{abc}}`.

Considera que todas nuestra variables se escriben en inglés, **sin espacios o tildes**.

{% hint style="info" %}
El diseño para cada plantilla es el mismo, las variables disponibles pueden ser diferentes entre plantillas.
{% endhint %}

{% hint style="warning" %}
Las variables en negritas son indispensables, por lo que deberás añadirlas. De lo contrario tus clientes no podrán acceder a las videollamadas.
{% endhint %}

{% hint style="danger" %}
Por razones de seguridad y políticas de privacidad de los datos, no enviamos datos de los formularios por emails.
{% endhint %}

### Confirmación de agendamiento con servicio `cliente`

Esta plantilla se envía al cliente cuando tienes **activada** la opción de selección automática en el servicio. Podrás usar las siguientes variables disponibles:

| Variable                | Descripción                                                     |
| ----------------------- | --------------------------------------------------------------- |
| `{{email}}`             | Email del destinatario (cliente)                                |
| `{{meetingDuration}}`   | Duración de la reunión en minutos                               |
| `{{identityOfSubject}}` | Identidad del sujeto                                            |
| `{{serviceName}}`       | Nombre del calendario                                           |
| `{{startAtDate}}`       | Fecha de inicio de la reunión en formato "Miércoles 22-08-2022" |
| `{{startAtHour}}`       | Hora de inicio de la reunión en formato 24 horas "14:50"        |
| `{{scheduleAt}}`        | Fecha en la cual se agendó la reunión                           |
| `{{meetingTimezone}}`   | Zona horaria del cliente "America/New\_York"                    |
| **`{{joinUrl}}`**       | Enlace de acceso a videollamada                                 |
| **`{{rescheduleUrl}}`** | Enlace de reagendamiento                                        |
| **`{{cancelUrl}}`**     | Enlace de cancelación                                           |

### Confirmar de agendamiento con agente `cliente`

Esta plantilla se envía al cliente cuando tienes **desactivada** la opción de selección automática en el servicio. Podrás usar las siguientes variables disponibles:

| Variable                | Descripción                                                     |
| ----------------------- | --------------------------------------------------------------- |
| `{{email}}`             | Email del destinatario (cliente)                                |
| `{{meetingDuration}}`   | Duración de la reunión en minutos                               |
| `{{serviceName}}`       | Nombre del calendario                                           |
| `{{startAtDate}}`       | Fecha de inicio de la reunión en formato "Miércoles 22-08-2022" |
| `{{startAtHour}}`       | Hora de inicio de la reunión en formato 24 horas "14:50"        |
| `{{scheduleAt}}`        | Fecha en la cual se agendó la reunión                           |
| `{{meetingTimezone}}`   | Zona horaria del cliente "America/New\_York"                    |
| **`{{joinUrl}}`**       | Enlace de acceso a videollamada                                 |
| **`{{rescheduleUrl}}`** | Enlace de reagendamiento                                        |
| **`{{cancelUrl}}`**     | Enlace de cancelación                                           |

### Recordatorio de reunión `cliente`

Esta plantilla se envía al **cliente** si tienes activado los recordatorios. Podrás usar las siguientes variables disponibles:

| Variable                | Descripción                                                                  |
| ----------------------- | ---------------------------------------------------------------------------- |
| `{{email}}`             | Email del destinatario (cliente)                                             |
| `{{timeBefore}}`        | Tiempo restante antes de la reunión (número): "30"                           |
| `{{unit}}`              | Unidades del tiempo restante en español: "minutos", "horas", "semanas", etc. |
| `{{serviceName}}`       | Nombre del calendario                                                        |
| `{{startAtDate}}`       | Fecha de inicio de la reunión en formato "Miércoles 22-08-2022"              |
| `{{startAtHour}}`       | Hora de inicio de la reunión en formato 24 horas "14:50"                     |
| `{{meetingTimezone}}`   | Zona horaria del cliente "America/New\_York"                                 |
| `{{meetingDuration}}`   | Duración de la reunión en minutos                                            |
| `{{scheduleAt}}`        | Fecha en la cual se agendó la reunión                                        |
| **`{{joinUrl}}`**       | Enlace de acceso a videollamada                                              |
| **`{{rescheduleUrl}}`** | Enlace de reagendamiento                                                     |
| **`{{cancelUrl}}`**     | Enlace de cancelación                                                        |

### Cancelación de agendamiento `agente y cliente`

Esta plantilla se envía al cliente y agente cuando la **reunión se ha cancelado**, ya sea por el agente o cliente. Podrás usar las siguientes variables disponibles:

{% hint style="info" %}
Recuerda que enviaremos la plantilla al agente sólo si es un email válido.
{% endhint %}

| Variable               | Descripción                                                                                               |
| ---------------------- | --------------------------------------------------------------------------------------------------------- |
| `{{email}}`            | Email del destinatario (cliente)                                                                          |
| `{{serviceName}}`      | Nombre del calendario                                                                                     |
| `{{meetingDuration}}`  | Duración de la reunión en minutos                                                                         |
| `{{startAtDate}}`      | Fecha de inicio de la reunión en formato "Miércoles 22-08-2022"                                           |
| `{{startAtHour}}`      | Hora de inicio de la reunión en formato 24 horas "14:50"                                                  |
| `{{meetingTimezone}}`  | Zona horaria del cliente y agente "America/New\_York"                                                     |
| **`{{cancelReason}}`** | Descripción por la cual se canceló la reunión, la cual pudo haber sido ingresada por el cliente o agente. |
| `{{referrer}}`         | URL de sitio web desde donde originalmente se agendó la reunión: "<https://example.com/contact>"          |

### Recordatorio de reunión `agente`

Esta plantilla se envía al **agente** si tienes activado los recordatorios. Podrás usar las siguientes variables disponibles:

{% hint style="info" %}
Recuerda que enviaremos la plantilla al agente sólo si es un email válido.
{% endhint %}

| Variables             | Descripción                                                                  |
| --------------------- | ---------------------------------------------------------------------------- |
| `{{agentEmail}}`      | Email del agente                                                             |
| `{{name}}`            | Nombre del agente                                                            |
| `{{timeBefore}}`      | Tiempo restante antes de la reunión (número): "30"                           |
| `{{unit}}`            | Unidades del tiempo restante en español: "minutos", "horas", "semanas", etc. |
| `{{serviceName}}`     | Nombre del calendario                                                        |
| `{{startAtDate}}`     | Fecha de inicio de la reunión en formato "Miércoles 22-08-2022"              |
| `{{startAtHour}}`     | Hora de inicio de la reunión en formato 24 horas "14:50"                     |
| `{{meetingTimezone}}` | Zona horaria del agente "America/New\_York"                                  |
| `{{meetingDuration}}` | Duración de la reunión en minutos                                            |

### Notificación de nuevo agendamiento `agente`

Esta plantilla se envía al **agente** cuando se agenda una nueva reunión, ya sea asignada manualmente o por nuestros sistemas. Podrás usar las siguientes variables disponibles:

{% hint style="info" %}
Recuerda que enviaremos la plantilla al agente sólo si es un email válido.
{% endhint %}

| Variables             | Descripción                                                     |
| --------------------- | --------------------------------------------------------------- |
| `{{name}}`            | Nombre del agente                                               |
| `{{serviceName}}`     | Nombre del calendario                                           |
| `{{startAtDate}}`     | Fecha de inicio de la reunión en formato "Miércoles 22-08-2022" |
| `{{startAtHour}}`     | Hora de inicio de la reunión en formato 24 horas "14:50"        |
| `{{meetingDuration}}` | Duración de la reunión en minutos                               |

{% hint style="info" %}
Si tienes sugerencias de nuevas variables o datos que consideras necesarias a enviar puedes dejar tus [sugerencias de funciones aquí](https://feedback.videsk.io).
{% endhint %}

## Previsuazalización

Si durante el desarrollo de la plantilla requieres ir realizando pruebas de previsualización, te sugerimos los siguientes pasos:

1. Crea un calendario de prueba **oculto**
2. Asigna al menos 1 recordatorio de 5 minutos
3. Asigna las plantillas personalizadas
4. Genera un enlace directo a la agenda usando las [utilidades](https://app.videsk.io/account/utilities).
5. Agenda con un correo real para recibir la plantilla

{% hint style="warning" %}
Recuerda que no debes introducir etiquetas HTML como `body`, `html` o `head`. Esto romperá la estructura de la plantilla.
{% endhint %}

Para gestionar tus plantillas sugerimos el uso de [Parcel](https://parcel.io/) como plataforma de gestión de plantillas de emails.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.videsk.io/es-dashboard/calendario/emails-personalizados.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.