Automação de agenda
Integrar WhatsApp com Google Calendar
Essa integração conecta os eventos da sua agenda do Google Calendar ao WhatsApp através da ZapZap API, uma API de WhatsApp não oficial baseada em instâncias. A cada evento que se aproxima, um script lê a agenda e dispara uma mensagem automática de lembrete para o número certo, sem você precisar abrir o WhatsApp. A ZapZap API roda sobre instâncias próprias, com autenticação por x-api-key e x-api-secret, e cobra R$15 por número ativo por mês no modelo pré-pago, com crédito grátis para você testar antes de escalar.
Por que conectar
Uma clínica de estética marca todos os atendimentos no Google Calendar. Um dia antes de cada horário, um script no Google Apps Script varre os eventos do dia seguinte, extrai o telefone do cliente que está na descrição do evento e envia pelo WhatsApp um lembrete personalizado com data, horário e endereço. O resultado é menos faltas, menos remarcações de última hora e uma agenda que se comunica sozinha com o cliente, tudo partindo da mesma agenda que a recepção já usa no dia a dia.
Passo a passo
- 1
Crie sua instância na ZapZap API
Acesse o painel em app.zapzapapi.com, crie um número ativo e conecte lendo o QR Code no WhatsApp. No menu da instância, copie sua x-api-key e x-api-secret, que serão usadas para autenticar as chamadas.
- 2
Abra o Google Apps Script vinculado à agenda
Vá em script.google.com, clique em Novo projeto. Esse ambiente tem acesso nativo ao serviço CalendarApp, que lê os eventos da sua conta Google Calendar sem precisar de credenciais extras.
- 3
Escreva o script que lê os eventos e chama a API
No editor, use CalendarApp.getDefaultCalendar().getEventsForDay(data) para buscar os compromissos e UrlFetchApp.fetch() para enviar cada lembrete pela ZapZap API. Coloque o telefone do cliente na descrição de cada evento para o script conseguir extrair o número.
- 4
Crie um acionador por tempo
No menu lateral do Apps Script, clique em Acionadores (o ícone de relógio), depois em Adicionar acionador. Escolha a função do envio, tipo de evento Baseado em tempo e defina um acionador diário no horário desejado, por exemplo às 8h para avisar sobre os compromissos do dia.
- 5
Autorize e teste
Clique em Executar uma vez, aceite as permissões de acesso ao Google Calendar e à internet externa. Confira se o lembrete chegou no WhatsApp de teste e ajuste o texto da mensagem antes de deixar rodando em produção.
Exemplo
// Exemplo ILUSTRATIVO no Google Apps Script.
// Confira os endpoints e campos reais em https://api.zapzapapi.com/llms.txt
function enviarLembretes() {
const amanha = new Date();
amanha.setDate(amanha.getDate() + 1);
const eventos = CalendarApp.getDefaultCalendar().getEventsForDay(amanha);
const instanceId = 'SUA_INSTANCE_ID';
eventos.forEach(function (evento) {
// Telefone salvo na descrição do evento
const numero = evento.getDescription().trim();
const hora = Utilities.formatDate(evento.getStartTime(), 'America/Sao_Paulo', 'HH:mm');
const texto = 'Lembrete: voce tem ' + evento.getTitle() + ' amanha as ' + hora + '.';
UrlFetchApp.fetch('https://api.zapzapapi.com/api/v1/' + instanceId + '/send/text', {
method: 'post',
contentType: 'application/json',
headers: {
'x-api-key': 'SUA_API_KEY',
'x-api-secret': 'SEU_API_SECRET'
},
payload: JSON.stringify({
number: numero,
text: texto
})
});
});
}Ilustrativo. Os campos e endpoints exatos estão na documentação.
Perguntas frequentes
Preciso do WhatsApp Business API oficial para isso funcionar?
Não. A ZapZap API é uma API de WhatsApp não oficial baseada em instâncias. Você conecta um número comum lendo o QR Code e já pode enviar mensagens a partir dos eventos do Google Calendar, sem processo de aprovação de conta oficial.
Quanto custa manter essa automação rodando?
O custo é de R$15 por número ativo por mês, no modelo pré-pago. Você paga só pelos números conectados e ainda recebe crédito grátis para testar a integração com a sua agenda antes de colocar em produção.
O Google Apps Script é a única forma de integrar?
É o caminho mais direto por já ter acesso nativo ao Google Calendar, mas você também pode usar ferramentas de automação como n8n, Make ou Zapier, ou um backend próprio, desde que ele leia os eventos da agenda e chame a ZapZap API por HTTP.
Onde eu coloco o telefone do cliente no evento?
No exemplo, o número fica na descrição do evento, de onde o script o extrai. Você pode adaptar para ler de convidados, de um campo padronizado no título ou de uma planilha externa vinculada, conforme o seu fluxo de agendamento.
Como sei os endpoints e campos exatos da API?
Este exemplo é ilustrativo. A referência sempre atual dos endpoints, campos e formatos de autenticação está em https://api.zapzapapi.com/llms.txt, que serve como fonte de verdade para montar suas chamadas.
Comece com crédito grátis
Crie sua conta, conecte um número em minutos e teste a API com aquecimento e anti-bloqueio. R$15 por número ativo/mês, pré-pago, sem fidelidade.
