Integração com Google Sheets

Envie uma mensagem de WhatsApp automaticamente quando uma linha for adicionada a uma planilha do Google Sheets ou quando uma linha mudar. Cada linha vira uma mensagem, personalizada com os valores das colunas dela. Não é preciso nenhuma ferramenta de automação: os gatilhos rodam dentro do Wbiztool.

Antes de começar#

• Um plano pago. Todos os planos pagos incluem gatilhos do Google Sheets: Lite 1, Standard 3, Advanced 5 e Enterprise 10 (veja Preços). Depois que sua conta Google estiver conectada, a página do Google Sheets mostra quantos gatilhos você já usou do seu limite. Se o seu plano não tiver gatilhos, Conectar Conta Google mostra um aviso de upgrade; fale com o suporte se não tiver certeza de qual plano precisa.
• Um número de WhatsApp conectado nas configurações do WhatsApp.
• Você precisa ser proprietário ou editor do espaço de trabalho. Só o proprietário pode desconectar a conta Google.
• Uma planilha do Google Sheets cuja primeira linha contém os cabeçalhos das colunas, como Name, Phone e Order.

Conectar sua conta Google#

Acesse wbiztool.com/google-sheets/ e clique em Conectar Conta Google. A página não aparece no menu do painel, então use este link. Entre com o Google e permita o acesso. O Wbiztool pede acesso somente leitura às suas planilhas e acesso aos arquivos que você escolher, para poder saber quando eles mudam.

É possível conectar uma conta Google por espaço de trabalho. Desconectar (só o proprietário) remove a conexão e interrompe todos os gatilhos dela.

Criar um gatilho#

1. Selecione os recursos

   Escolha o WhatsApp Number (número do WhatsApp) que vai enviar, clique em Select Sheet (selecionar planilha) para escolher a sua Google Sheet (planilha) no Google Drive e depois escolha a Worksheet (aba). Cada aba pode ter um gatilho.

2. Escolha o evento do gatilho

   • New Spreadsheet Row (nova linha na planilha): envia uma mensagem para cada linha adicionada depois que você cria o gatilho.
   • New or Updated Spreadsheet Row (linha nova ou atualizada na planilha): também envia de novo quando uma linha que já foi processada muda.

3. Configure o gatilho

   Dê um Trigger Name (nome do gatilho) e escolha a Phone Number Column (coluna do número de telefone). Ative Enable Scheduling (ativar agendamento) se quiser que as mensagens sejam enviadas em uma data e hora tiradas da linha. Veja Agendamento.

4. Escreva a mensagem

   Escolha o Message Type (tipo de mensagem) e escreva o Message Template (modelo de mensagem), usando {{Column Name}} para inserir valores da linha. A Message Preview (prévia da mensagem) mostra o resultado.

5. Salve e teste

   Salve o gatilho. Use Testar no gatilho para ver a prévia da mensagem montada com a última linha da planilha e, se quiser, enviá-la. A mensagem de teste começa com [TEST] e exige que o cabeçalho de telefone corresponda exatamente ao nome da coluna.

As linhas que já estão na planilha quando você cria um gatilho New Spreadsheet Row são ignoradas. Só as linhas adicionadas depois são enviadas.

Modelos de mensagem#

Escreva os cabeçalhos das colunas entre chaves duplas, exatamente como aparecem na linha de cabeçalho, sem espaços dentro das chaves:

Hi {{Name}}, your order {{Order ID}} is ready for pickup.

Com uma linha em que Name é Aman e Order ID é 4821, a mensagem fica:

Hi Aman, your order 4821 is ready for pickup.

Os cabeçalhos diferenciam maiúsculas de minúsculas: {{name}} não corresponde a uma coluna chamada Name.

Tipos de mensagem#

Números de telefone#

• A Phone Number Column precisa conter números completos com código do país, como 919876543210. Nenhum código de país é adicionado automaticamente.
• Espaços, traços, parênteses, pontos e + são removidos. Números armazenados em notação científica, como 9.19877E+11, são convertidos em dígitos, mas os dígitos que a planilha já arredondou são perdidos.
• As linhas em que o telefone não tem de 6 a 15 dígitos são ignoradas. Linhas ignoradas não contam como erros no card do gatilho; por isso, se faltarem mensagens, confira os valores de telefone.
• Use um cabeçalho de telefone cujo nome não faça parte de nenhum outro cabeçalho (por exemplo, evite Phone ao lado de Alternate Phone). O Wbiztool usa a última coluna cujo cabeçalho contém o nome que você escolheu. O mesmo vale para as colunas de data e hora.

Agendamento#

Com Enable Scheduling ativado, escolha:

• Date Column (coluna de data): a data de envio. Formatos aceitos: YYYY-MM-DD, DD/MM/YYYY, MM/DD/YYYY e DD-MM-YYYY. Para datas como 03/04/2026, que se encaixam nos dois formatos, é usada a leitura com o mês primeiro (MM/DD/YYYY); por isso, prefira YYYY-MM-DD.
• Time Column (Optional) (coluna de hora, opcional): a hora no formato HH:MM ou HH:MM:SS (24 horas). Sem ela, a mensagem é agendada para a meia-noite do início dessa data; por isso, uma linha com a data de hoje e sem hora já está no passado e é ignorada.
• Default Timezone (fuso horário padrão): o fuso horário das datas e horas da sua planilha.

As linhas cuja data e hora já passaram são ignoradas. Sem agendamento, cada linha é enviada assim que o gatilho é executado.

Como e quando os gatilhos são executados#

O Google avisa o Wbiztool quando a planilha muda, e então o gatilho lê as colunas A a Z da aba e processa as linhas novas ou alteradas. As mensagens costumam sair pouco depois que a alteração é salva.

• Só as colunas de A a Z são lidas. Mantenha nelas a coluna de telefone e todas as colunas que você usa nos modelos.
• Se as mensagens do seu plano acabarem, o processamento para naquela linha. As linhas restantes são enviadas em uma alteração posterior da planilha, quando você tiver mensagens de novo.
• Pause, retome ou exclua um gatilho pelo card dele. O card mostra quantas vezes o gatilho foi executado e quantos erros teve.

Solução de problemas#