Integração com o Google Sheets

Um gatilho do Google Sheets envia sozinho uma mensagem de WhatsApp para cada linha adicionada a uma aba, como um novo lead, pedido ou reserva. A mensagem é preenchida com as colunas da linha e vai para o número da coluna de telefone dela. Não é preciso nenhuma outra ferramenta de automação.

Quem pode fazer isso: Proprietários e Editores, em um plano pago (Lite: 1 gatilho; Standard: 3; Advanced: 5; Enterprise: 10). Só os Proprietários podem desconectar a conta Google. Analistas não veem Google Sheets na barra lateral; ao abrir a página, eles veem "Só o proprietário ou um editor pode fazer isso" (veja Funções e permissões).

Abra Google Sheets em Integrações na barra lateral ou acesse /google-sheets/.

Você precisa de um número de WhatsApp conectado e de uma planilha do Google cuja linha 1 tenha os nomes das colunas, como WhatsApp, Name e Order, com uma linha por mensagem abaixo. Só as colunas de A a Z são lidas.

Conectar sua conta Google#

1. Clique em Conectar Google

   Na página Google Sheets, clique em Conectar Google.

   

2. Escolha a conta Google

   Entre com a conta Google dona da planilha.

3. Permita o acesso

   O Google pede que você permita ao WbizTool ver suas planilhas e os arquivos do Drive que você escolher com ele. Se aparecerem caixas de seleção, marque todas. Você volta para a página com "Conta Google conectada".

Cada espaço de trabalho conecta uma conta Google, e o WbizTool só lê as planilhas dela.

Criar um gatilho#

1. Clique em Novo gatilho

   O botão fica no canto superior direito da página.

2. Escolha a planilha

   Clique em Escolher uma planilha e escolha a planilha no Google Drive, que abre sobre a página. É escolher a planilha lá que permite ao WbizTool lê-la e saber das novas linhas, por isso não há campo para colar um link.

   

3. Escolha a aba e quando enviar

   Escolha a Aba da planilha e, em Enviar quando, Uma linha é adicionada ou Uma linha é adicionada ou alterada (veja Quais linhas são enviadas). Cada aba pode ter um gatilho.

4. Dê um nome e escolha o número e a coluna de telefone

   Digite um Nome do gatilho. Em Enviar de, escolha um número ou Qualquer número conectado. Confira a Coluna do número de telefone: uma coluna com um nome como WhatsApp é escolhida automaticamente; se não houver, uma como Telefone ou Celular; e, se também não houver, uma como Número ou Contato. Os nomes em inglês (Phone, Mobile, Number, Contact) e nos outros idiomas do painel também funcionam. Verifique se não é uma como Número do pedido.

5. Escreva a mensagem

   Digite a Mensagem, clicando no nome de uma coluna abaixo da caixa para inseri-lo, como {{Name}}. Pré-visualizar com a primeira linha mostra a mensagem preenchida com a linha 2. Para uma imagem ou um documento, veja Imagens e arquivos.

6. Agende (opcional)

   Para enviar cada linha em uma data de uma das colunas dela, marque Enviar em uma data da planilha (veja Enviar em uma data da planilha).

7. Crie o gatilho

   Clique em Criar gatilho. Você verá "Gatilho criado – as novas linhas são enviadas a partir de agora".

As novas linhas costumam ser enviadas em poucos minutos. Teste o gatilho para conferir a mensagem antes.

Quais linhas são enviadas#

• Adicione linhas no final, digitando, colando ou por um Formulário Google. Com Uma linha é adicionada, uma linha inserida mais acima não é enviada (em vez dela, a última linha é enviada de novo), e depois de excluir linhas, as novas só são enviadas quando a planilha fica maior do que antes.
• Preencha o telefone por último, ou cole linhas inteiras: uma linha é enviada na primeira verificação depois que a célula de telefone dela é preenchida, com as células que ela tiver nesse momento. Com Uma linha é adicionada, depois que uma linha abaixo dela tiver sido enviada, altere só as células de telefone (e de data) dela: se as outras células dela também mudarem, ela não é enviada.
• Com Uma linha é adicionada ou alterada, cada edição envia a linha de novo: uma célula preenchida, alterada ou apagada, mesmo em uma coluna que a mensagem não usa, como uma coluna Status que você atualiza à mão. Também não ordene a planilha nem insira ou exclua linhas: as linhas que mudam de lugar contam como alteradas. Adicionar uma coluna não reenvia nada; renomear uma coluna conta como alteração em cada linha que tiver um valor nela.
• Linhas sem um número de telefone válido são ignoradas e não contam como erros. Com Uma linha é adicionada, uma linha ignorada é lembrada por 7 dias (até 500 linhas por gatilho): corrija o número de telefone dela e ela é enviada na próxima verificação, mesmo que linhas abaixo dela tenham sido enviadas nesse meio-tempo. Ela é reconhecida pelas outras células, então não é enviada se elas também mudaram, se linhas foram inseridas ou excluídas acima dela ou se ela só tem um telefone e uma data. Linhas ignoradas antes de 13 de outubro de 2026 não são tentadas de novo.

Escrever a mensagem#

Escreva os nomes das colunas entre chaves duplas, exatamente como na linha 1: maiúsculas e espaços fazem diferença.

Oi, {{Nome}}! Obrigado pelo seu pedido {{Pedido}}!

Com Nome Thiago e Pedido 1069, a mensagem fica "Oi, Thiago! Obrigado pelo seu pedido 1069!". Os valores são inseridos como a planilha os mostra, como R$ 24,00; uma célula vazia deixa um espaço em branco (a pré-visualização mostra [Nome]). Um {{…}} que não é uma coluna é enviado como foi digitado, e a janela avisa: "Não são colunas desta aba, enviadas exatamente como digitadas: …". As mensagens podem ter até 3.000 caracteres.

Números de telefone#

• O ideal é com o código do país, como 919876543210 ou +91 98765 43210. Espaços, hifens, parênteses, pontos, + e um 00 inicial não importam.
• Um número sem ele, como 98765 43210 ou 09876543210, recebe o código do país do número que o envia ou, se não houver, o País para números sem código do país do espaço de trabalho. Um número que começa com 0 é ignorado quando nenhum país é conhecido.
• Linhas cujo telefone não tem de 7 a 15 dígitos são ignoradas, assim como números que o Excel arredondou, como 9.19877E+11. Formate a coluna de telefone como texto simples (Formatar → Número → Texto simples).

Imagens e arquivos#

Em Tipo de mensagem, escolha Imagem ou Arquivo e preencha Link da imagem ou do arquivo: um link público, ou uma coluna que contenha um, como {{Photo}} ou https://example.com/{{SKU}}.jpg. O Diretório de mídia fornece links para os seus arquivos. A mensagem vira a Legenda (opcional). Um arquivo recebe o nome do final do link, com .pdf acrescentado quando esse final não é um tipo de arquivo suportado.

Enviar em uma data da planilha#

Com Enviar em uma data da planilha marcado, escolha:

• Coluna de data: YYYY-MM-DD (o melhor), DD/MM/YYYY, MM/DD/YYYY, DD-MM-YYYY ou DD.MM.YYYY. Uma data que se encaixa em dois deles, como 03/04/2026, é lida conforme a localidade da sua planilha (Arquivo → Configurações → Localidade): com o mês primeiro para Estados Unidos e com o dia primeiro para a maioria das outras localidades.
• Coluna de hora: HH:MM ou HH:MM:SS, formato 24 horas. Com Nenhuma – usar só a data, uma linha fica marcada para as 00:00 da data dela, então uma linha com a data de hoje já passou.
• Fuso horário dessas datas: o fuso horário das datas da sua planilha. A lista tem UTC, nove fusos horários comuns e o do seu navegador, que vem selecionado no início.

As colunas de telefone, data e hora são encontradas pelo nome: a última coluna cujo nome contém o que você escolheu, sem diferenciar maiúsculas. Com Phone e Phone 2, escolher Phone lê Phone 2 se ela estiver mais à direita.

Linhas cuja data e hora já passaram são ignoradas. As outras esperam em Relatórios como Aguardando até o horário delas. Com Uma linha é adicionada, corrija a data em até 7 dias e a linha é enviada no novo horário (veja Quais linhas são enviadas).

Testar um gatilho#

1. Clique em Testar

   No cartão do gatilho, clique em Testar. Testar gatilho mostra a mensagem gerada a partir da última linha da planilha e o número para onde essa linha iria.

2. Digite seu próprio número

   Em Enviar o teste para, digite seu próprio número com o código do país. O teste só vai para ele, nunca para as pessoas da sua planilha.

3. Envie o teste

   Clique em Enviar teste. Você verá "Teste na fila para … – costuma ser enviado em até um minuto" ou, enquanto um horário de envio que inclua o Google Sheets o segurar, "… – será enviado quando começar seu horário de envio (…)". A mensagem começa com [TEST].

   

Um teste conta como uma mensagem, não é contado no cartão e funciona mesmo com o gatilho pausado. "Essa linha não tem um número válido na coluna …, então o gatilho a ignoraria." significa que o telefone dessa linha precisa ser corrigido (veja Números de telefone).

Verificar, editar, pausar ou excluir um gatilho#

Cada cartão mostra a planilha (com um link para ela) e a aba, um selo (Ativo, Pausado, Não é possível enviar ou Não está recebendo alterações), a regra, a mensagem e as contagens: verificações (vezes em que a planilha foi lida após uma alteração) e as mensagens enviadas, com falha (ou expiradas) e na fila. Abaixo aparecem "Última verificação: …" e qualquer problema, como "Último problema relatado (pode já estar resolvido): …".

O WbizTool não escreve nada na planilha: o status de cada mensagem e o motivo da falha ficam em Relatórios, e cada número novo é salvo em Contatos como Sheet Contact com o número.

• Editar altera o nome, Enviar de, a coluna de telefone, a mensagem e o tipo dela, ou o agendamento; clique em Salvar alterações. As novas linhas usam as alterações. A planilha, a aba e Enviar quando não podem ser alterados; para isso, crie um novo gatilho.
• Pausar para o gatilho ("Pausado – a planilha não é verificada e nenhuma linha é enviada."), e Retomar o inicia de novo. As linhas adicionadas nesse meio-tempo (e, com Uma linha é adicionada ou alterada, as linhas alteradas nesse meio-tempo) são enviadas na primeira alteração depois que você retomar. Para pulá-las, exclua o gatilho e crie-o de novo.
• Excluir: clique em Editar, depois em Excluir gatilho no canto inferior esquerdo, e confirme. O gatilho "para de enviar e libera a vaga dele no seu plano. As mensagens já na fila ainda são enviadas." Para impedir esse envio, cancele-as em Relatórios.

Quando as mensagens saem#

• Sem temporizador: quando o Google informa uma alteração na planilha (em qualquer aba), os gatilhos ativos dela leem a aba deles. Sem alteração, nada é lido.
• Número não conectado: as mensagens esperam até o número de Enviar de ser reconectado. Com Qualquer número conectado e nenhum número conectado, as linhas também não se perdem: elas são enviadas na primeira alteração depois que um número se conectar.
• Número removido: um gatilho que enviava por ele passa para Qualquer número conectado. As mensagens dele ainda em espera são canceladas junto com o número.
• Horário de envio: se um Proprietário marcou Google Sheets no Horário de envio, as mensagens criadas fora dele esperam, inclusive os testes.
• Sem mensagens (plano gratuito): o gatilho para na primeira linha que não consegue enviar ("Not enough credits: some rows were not sent. …"). Quando você tiver mensagens de novo, edite algo na planilha, como outra aba, para enviar o restante.
• Limite diário: uma linha acima do limite diário de uso justo do número (1.000 mensagens em 24 horas) aparece com falha em Relatórios com "Daily limit reached: …".
• Alertas: quando um gatilho deixa de receber alterações, perde a coluna de telefone ou falha 3 vezes seguidas, Proprietários e Editores recebem o email "Um gatilho do Google Sheets em … precisa de você", e também um alerta por WhatsApp se a chave WhatsApp deles estiver ligada. Os dois seguem Shopify e integrações em Notificações. Linhas adicionadas enquanto um gatilho estava parado não se perdem: quando ele volta a funcionar, elas são enviadas na próxima alteração da planilha.

Limites#

• O teste grátis e o plano gratuito não têm gatilhos. Gatilhos pausados contam; excluir um libera a vaga dele.
• No limite, Novo gatilho fica cinza ("O limite de gatilhos do seu plano foi atingido"): exclua um gatilho, ou um Proprietário pode mudar o plano.
• Se o seu plano mudar para um com menos gatilhos, os seus não são removidos nem pausados, mas você não pode adicionar novos.

Desconectar o Google#

Só os Proprietários veem Desconectar no cartão "Conectado como …". Confirme com Desconectar: "Todos os gatilhos são pausados e o Google para de enviar alterações. Se você conectar de novo mais tarde, seus gatilhos são mantidos, pausados – retome-os um por um."

• Até você conectar de novo, os gatilhos ficam ocultos, mas continuam contando no seu plano, então exclua antes os que não forem necessários.
• Para trocar de conta Google, desconecte e conecte a outra. Se ela não conseguir abrir as planilhas dos gatilhos, exclua-os e crie novos.
• O WbizTool continua nos apps conectados da sua conta Google até você removê-lo lá.

Solução de problemas#

Relacionados#

• Campanhas a partir de uma planilha
• Mensagens de modelo
• Relatórios e histórico de mensagens
• Diretório de mídia
• Configurações do espaço de trabalho, membros da equipe e funções
• Apps e integrações