Integração Zazos e Google Docs | Central de Ajuda da Zazos

Passo 1: Crie um documento de template

Seu documento deverá ser o exato modelo que será gerado através da automação. Escreva seu documento preenchendo-o com placeholders, escritos na sintaxe {{ variavel }}.

💡 Os placeholders são os locais no seu documento que serão preenchidos pelos dados que virão da automação da Zazos.

⚠️ O documento de template não pode ter uma formatação definida (.docx, por exemplo). Ele deve ser um documento nativo do google docs.

Passo 2: Crie um projeto no Google Apps Script com a biblioteca da Zazos

Clique em Extensões -> Apps Script, na barra superior do seu documento.

Uma nova aba será aberta, com o seguinte visual:

Agora, clique no símbolo de + em Bibliotecas e insira o seguinte código na modal que aparecerá para adicionar a biblioteca da Zazos no seu Script:

1HIg9oXOSoLz_u5012lw1D8hCl0SqJE3OHim6KX-UfNq3NRZ6VmMFSbCB

Clique em Pesquisar, e você verá que ele encontrará a biblioteca da Zazos. Certifique que a biblioteca está em sua Versão mais recente. Clique em Adicionar.

💡 Pra conferir que o seu Apps Script possui a biblioteca da Zazos importada, basta ver que na sua barra lateral esquerda surgiu o nome Zazos.

Agora que você já tem acesso à biblioteca da Zazos, basta copiar o seguinte código no editor:

function doPost(e) {
  return Zazos.createDocumentFromTemplate(e);
}

Salve o seu trabalho (clicando no disquete ou apertar Ctrl/Command + S)

Clique em Implantar -> Nova Implantação e depois clique no ícone de engrenagem -> App da Web.

Configure o seu App da Web com uma descrição que fizer sentido e garanta que selecionou Qualquer pessoa em "Quem pode acessar". Clique em Implantar.

💡 Para que a automação da Zazos ⚡️ consiga interagir e gerar documentos, é essencial que Quem pode acessar esteja configurado com o valor Qualquer pessoa

Será necessário autorizar acesso à biblioteca da Zazos para que gere documentos novos no seu workspace Google.

Clique em Autorizar acesso.

Pode ser que o Google mostre uma janela de atenção sobre acesso do projeto, por não ter sido verificado. Está tudo bem, clique em Avançado -> Ir para (meu projeto).

Conceda os acessos necessários para que o script possa rodar no seu ambiente.

Assim que finalizar, a seguinte janela de Implantação será mostrada. Isso quer dizer que seu script está funcionando já. Copie o valor da URL, que está destacado em azul. Esse valor será necessário para sua automação da Zazos.

💡 Este passo de configuração do script para gerar documentos a partir de templates do Google Docs só precisa ser feito uma vez. Quando configurado, não é preciso repeti-lo toda vez que quiser gerar um documento no seu workspace

Passo 3: Configure sua automação na Zazos para gerar o template

Na automação em que quer gerar o documento, adicione um passo de Chamada de API.

Configure os campos da sua automação da seguinte forma:

Método HTTP: Seletor de Opções -> POST
URL: Texto -> Insira o valor de URL que você copiou da implantação
Cabeçalho da requisição Chaves e valores
Corpo da requisição Chaves e valores

Para configurar o Cabeçalho da Requisição corretamente, faça o seguinte:

Adicione um par chave/valor com o seguinte:

Content-Type: Texto -> "application/json"

Para configurar o Corpo da Requisição corretamente, faça o seguinte:

Adicione um par chave/valor para cada um dos casos a seguir:

fileName: esse será o nome do arquivo que será gerado. Você pode setar um texto dinâmico aqui dependendo dos valores dos passos anteriores da sua automação ou do gatilho.
templateFileId: esse é o identificador do seu template no google docs. Ele se encontrar na URL, e deve ser inserido como Texto
folder: esse parâmetro identifica em qual pasta (ou em qual caminho de pastas) do Drive você quer salvar seu documento gerado. Por exemplo,
Documentos vai salvar seus documentos gerados em uma pasta 📂 Documentos, na raiz do seu Drive.
Zazos/Documentos/Gerados vai salvar seus documentos gerados, salvando na estrutura de pastas 📂 Zazos -> 📂 Documentos -> 📂 Gerados.
Não é preciso criar as pastas com antecedência, caso elas não existam serão criadas.

placeholders: daqui em diante, basta inserir os placeholders que você criou no seu template lá no começo, com os respectivos valores. Por exemplo, para {{ nome }} eu devo inserir a chave nome com o valor que desejo substituir, e daí por diante.
shareWithAnyoneWithLink: Se deseja compartilhar esse documento com pessoas externas e quer que elas tenham acesso diretamente pelo link compartilhado do documento insira o valor true no corpo da requisição. Caso contrário, não é necessária a inclusão desse parâmetro

💡 Não é aconselhado a utilização desse recurso em arquivos que são sigilosos, pois, por mais que seja praticamente impossível descobrir a URL do arquivo, ainda é possível que haja algum vazamento desses links, como enviar/disponibilizar sem querer esse link para outras pessoas.

Pronto, sua automação está pronta para ser disparada. Agora é só testar e ver seu documento novo sendo gerado e preenchido no seu workspace Google.