# AURA WhatsApp: puesta en marcha

El sistema usa una función de Vercel (`/api/whatsapp/send`) para subir cada PNG personalizado a Meta y enviarlo mediante una plantilla aprobada. El token de Meta no se incluye en el navegador ni en el repositorio.

## 1. Variables de entorno en Vercel

En el proyecto `aura-ccs-padel`, abre **Settings → Environment Variables** y crea estas variables para **Production** (y Preview si también lo probarás ahí):

| Variable | Valor |
| --- | --- |
| `AURA_WHATSAPP_ADMIN_KEY` | Una clave privada larga, generada por Barchex. No la compartas ni la guardes en GitHub. |
| `WHATSAPP_ACCESS_TOKEN` | Token de usuario del sistema de Meta con permiso `whatsapp_business_messaging`. |
| `WHATSAPP_PHONE_NUMBER_ID` | ID del número emisor en WhatsApp Manager / Meta Developers. |
| `WHATSAPP_TEMPLATE_NAME` | Nombre exacto de la plantilla aprobada que tenga encabezado de imagen. |
| `WHATSAPP_TEMPLATE_LANGUAGE` | Idioma exacto de la plantilla, por ejemplo `es` o `es_VE`. |
| `WHATSAPP_GRAPH_API_VERSION` | Versión Graph API activa para la app de Meta, con formato `vXX.0`. |
| `WHATSAPP_TEMPLATE_BODY_HAS_NAME` | Opcional: `true` si el cuerpo de la plantilla tiene un único marcador `{{1}}` para el nombre; si no, dejar sin configurar. |

Después de guardar las variables, crea un nuevo deployment de producción para que la función las reciba.

## 2. Plantilla de Meta

La plantilla debe estar aprobada y tener un **encabezado de imagen** para recibir la imagen personalizada. Si incluye `{{1}}` en el cuerpo, configura `WHATSAPP_TEMPLATE_BODY_HAS_NAME=true`; el sistema enviará allí el nombre del contacto. El endpoint usa el API oficial de Meta para subir medios y luego enviar una plantilla a cada destinatario.

## 3. Envío

Abre **WHATSAPP AURA** con la cuenta principal de Barchex, luego el generador de invitaciones. Carga el flyer y la lista `Nombre/Teléfono`, genera las imágenes, pega la clave privada de envío y pulsa **Enviar invitaciones preparadas**. El generador muestra el resultado por contacto y borra la clave al terminar. El botón solicita confirmación antes del envío.

El contacto debe tener teléfono con código de país, por ejemplo `+584121234567`, y debe esperar recibir la invitación de AURA.

## Control de acceso

La sección WhatsApp del sistema se muestra solo a la cuenta propietaria identificada como `u1` (Barchex / Administrador principal). Además, el servidor exige `AURA_WHATSAPP_ADMIN_KEY`, que se conserva como secreto de Vercel. La clave se escribe en el generador para la campaña y no queda en `localStorage`.