# Como usar o Google Sheets para envios

* [Como configurar uma planilha](#how-to-set-up-the-sheet)
* [Como ativar um script](#how-to-activate-the-script)
* [Como configurar o chatbot](#how-to-configure-the-chat-bot)
* [Como configurar um gatilho](#how-to-set-up-a-trigger)

## Como criar envios de e-mail com a ajuda do Google Sheets

Como funciona: o bot coleta novos endereços e os cola um por um na primeira coluna (A3:A na planilha "Sending"). O script do Google é executado quando o horário é definido ou quando você altera a planilha (dependendo do gatilho), ele cria um envio de e-mails com novos endereços e os move para a planilha "Log" com um carimbo de data/hora.

```
function SendMail() {

var ss = SpreadsheetApp.getActiveSpreadsheet()
var sheet = ss.getSheetByName("Sending")
var email = sheet.getRange("a3:a").getValues()
var subj = sheet.getRange("c2").getValue()
var body = sheet.getRange("d2").getValue()
var arr = []

MailApp.sendEmail(email, subj, body)
arr = [[new Date(), email]]

//escreve os endereços enviados no Log
ss.getSheetByName("Log").getRange(ss.getSheetByName("Log").getLastRow()+1, 1, 1, 2).setValues(arr)
//limpa a planilha Sending
sheet.getRange("a3:a").clearContent()
}
```

A configuração consiste em 4 partes: **configuração da planilha, ativação do script, configuração do bot de chat** e **configuração de um gatilho**

## Como configurar uma planilha

Crie uma cópia [da planilha com o código](https://docs.google.com/spreadsheets/d/1SJYyF1YRJ-BWflqy_8Ad9zvbJCO1Tv7nIItiBadmeIc/edit?usp=sharing): Arquivo -> Fazer uma cópia

![](https://lh4.googleusercontent.com/0znfipVFnBgjF0xaHim-CaAE2jpFerBN07E_eWb7w_6qg0-HKaL91a1GartyWuiNL-5IdyXEZ6eP9_hptfzLdas86wEnknas5lYRM155hbFBZvRjVMmhq3TPWH00hqNGpfTDHWTReIEVd9Y7JA)

Observe como aparece que os scripts também serão copiados - certifique-se de que eles sejam copiados ao duplicar a planilha. Pressione "Fazer uma cópia".

![](https://lh6.googleusercontent.com/WmeNROF_YPBTaR5YQ7pUu_YRO6sJ7VmZ9JUS3oOmpdDVDqFYJNV2sGPcSG8Vtya6jBe6ul9xTHU7z1YM0mK7PiKUMVrj4UqMpF7KmiDivpVEGAB1Q_Fsrq0UNap_sn30WUvt8eEJto-qEKFSMQ)

Na planilha "Sending", você altera apenas as colunas B2 e C2:

![Sobre a planilha: o bot cola os endereços na primeira coluna (A3:A na planilha "Sending"). Você precisa alterar apenas as colunas de assunto e mensagem, nada mais](https://lh3.googleusercontent.com/dL8NVFfqvpbXApcPNBN98na1DpwkRt5h30uPtLspmvGgSHenjO3GWyLjV1TYjyXrlcb0qkBeNDNu5qJVZP4kBko_o9bVZW9hHpyd93ZSkGGP1lHAQCkN4xTn1SivbYo0ILKCdSdll_OA98sdMQ)

Agora você precisa verificar o acesso à sua planilha; ela precisa estar disponível para edição por qualquer pessoa com o link, como na captura de tela abaixo.

![](https://lh4.googleusercontent.com/hUpiJdh33M7hKw-DG1jLic1N9vl6HSBnHet6TMKbATLsZG-CraY7-oI3hNKLKsCmlXXhP9QCfu5TdlN1F_odYBy1N0Eki9jebxEtPVowSBLMm61Ci2E5by80nQVg7dhrYWxV4Max2vCyvk9tcQ)

## Como ativar o script

Na sua planilha, Extensões -> Apps Script

![](https://lh4.googleusercontent.com/EQxeAihqUiXpWkR06psB0UY2ZqYGpkJ_Djk1GBlg9ASWZZ22m4QL48OBGiu8mBG7Y3SAruChb8xqzUjL2F2uWsEocOc0N5VEB9jgXdN39E8nKWpwIkBqFjk73iy1U7T5MWprgykr94wa9wHVtA)

Escolha **"SendMail"**

![](https://lh3.googleusercontent.com/CznVVRkKKT4vG95VASXmWbFrnnptM91Bkaz_8oTcQ6i6mBJ7o8zaQOnKjtDo5r-DuCcoAsB24cA7wWz0TpkOzcXrLBIcWQlgk0Q8QJwOmtvW7OcyXjlB1klYsat4PG12j9UuhjB2Kc_3wkDi6Q)

Pressione **"Executar"**

![](/files/fe43ed42d5658b5ad528b82755e26119cfd05c99)

Pressione **"Revisar permissões"**

![](https://lh5.googleusercontent.com/mkuOfM_1Q2ZOhrZV-y3wvdjSmiMIIVvG08hv15N9iWb5UkqKFUgOpvYFKFTNJdhn-6do7DyFTPDqwr4Zw9GlxvgaOdQp8ehiRCZKgumr9sDmhJsN-uD_saMsawV88YVm3fwe5nDEFvSdzVqxoQ)

Escolha a conta a partir da qual você deseja enviar o mailing.

![](https://lh4.googleusercontent.com/WMnh64nzsoFhNHlbTEOYeniFcXMd4UKOauXFxmTgOb_t4vHzyC_fb6bOl_WNxDRsDgYA9sggerakcy1_6SIZ_fG0PbKER8-cDR3swEngIaTcFD3aIfFVc-tkHUrl_qKHUVnWp7ooIiiNxjngLw)

Pressione **"Avançado"**

![](https://lh6.googleusercontent.com/KKVlceduQy1mvcFBb_Fzdkb9dAVCG4oBcxBkdSfBPV92_zkZGKn6sVpZfbrHVC8EQo3U_-7I1dGpkUzgYRCTrxvfg5Uu61ZJgcSVaEd5GJf2DSEEE2WMZmbB4l-ILT_ncPqeOvGbNlP-LQXcrA)

Pressione **"Ir para (o nome do script) (não seguro)"**

![](https://lh3.googleusercontent.com/d0h-SyYP_emJpadCb4je04Md04JCj4W7Y6Nnk34LpFY96Vu_G_E6aJ8rhq1N-fJAdu0fYgisCgJLAuvD-ZwSaL5NlC_9k0Sasq5OWLMWyohx2Fok2oJFSy278l-9iDVPL8aHpMj6uu2S388F8A)

Pressione **"Permitir"**

![](https://lh3.googleusercontent.com/ed24LwyVea_PNw09wUZNFWwC8Vlu7jt96z3hajRQz-rBR63Hjws473KrFhppSEMXdFJTHJ5dCfbz_UPl0lmdnZgiujvgOtDTgAGfNk9ajglJhTy8MvCJU71DGCo1TnlfkN_IPs7_kjLI2XswSA)

Agora você precisa se certificar de que o script foi ativado verificando o e-mail de alerta de segurança na sua conta

![](https://lh6.googleusercontent.com/CA0T1ucBr43qZm2mGtnNKXhQB7r6aAlLLD6dqZ60ADBGrH9ewKIENTx96ohZfPYlfL2rxSA9wOa_3off0NnimW3yUSiNVt34s1ko9TYfPEWhLxZBo-2GCYTo8ZfSrEikHbpkfkoQHMEeKfFPDA)

## Como configurar o chatbot

Vamos tomar como exemplo o esquema a seguir, composto por três blocos

![](https://lh3.googleusercontent.com/CZWqjtQ4jFIV44IYZGjF4K6HGaEBN2cdBFYGr1PbwoW-7_hq37l51n4aHFkH3pUZyAM5rrN9DoMxkZPxG26VYNqgGdmBmF9EChesJXIfcWtffqHskemFU5-kakeJcwzERMxxMsgVfFCIUrEx7A)

1\) O primeiro bloco verde **"Verificação da condição principal"** inicia o diálogo com o bot. Aqui digitamos a frase que o iniciará nas condições. Para garantir que as configurações sejam salvas nos blocos, não se esqueça de pressionar **"Salvar"** após adicionar.

![](https://lh6.googleusercontent.com/6ffv52weuudLlHsC1AXgyl48u4QXdyxSv2O0K6sfxPVBrOlYJkGVbsqQ6hGNRsk4VjNGWZn9dtdCPjOWXKbujTm8iR_N-JL1L8hO4WKfixQ_FAY3eiN6m0H_5WCN-Adc5OwJ0G8UtfimAPbbgg)

2\) Agora crie um bloco abaixo e edite a conexão. Abra a aba "Usuário insere dados" e cole o nome da variável (client\_mail, como no exemplo). Depois coloque uma expressão regular na condição para verificar o e-mail. Nesse ponto, é importante verificar a precisão dos dados inseridos, caso contrário o script vai travar bastante. Você pode usar uma das seguintes expressões:

^\[a-z0-9]\[a-z0-9\_.-]*@(\[a-z0-9]+.)*\[a-z0-9]\[a-z0-9-]+.(\[a-z]{2,6})$

^\[-\w.]+@(\[A-z0-9]\[-A-z0-9]+.)+\[A-z]{2,4}$

![](https://lh6.googleusercontent.com/50dUCHfRgUdqhue-PmZ5nCi5ndIWEnZdCOZijnq6e26HtTVcgzQRzLSoYsVOJ0CMKDmuYLWEpbA5J29GDD4oO4xJsQoC9brKIpv7j-udJ3qsX335tMrFjsLvRIbW9c99Rwc14GaIM0gTBeE_kw)

Mais sobre expressões regulares [aqui](https://docs.salebot.ai/variables/list-of-useful-regular-expressions)

3\) O próximo bloco é o que transfere os dados para a planilha. Configure tudo como está na captura de tela (a descrição dos campos está abaixo)

![](https://lh5.googleusercontent.com/zkwBa6IAlb8tbGQsyYyancfz-svS1jEZ_5IqOoW4hMqaupiEgFP7QboWH8t6C5a-efwgxdhOhMhi62LAG0leRyUsWBxFEOF5MVmouhAyPpxBTw7GH1ncpAjiz_tI7HMH834EAZvAD9UpPH55LA)

* Escolha o tipo de solicitação POST-json.
* Cole a URL da função na aba “URL request”.

  \_<https://store.salebot.ai/function/gsheets_&#x20>;
* Cole a seguinte linha na aba “JSON parameters” \
  \
  \&#xNAN;*{"id": "(seu parâmetro id)", "mapping":{"a":"#{client\_mail}"}, "list\_name": "Sending"}*\
  \
  Cole seu parâmetro id do link para sua planilha. Você pode encontrá-lo no link dela, depois de d/

![](https://lh5.googleusercontent.com/o6lwAhIQht-QCEaMmgKJigcS_YGkWcQ3lnyBL7ny0NTgcl160dBbwsu6lFuhjntkKxzElimLGXll5vhEv5ZlzqkQJ75A-TM9p_8Tr8cNVUCRTwQbp6f5UURrvAmzsxxrrJ3JkYDTfk0M100vjg)

## Como configurar um gatilho

Antes de criar um gatilho, verifique se o bot grava os dados na planilha e se a função funciona corretamente.

![](https://lh5.googleusercontent.com/of8l8zMhl_K_0TQu016FdRxrpqiynd7rSYtvDbURmpZw3Nl8fxA5tAdenyG-r1bNVHW7kZmZCnCwNin3-auJpSPKQIa6WvdPqmbQNsR0GzEmbHEGM18ZIGkscbggkkDVbnKH07NsuTrVF_wp-w)

Se tudo tiver corrido bem, abra Extensões -> Apps Script -> SendMail e depois Triggers no menu à esquerda.

![](https://lh4.googleusercontent.com/C8vlOIX_davRzXgp6aqzkwnmNSIutirJSrajGNdyg2fDtTVZrk2s6l3KUBgo3DX_AgMKCCS1DQixPM6Wt72aGF6Pr2ExuUfGE1m76-nQj0J1dOUOk8_xnCNpKGpN8aoz1EAjyD1c87WuCqQNrQ)

Crie um novo Trigger usando o botão no canto inferior direito da tela

![](https://lh6.googleusercontent.com/rZBUefTUe_7NH70qsa9xEW_jbYf0IAGMvUcstUzHEoaZSUTzr041wisei6UNxCxFB1y938qHjg2gBnFGEdqB1_OLvarMltZQbYZxKw1LJuEE-BzDElQ1PtBjYOSjofG-QE8Ml6G2QDz77mKjSA)

Configure-o como na captura de tela. Se estiver configurando por tempo, saiba que o intervalo precisa ser de pelo menos 30 minutos. Você pode escolher seus próprios valores, mas lembre-se de que existem certas [cotas](https://developers.google.com/apps-script/guides/services/quotas). Depois pressione **"Salvar"**.

![](https://lh5.googleusercontent.com/K6zGZeA95Cxg0ylq4ZpwOjBGwovnvpAIHbxutgTT0pwosoQD2e69VhvM87O-qVwykxjIPCslC4Ht2eFSdl2ecAg4WTJ1CqKCEGNBnlf9vPqGtG3tncEyguFmv1WYn7zWhTV5iynnNdzibw6zLA)

Agora há um gatilho na lista. A configuração está concluída!

![](https://lh6.googleusercontent.com/jyjPMqqLvPL0yUZcvNFWexSmaCXJ91JyWykbMylzqitwEBKNtmU2SUo0gU4SQwd5unJLAcuphVMvD61IVR79lFhOdULbuNsaJwOgxkMRVq45RmVitPSr70YAw2HNqebe6IalO1mbey4ebZN1ng)

#### Outros links úteis:

[Limites de envio do Gmail no Google Workspace](https://support.google.com/a/answer/166852?hl=en)

[Mais informações sobre o serviço Gmail](https://developers.google.com/apps-script/reference/gmail/)

[Cotas para os serviços do Google](https://developers.google.com/apps-script/guides/services/quotas)


---

# 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.mavibot.ai/doc/pt/recursos-especiais/como-usar-o-google-sheets-para-envios.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.