Integra WhatsApp con Google Calendar

Paso a paso

1. 1

   Crea tu instancia en ZapZap API

   Entra al panel en app.zapzapapi.com, crea un número activo y conéctalo leyendo el QR Code en WhatsApp. En el menú de la instancia, copia tu x-api-key y x-api-secret, que se usarán para autenticar las llamadas.

2. 2

   Abre el Google Apps Script vinculado a la agenda

   Ve a script.google.com y haz clic en Nuevo proyecto. Este entorno tiene acceso nativo al servicio CalendarApp, que lee los eventos de tu cuenta de Google Calendar sin necesidad de credenciales adicionales.

3. 3

   Escribe el script que lee los eventos y llama a la API

   En el editor, usa CalendarApp.getDefaultCalendar().getEventsForDay(fecha) para obtener las citas y UrlFetchApp.fetch() para enviar cada recordatorio por ZapZap API. Pon el teléfono del cliente en la descripción de cada evento para que el script pueda extraer el número.

4. 4

   Crea un activador por tiempo

   En el menú lateral de Apps Script, haz clic en Activadores (el ícono de reloj) y luego en Añadir activador. Elige la función de envío, el tipo de evento Basado en tiempo y define un activador diario en el horario deseado, por ejemplo a las 8 h para avisar de las citas del día.

5. 5

   Autoriza y prueba

   Haz clic en Ejecutar una vez, acepta los permisos de acceso a Google Calendar y a internet externo. Comprueba que el recordatorio llegó al WhatsApp de prueba y ajusta el texto del mensaje antes de dejarlo corriendo en producción.

// Ejemplo ILUSTRATIVO en Google Apps Script.
// Consulta los endpoints y campos reales en https://api.zapzapapi.com/llms.txt

function enviarRecordatorios() {
  const manana = new Date();
  manana.setDate(manana.getDate() + 1);

  const eventos = CalendarApp.getDefaultCalendar().getEventsForDay(manana);
  const instanceId = 'TU_INSTANCE_ID';

  eventos.forEach(function (evento) {
    // Teléfono guardado en la descripción del evento
    const numero = evento.getDescription().trim();
    const hora = Utilities.formatDate(evento.getStartTime(), 'America/Sao_Paulo', 'HH:mm');
    const texto = 'Recordatorio: tienes ' + evento.getTitle() + ' mañana a las ' + hora + '.';

    UrlFetchApp.fetch('https://api.zapzapapi.com/api/v1/' + instanceId + '/send/text', {
      method: 'post',
      contentType: 'application/json',
      headers: {
        'x-api-key': 'TU_API_KEY',
        'x-api-secret': 'TU_API_SECRET'
      },
      payload: JSON.stringify({
        number: numero,
        text: texto
      })
    });
  });
}