Integrar WhatsApp con Google Sheets

Paso a paso

1. 1

   Arma la hoja con columnas claras

   En Google Sheets, crea una pestaña con las columnas Nombre, Teléfono (en formato 5511999999999, con código de país y de área), Mensaje y Estado. Cada fila es un contacto al que se enviará. La columna Estado sirve para marcar Enviado después de cada envío.

2. 2

   Abre Apps Script

   En el menú superior, haz clic en Extensiones y luego en Apps Script. Se abrirá el editor de código en una pestaña nueva, ya vinculado a esta hoja. Borra el contenido por defecto de la función myFunction para empezar limpio.

3. 3

   Guarda tus credenciales en Propiedades del script

   En el editor, ve a Configuración del proyecto (ícono de engranaje) y, en la sección Propiedades del script, agrega ZAPZAP_KEY y ZAPZAP_SECRET con tu x-api-key y x-api-secret de ZapZap API. Así las claves no quedan escritas en el código.

4. 4

   Pega el script que lee las filas y llama a UrlFetchApp

   En el editor, usa SpreadsheetApp.getActiveSheet().getDataRange().getValues() para leer las filas y UrlFetchApp.fetch() para enviar cada contacto a ZapZap API, pasando los headers x-api-key y x-api-secret. Recorre las filas en un bucle, omite a quien ya tenga Estado Enviado y escribe Enviado en la columna después de cada respuesta.

5. 5

   Ejecuta y crea un menú o activador

   Haz clic en Ejecutar y autoriza el script en el popup de Google (es normal la primera vez). Para facilitar el uso diario, agrega un onOpen() que cree un menú personalizado en la hoja, o configura un Activador en Activadores para que corra en un horario programado. Revisa la documentación oficial de la API en https://api.zapzapapi.com/llms.txt para los nombres exactos de ruta y campos antes de pasar a producción.

// Apps Script (Extensiones > Apps Script) : ejemplo ILUSTRATIVO
// Revisa la ruta y los campos exactos en 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 exactos en la 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); // espacia los envios
  }
}