Ampliar o Google Workspace Studio

Os fluxos permitem que os usuários do Google Workspace automatizem tarefas em vários serviços combinando uma série de etapas sem escrever código. Ao estender os fluxos, você permite que os usuários acionem fluxos de trabalho a partir dos eventos do app e adicionem as funções dele como etapas.

Por exemplo, os usuários podem classificar e atribuir perguntas de clientes recebidas com um fluxo que faz o seguinte:

  1. Recebe um e-mail de um cliente.
  2. Pede para o Gemini classificar o e-mail.
  3. Cria uma tarefa para acompanhar a equipe de vendas ou de suporte.

Estes documentos explicam como estender a funcionalidade do Google Workspace Studio criando acionadores personalizados e etapas que os fluxos podem executar.

Para começar, confira o guia de início rápido, os codelabs e os guias para desenvolvedores em Primeiros passos.

Interface do Flows mostrando as etapas para receber e-mails de clientes, enviar comandos ao Gemini e criar tarefas de acompanhamento.
Figura 1: um usuário configura um fluxo que classifica as perguntas dos clientes com o Gemini.

Conceitos do Workspace Studio

Os termos e conceitos a seguir definem os principais componentes do Workspace Studio:

Fluxos

Os usuários criam

fluxos no Workspace Studio para automatizar tarefas no Google Workspace e em outros serviços. Os fluxos têm integração profunda com o sistema, reconhecimento contextual e podem usar a IA.

Etapa

Uma única etapa no processo automatizado de um fluxo. Essencialmente, é uma única tarefa em uma sequência de tarefas que seguem um evento inicial. Cada etapa é executada de forma síncrona, ou seja, ela conclui a operação antes que a próxima etapa da sequência comece. Os usuários definem a ordem das etapas, permitindo que personalizem o fluxo lógico de tarefas. As etapas podem ter, mas não exigem, entradas e saídas. Exemplos de etapas incluem "enviar um e-mail", "postar em um espaço do Chat" e "perguntar ao Gemini". As etapas podem incluir tarefas fora do Google Workspace, como criar um lead de CRM.

Acionador
O ponto de entrada do processo automatizado de um fluxo. Na interface, ele é apresentado aos usuários como um acionador, enquanto no esquema de manifesto e na API do Google Workspace Studio, ele é definido como um workflowTrigger. Enquanto uma etapa executa uma ação síncrona no meio de uma sequência, um acionador fica no início do fluxo e aguarda um evento (de apps do Google Workspace ou webhooks de terceiros). Depois de acionado, ele captura os detalhes do evento, gera as variáveis de dados iniciais e inicia a execução do fluxo.
Variável de entrada
As variáveis de entrada são recebidas por etapas. Elas são definidas pelo usuário no card de configuração de uma etapa enquanto o usuário a configura. Por exemplo, colete um endereço de e-mail, um horário ou um comando do Gemini.
Variável de saída
As variáveis de saída são retornadas por etapas e podem ser enviadas para outra etapa. Por exemplo, você usa uma variável de saída para transmitir um endereço de e-mail para outra etapa que o usa para especificar o destinatário de um e-mail.
Variável dinâmica
Uma variável cujos dados só podem ser determinados quando o usuário configura o fluxo. Por exemplo, o Google Formulários tem perguntas e respostas variadas. O número de perguntas e respostas (e o conteúdo delas) não pode ser determinado até que um formulário específico inicie um fluxo. As variáveis dinâmicas consideram esse caso.
Recurso personalizado
Uma estrutura de dados personalizada que você pode definir para agrupar várias variáveis. Por exemplo, para criar um lead de CRM, transmita um recurso personalizado que contenha um endereço de e-mail, endereço e nome.
Card

Elemento básico para interfaces do usuário em complementos. Os cards oferecem suporte a um layout definido, elementos da interface interativos, como botões, e rich media, como imagens. Os cards têm recursos especiais para criar fluxos:

  • IncludeVariables: uma propriedade que permite a inclusão de variáveis dinâmicas.
  • Type: define o tipo de dados que as variáveis de entrada esperam.
Registro de atividades
Descreve o que acontece quando um fluxo é executado. Por padrão, os registros de atividades incluem o nome do acionador ou da etapa definida estaticamente no manifesto. Você também pode fornecer registros de atividades personalizados.

Primeiros passos

Os fluxos são criados na plataforma de complementos do Google Workspace. Se você já tiver um complemento, poderá estender a funcionalidade dele para incluir fluxos atualizando o manifesto para conter uma seção específica do fluxo.

Se você estiver começando do zero, confira o guia de início rápido, os codelabs e os guias para desenvolvedores a seguir.

Guia de início rápido

Siga o guia de início rápido para criar e testar sua primeira etapa personalizada:

Teste o guia de início rápido

Codelabs

Para exemplos completos que implementam acionadores e etapas, confira estes codelabs:

Guias para desenvolvedores

Para continuar criando e personalizando os acionadores e etapas do fluxo, consulte os seguintes guias: