Configuración de Google Sheets + email de PQR

Este proyecto usa un solo Google Apps Script Web App para dos cosas:

1. Solicitudes de servicio (formulario Typeform de 7 pasos, en todo el sitio) → se guardan como fila en una Google Sheet.
2. PQR (formulario de /contacto/) → se envían por correo electrónico a contacto@conductorprofesionalcali.com, no se guardan en la hoja.

Paso 1: Crear Google Sheet

1. Ve a Google Sheets
2. Crea una nueva hoja de cálculo con el nombre: “Solicitudes Conductor Cali”
3. En la primera hoja, crea las siguientes columnas en la fila 1:
   • A: timestamp
   • B: nombre
   • C: telefono
   • D: servicio
   • E: fecha
   • F: hora
   • G: origen
   • H: page
   • I: cta_source

Paso 2: Crear Google Apps Script

1. En tu hoja de cálculo, ve a Extensiones > Apps Script
2. Borra el código predeterminado y pega el contenido de docs/google-apps-script.js
3. Si tu correo de contacto no es contacto@conductorprofesionalcali.com, cambia el valor de PQR_RECIPIENT al inicio del script
4. Guarda el script (Ctrl + S o Cmd + S)
5. Dale un nombre al proyecto, por ejemplo: “Conductor Cali Form”

Paso 3: Desplegar el script

1. Haz clic en el botón Deploy > New deployment
2. Selecciona Web app como tipo de despliegue
3. Configura los siguientes campos:
   • Description: “API para formulario de contacto y PQR”
   • Execute as: “Me (tu-correo@gmail.com)”
   • Who has access: “Anyone”
4. Haz clic en Deploy
5. Se te pedirá que autorices el script:
   • Selecciona tu cuenta de Google
   • Haz clic en “Advanced” > “Go to (project name) (unsafe)”
   • Haz clic en “Allow” (el script necesita permiso para enviar correos con MailApp, además de escribir en la hoja)
6. Copia la URL del Web App que se genera — esta es tu SHEETS_URL

Paso 4: Actualizar el sitio

1. Abre el archivo js/config.js
2. Reemplaza la línea:

   sheetsUrl: 'https://script.google.com/macros/s/YOUR_SCRIPT_ID/exec',
   

   Con tu URL real:

   sheetsUrl: 'https://script.google.com/macros/s/ACTUAL_SCRIPT_ID/exec',
   

3. Este mismo archivo controla whatsappNumber — el número que recibe las solicitudes de servicio por WhatsApp (formato: código país + número, sin + ni espacios, ej. 573001234567)

js/config.js es el único lugar donde se configura la URL — tanto el formulario principal (js/form.js) como el formulario de PQR (contacto.html) la leen de ahí.

Paso 5: Probar la integración

Solicitud de servicio:

1. Abre tu sitio web y haz clic en cualquier botón “Solicitar servicio”
2. Completa el formulario con datos de prueba y envíalo
3. Verifica que los datos aparezcan en tu Google Sheet
4. Verifica que se abra una pestaña de WhatsApp con el mensaje prellenado

PQR:

1. Ve a /contacto/ y haz clic en “Presentar PQR”
2. Completa el formulario y envíalo
3. Verifica que llegue el correo a la dirección configurada en PQR_RECIPIENT
4. Confirma que el formulario muestre el mensaje de éxito

También puedes probar el script directamente desde el editor de Apps Script ejecutando las funciones testScript() (solicitud de servicio) y testPqrScript() (PQR), y revisando los logs de ejecución.

Troubleshooting

Error “Hoja no encontrada”

• El script ahora usa la primera pestaña de la hoja como respaldo si SHEET_TAB no coincide con el nombre real (por ejemplo, “Hoja 1” en vez de “Sheet1” en una hoja creada en español) — no debería volver a ocurrir, pero si tu hoja tiene varias pestañas y las solicitudes deben ir a una específica, ajusta SHEET_TAB al nombre exacto

Error de permisos

• Vuelve a desplegar el script y asegúrate de seleccionar “Anyone” para el acceso
• Verifica que hayas autorizado todos los permisos necesarios, incluyendo el envío de correos

No llegan los datos ni el correo de PQR

• Revisa que la URL en js/config.js sea correcta
• Verifica la consola del navegador para errores
• Revisa los logs de ejecución en Google Apps Script (Ejecuciones en el panel lateral)

No se abre WhatsApp

• Confirma que whatsappNumber en js/config.js esté en el formato correcto (sin +, sin espacios)
• Algunos navegadores bloquean la ventana emergente — el formulario muestra un enlace de respaldo en la pantalla de éxito si esto ocurre

CORS errors

• El sitio envía el POST con Content-Type: text/plain;charset=utf-8 (no application/json) precisamente para evitar el preflight CORS que Apps Script no responde — no cambies este header
• Con este formato la respuesta del servidor sí se puede leer: si el guardado falla, aparecerá un console.error con el mensaje real en la consola del navegador (F12)

Cambios en el script no se reflejan

• Editar y guardar el código en el editor de Apps Script no actualiza la URL /exec ya publicada
• Después de cualquier cambio, ve a Deploy > Manage deployments > ✏️ (editar) > cambia “Version” a “New version” > Deploy
• Si agregaste permisos nuevos (por ejemplo MailApp), Google puede pedir que vuelvas a autorizar el script