Integrar o Google Sheets com a API do WhatsApp permite enviar mensagens automáticas para contatos listados em uma planilha, como lembretes, confirmações ou alertas.
Muitas empresas usam essa automação para ganhar tempo e padronizar a comunicação.
Ou seja, a ideia é simples:
- Você tem uma planilha com nome, telefone e mensagem;
- Um script do Google Apps Script lê os dados;
- Esse script faz chamadas para uma API de WhatsApp, que você precisa configurar;
- As mensagens são enviadas para os contatos automaticamente.
Vamos entender na prática!
Estruturando a Planilha no Google Sheets
Observe que, temos uma planilha no Google Sheets contendo o nome do cliente, seu telefone, data, horário, serviço e a mensagem que será enviada automaticamente via WhatsApp:
No caso, é importante lembrar que o número deve estar com código do país (Brasil = 55) + DDD + número, conforme os exemplos acima.
Além disso, criamos uma fórmula no Google Sheets que gera automaticamente uma mensagem modelo com base nos dados de nome, horário do agendamento e serviço preenchidos para cada cliente.
=”Olá ” & A2 & “! Confirmamos seu agendamento para ” & TEXTO(C2;”dd/mm”) & ” às ” & TEXTO(D2;”hh:mm”) & ” para o serviço de ” & E2 & “. Qualquer dúvida, estamos à disposição!”
Google Sheets via API do WhatsApp
Contudo, você precisa configurar um script no Google Apps Script que leia os dados da planilha e envie as mensagens automaticamente aos clientes, usando os parâmetros fornecidos pela API do WhatsApp.
Então, acesse o API e crie uma conta:
Após o login, clique em Instâncias Web e Adicionar:
Posteriormente, nomeie sua Instância e vá em Salvar no final da tela:
Por fim, você terá o ID da Instância e o Token:
Neste exemplo, utilizei a API da Z-API, mas você pode escolher a ferramenta de sua preferência, pois, o importante é que ela forneça o ID da instância e o token de integração, que são essenciais para a conexão com o Google Sheets.
Criando o Script de Envio no Google Sheets
Sendo assim, agora que você já tem sua planilha estruturada e recebeu o ID da instância e o Token da API, vamos configurar o envio automático das mensagens.
Volte ao Google Sheets, acesse os campos de Extensões e Apps Script:
Assim que uma nova página é aberta, apague qualquer código que estiver ali e cole o código abaixo:
function enviarWhatsApp() {
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(“Página1”); // ou o nome da sua aba
const data = sheet.getDataRange().getValues();
const instancia = “SEU_ID_DA_INSTANCIA”; // exemplo: abc123
const token = “SEU_TOKEN”; // exemplo: 789xyz456
const apiUrl = `https://api.z-api.io/instances/${instancia}/token/${token}/send-messages`;
for (let i = 1; i < data.length; i++) {
const nome = data[i][0];
const telefone = data[i][1];
const mensagem = data[i][5]; // coluna onde está a mensagem gerada
const payload = {
phone: telefone.toString(),
message: mensagem
};
const options = {
method: “post”,
contentType: “application/json”,
payload: JSON.stringify(payload)
};
UrlFetchApp.fetch(apiUrl, options);
Logger.log(`Mensagem enviada para ${nome}`);
}
}
Lembre-se é necessário substituir os valores de SEU_ID_DA_INSTANCIA e SEU_TOKEN pelas informações da API que você recebeu e ainda, certifique-se de que o nome da aba (Página1) está correto e que as colunas da planilha estão na mesma ordem.
Após, salvar o script no item acima, clique no menu Executar e localize o script de enviarWhatsApp:
Após autorizar as permissões da sua conta Google, execute novamente o script.
Assim, as mensagens começarão a ser enviadas automaticamente conforme os dados da planilha.
Lembrando que, você pode acompanhar o envio acessando o item Execuções do menu ao lado, para ver se tudo ocorreu bem.
Portanto, com as dicas acima, você será capaz de enviar mensagens automaticamente no WhatsApp com os recursos do Google Sheets.
Curso de Excel Completo: Do Básico ao Avançado.
Quer aprender Excel do Básico ao Avançado, passando por Dashboards? Clique na imagem abaixo e saiba mais sobre este Curso de Excel Completo.
Por fim, deixe seu comentário sobre se gostou deste post tutorial e se você irá usar essas técnicas em suas planilhas de Excel. E você também pode enviar a sua sugestão para os próximos posts. Até breve!
