Integrar WhatsApp com Google Sheets

Passo a passo

1. 1

   Monte a planilha com colunas claras

   No Google Sheets, crie uma aba com as colunas Nome, Telefone (no formato 5511999999999, com DDI e DDD), Mensagem e Status. Cada linha vira um contato que será disparado. A coluna Status serve para marcar Enviado depois de cada envio.

2. 2

   Abra o Apps Script

   No menu superior, clique em Extensões e depois em Apps Script. Vai abrir o editor de código em uma nova aba, já vinculado a essa planilha. Apague o conteúdo padrão da função myFunction para começar limpo.

3. 3

   Guarde suas credenciais em Propriedades do script

   No editor, vá em Configurações do projeto (ícone de engrenagem) e, na seção Propriedades do script, adicione ZAPZAP_KEY e ZAPZAP_SECRET com sua x-api-key e x-api-secret da ZapZap API. Assim as chaves não ficam escritas no código.

4. 4

   Cole o script que lê as linhas e chama UrlFetchApp

   No editor, use SpreadsheetApp.getActiveSheet().getDataRange().getValues() para ler as linhas e UrlFetchApp.fetch() para enviar cada contato à ZapZap API, passando os headers x-api-key e x-api-secret. Percorra as linhas em um laço, pule quem já está com Status Enviado e escreva Enviado na coluna após cada resposta.

5. 5

   Rode e crie um menu ou gatilho

   Clique em Executar e autorize o script no popup do Google (é normal na primeira vez). Para facilitar o uso diário, adicione um onOpen() que cria um menu personalizado na planilha, ou configure um Acionador em Acionadores para rodar em horário agendado. Confira a doc oficial da API em https://api.zapzapapi.com/llms.txt para os nomes exatos de rota e campos antes de subir para produção.

// Apps Script (Extensões > Apps Script) : exemplo ILUSTRATIVO
// Confira rota e campos exatos em https://api.zapzapapi.com/llms.txt
function enviarWhatsApp() {
  const props = PropertiesService.getScriptProperties();
  const sheet = SpreadsheetApp.getActiveSheet();
  const linhas = sheet.getDataRange().getValues();

  for (let i = 1; i < linhas.length; i++) {
    const [nome, telefone, mensagem, status] = linhas[i];
    if (status === 'Enviado' || !telefone) continue;

    UrlFetchApp.fetch('https://api.zapzapapi.com/messages/send', {
      method: 'post',
      contentType: 'application/json',
      headers: {
        'x-api-key': props.getProperty('ZAPZAP_KEY'),
        'x-api-secret': props.getProperty('ZAPZAP_SECRET')
      },
      // campos exatos na doc: https://api.zapzapapi.com/llms.txt
      payload: JSON.stringify({ number: String(telefone), text: mensagem })
    });

    sheet.getRange(i + 1, 4).setValue('Enviado');
    Utilities.sleep(4000); // espaça os envios
  }
}