Redactar borradores de mensajes

En un complemento de Google Workspace, puedes crear widgets que tengan acciones vinculadas. Puedes usar una acción para redactar borradores de correo electrónico nuevos y, de manera opcional, completarlos con la información ingresada en la IU del complemento o la información de un mensaje abierto. Por ejemplo, puedes tener un botón en la IU del mensaje del complemento que cree una respuesta al mensaje abierto actualmente prepropagado con información del complemento.

Cuando se activa una acción que compila mensajes, Gmail ejecuta una función de devolución de llamada para compilar y mostrar el borrador. Luego, Gmail muestra ese borrador en su IU en una ventana de redacción de correo electrónico estándar, que el usuario puede editar y enviar según sea necesario.

Cómo configurar una acción para crear un borrador de mensaje

Para configurar un widget que inicie una acción de compilación de borrador cuando se seleccione, debes hacer lo siguiente:

  1. Asegúrate de que tu manifiesto incluya el alcance action.compose:

    https://www.googleapis.com/auth/gmail.addons.current.action.compose

    En su lugar, puedes usar un permiso más permisivo, pero solo debes hacerlo si ese permiso es absolutamente necesario.

  2. Crea un objeto Action y asócialo con una función de devolución de llamada que definas.

  3. Llama a la función de controlador de widgets setComposeAction() del widget, proporciónale el objeto Action y especifica el ComposeEmailType.

  4. Implementa la función de devolución de llamada que ejecuta la acción de creación de borradores. A esta función se le pasa un objeto de evento como argumento. La función de devolución de llamada debe hacer lo siguiente:

    1. Crea un objeto GmailDraft.
    2. Compila un objeto ComposeActionResponse con la clase ComposeActionResponseBuilder y el objeto GmailDraft.
    3. Devuelve el ComposeActionResponse compilado.

Puedes completar previamente el objeto GmailDraft que creaste en la función de devolución de llamada con destinatarios, un asunto, un cuerpo de mensaje y archivos adjuntos. Para completar el borrador, los datos pueden provenir de cualquier fuente, pero, por lo general, provienen de la información proporcionada al complemento, la información del mensaje abierto o la información recopilada de un servicio de terceros. El objeto de evento que se pasa a la función de devolución de llamada contiene el ID del mensaje abierto y otra información del complemento que puedes usar para completar previamente el borrador.

Puedes crear el borrador como un mensaje independiente nuevo o como una respuesta a un mensaje existente. Esto se controla con la enumeración ComposeEmailType que se le asigna a setComposeAction(). Puedes crear borradores de respuestas como respuestas individuales o mensajes de “responder a todos”.

Borradores independientes

Un borrador independiente inicia una conversación nueva y no es una respuesta a ningún mensaje existente. Puedes crear un borrador independiente con una de las siguientes funciones del servicio de Gmail:

Borradores de respuestas

Un borrador de respuesta forma parte de una conversación de mensajes existente. Los borradores de respuestas son respuestas individuales que solo se envían al remitente de un mensaje o borradores de “Responder a todos” que se envían a todas las personas que recibieron ese mensaje. Puedes crear un borrador de respuesta con una de estas funciones del servicio de Gmail:

Ejemplo

En el siguiente fragmento de código, se muestra cómo asignar una acción que compila un borrador de respuesta a un botón.

  var composeAction = CardService.newAction()
      .setFunctionName('createReplyDraft');
  var composeButton = CardService.newTextButton()
      .setText('Compose Reply')
      .setComposeAction(
          composeAction,
          CardService.ComposedEmailType.REPLY_AS_DRAFT);

  // ...

  /**
   *  Creates a draft email (with an attachment and inline image)
   *  as a reply to an existing message.
   *  @param {Object} e An event object passed by the action.
   *  @return {ComposeActionResponse}
   */
  function createReplyDraft(e) {
    // Activate temporary Gmail scopes, in this case to allow
    // a reply to be drafted.
    var accessToken = e.gmail.accessToken;
    GmailApp.setCurrentMessageAccessToken(accessToken);

    // Creates a draft reply.
    var messageId = e.gmail.messageId;
    var message = GmailApp.getMessageById(messageId);
    var draft = message.createDraftReply('',
        {
            htmlBody: "Kitten! <img src='cid:kitten'/>",
            attachments: [
              UrlFetchApp.fetch('https://example.com/images/myDog.jpg')
                  .getBlob()
            ],
            inlineImages: {
              "kitten": UrlFetchApp.fetch('https://example.com/images/myKitten.jpg')
                           .getBlob()
            }
        }
    );

    // Return a built draft response. This causes Gmail to present a
    // compose window to the user, pre-filled with the content specified
    // above.
    return CardService.newComposeActionResponseBuilder()
        .setGmailDraft(draft).build();
  }