Nivel de programación: principiante
Duración: 10 minutos
Tipo de proyecto: Automatización con un menú personalizado
¿Prefieres aprender mediante videos?
El Canal para desarrolladores de Google Workspace ofrece videos sobre sugerencias, trucos y las funciones más recientes.
|
Objetivos
- Comprende lo que hace la solución.
- Comprender lo que hacen los servicios de Apps Script dentro de la solución
- Configura la secuencia de comandos.
- Ejecuta la secuencia de comandos.
Acerca de esta solución
Propaga automáticamente una plantilla de correo electrónico con datos de Hojas de cálculo de Google. Los correos electrónicos se envían desde tu cuenta de Gmail para que puedas responder las respuestas de los destinatarios.
Importante: Esta muestra de combinación de correo electrónico está sujeta a los límites de correo electrónico descritos en Cuotas para los servicios de Google.
Cómo funciona
Creas una plantilla de borrador de Gmail con marcadores de posición que corresponden a los datos de una hoja de cálculo de Hojas de cálculo. Cada encabezado de columna en una hoja representa una etiqueta de marcador de posición. La secuencia de comandos envía la información de cada marcador de posición de la hoja de cálculo a la ubicación de la etiqueta de marcador de posición correspondiente en tu borrador de correo electrónico.
Servicios de Apps Script
En esta solución, se usan los siguientes servicios:
- Servicio de Gmail: Obtiene, lee y envía el borrador de correo electrónico que deseas enviar a tus destinatarios.
- Si tu correo electrónico incluye caracteres Unicode, como emojis, usa el servicio de Correo electrónico en su lugar. Aprende a actualizar el código para incluir caracteres Unicode en tu correo electrónico.
- Servicio de hoja de cálculo: Completa los marcadores de posición de correo electrónico con la información personalizada de cada uno de los destinatarios.
Requisitos previos
Para usar esta muestra, necesitas los siguientes requisitos previos:
- Una Cuenta de Google (es posible que las cuentas de Google Workspace requieran la aprobación del administrador)
- Un navegador web con acceso a Internet
Configura la secuencia de comandos
Crea el proyecto de Apps Script
- Haz clic en el siguiente botón para crear una copia de la hoja de cálculo de muestra Combinación de correo electrónico de Gmail y Hojas de cálculo.
El proyecto de Apps Script de esta solución se adjunta a la hoja de cálculo.
Crear una copia - En la hoja de cálculo copiada, actualiza la columna Destinatarios con las direcciones de correo electrónico que deseas usar en la combinación de correo electrónico.
- (Opcional) Agrega, edita o quita columnas para personalizar los datos que deseas incluir en tu plantilla de correo electrónico.
Si cambias el nombre de las columnas Destinatario o Correo electrónico enviado, debes actualizar el código correspondiente en el proyecto de Apps Script. Puedes abrir el proyecto de Apps Script desde la hoja de cálculo haciendo clic en Extensiones > Apps Script.
Crea una plantilla de correo electrónico
- En tu cuenta de Gmail, crea un borrador de correo electrónico. Para incluir datos de la hoja de cálculo en tu correo electrónico, usa marcadores de posición que correspondan a los nombres de las columnas encerrados por llaves, como
{{First name}}
.- Si le das formato al texto del correo electrónico, también debes dar formato a los corchetes de los marcadores de posición.
- Los marcadores de posición distinguen mayúsculas de minúsculas y deben coincidir exactamente con los encabezados de las columnas.
- Copia el asunto del borrador de tu correo electrónico.
Ejecuta la secuencia de comandos:
- En la hoja de cálculo, haz clic en Combinación de correos electrónicos > Enviar correos electrónicos. Es posible que debas actualizar la página para que aparezca este menú personalizado.
Cuando se te solicite, autoriza la secuencia de comandos. Si la pantalla de consentimiento de OAuth muestra la advertencia Esta app no está verificada, selecciona Avanzado > Ir a {Nombre del proyecto} (no seguro).
Vuelve a hacer clic en Combinación de correo electrónico > Enviar correos electrónicos.
Pega el asunto de la plantilla de correo electrónico y haz clic en Aceptar.
Si aplicaste un filtro a la hoja, la secuencia de comandos seguirá enviando un correo electrónico a los participantes filtrados, pero no agregará la marca de tiempo.
Revisa el código
Para revisar el código de Apps Script de esta solución, haz clic en Ver código fuente a continuación:
Ver el código fuente
Code.gs
Modificaciones
Puedes editar la automatización de la combinación de correo electrónico tanto como quieras según tus necesidades. A continuación, se muestran algunos cambios opcionales que puedes realizar en el código fuente.
Cómo agregar parámetros de correo electrónico como Cco, Cc, ReplyTo o De
El código de muestra incluye una serie de parámetros adicionales, actualmente comentados, que te permiten controlar el nombre de la cuenta desde la que se envía el correo electrónico, responder a las direcciones de correo electrónico y las direcciones Cco y Cc.
Para activar los parámetros que desees agregar, quita las barras diagonales //
frente a cada una.
En el siguiente ejemplo, se muestra un extracto de la función sendEmails
que activa la mayoría de los parámetros de correo electrónico:
GmailApp.sendEmail(row[RECIPIENT_COL], msgObj.subject, msgObj.text, { htmlBody: msgObj.html, bcc: 'bcc@example.com', cc: 'cc@example.com', from: 'from.alias@example.com', name: 'name of the sender', replyTo: 'reply@example.com', // noReply: true, // if the email should be sent from a generic no-reply email address (not available to gmail.com users)
En el ejemplo anterior, el parámetro noReply
sigue marcado como comentario porque se establece el parámetro replyTo
.
Incluir caracteres Unicode en tus correos electrónicos
Si quieres incluir caracteres Unicode, como emojis, en tus correos electrónicos, debes actualizar el código para usar el servicio de Correo electrónico en lugar del servicio de Gmail.
En el código de muestra, actualiza la siguiente línea:
GmailApp.sendEmail(row[RECIPIENT_COL], msgObj.subject, msgObj.text, {
Reemplaza la línea por el siguiente código:
MailApp.sendEmail(row[RECIPIENT_COL], msgObj.subject, msgObj.text, {
Colaboradores
Martin Hawksey, líder de Tecnología y Diseño de Aprendizaje en Edinburgh Futures Institute, creó la muestra, blogger y experto en desarrolladores de Google.
- Encuentra a Martín en Twitter (@mhawksey).
- Lee las entradas de blog relacionadas con Google Apps Script de Martin.
- Mira el programa de YouTube de Martín, Totally Unscripted.
Google mantiene esta muestra con la ayuda de Expertos de Google Developers.