# 💬 Conector Oficial de WhatsApp para Ventas (WhatsApp Cloud API)

> **Resumen para No Técnicos**: Permite que tu empresa atienda a clientes por WhatsApp las 24 horas del día con Inteligencia Artificial: responder preguntas frecuentes, mostrar catálogo de productos, cotizar precios y pasar la conversación a un asesor humano cuando el cliente esté listo para pagar.

| Metadato | Detalle |
|---|---|
| **Tipo** | API Oficial de Meta (Cloud API) |
| **Área Empresarial** | 02. Ventas, Atención Comercial y CRM |
| **Nivel de Dificultad** | 🟡 Media |
| **Modelo de Costo** | Meta ofrece 1,000 conversaciones de servicio gratuitas cada mes |
| **Enlace Oficial** | [Meta for Developers - WhatsApp Cloud API](https://developers.facebook.com/docs/whatsapp/cloud-api) |

---

## 💡 ¿Para qué le sirve a tu empresa? (Valor Real)

En toda América Latina, **WhatsApp es la vitrina principal de ventas**. El 90% de los clientes prefieren escribir un mensaje de WhatsApp antes que llenar un formulario web o hacer una llamada telefónica.

Sin embargo, cuando un cliente escribe a las 9 de la noche o en fin de semana y nadie le responde en 15 minutos, **se va con la competencia**. 

Con la API Oficial de WhatsApp Cloud conectada a tu IA:
- El cliente recibe respuesta instantánea y amable a cualquier hora.
- La IA le hace las preguntas clave (qué producto busca, qué medida, para qué ciudad).
- Si el cliente tiene una duda compleja o quiere pagar, la IA notifica al vendedor humano por WhatsApp interno o correo.

---

## 🎁 ¿Qué valor aporta frente a soluciones no oficiales?

- **Cero riesgo de baneo**: Al usar la API oficial de Meta, tu número de teléfono corporativo nunca será bloqueado (a diferencia de bots piratas o extensiones no oficiales).
- **Botones y Menús Interactivos**: Puedes enviar listas de opciones y botones donde el cliente solo toca la pantalla sin tener que escribir.
- **Conexión Directa con tu Inventario**: Puede responder si hay existencias reales de un producto en tu tienda.

---

## 🔑 ¿Qué necesitas para activarlo?

1. Una cuenta de [Meta for Developers](https://developers.facebook.com/).
2. Un número de teléfono que no esté asociado a una cuenta personal de WhatsApp (puede ser un número fijo o un chip nuevo).
3. Una página de Facebook de tu empresa o cuenta de Meta Business Suite.
4. Tu `WHATSAPP_TOKEN` y `PHONE_NUMBER_ID`.

---

## ⚙️ Configuración Paso a Paso

Variables de entorno para tu backend, webhook de n8n, Make o servidor MCP:

```env
# Variables de entorno (.env)
META_WHATSAPP_TOKEN=tu_token_de_acceso_meta_aqui
WHATSAPP_PHONE_NUMBER_ID=109283746501928
WHATSAPP_BUSINESS_ACCOUNT_ID=987654321098765
WHATSAPP_VERIFY_TOKEN=palabra_secreta_para_webhook_123
```

---

## 🤖 Consultor Interactivo (Prompt Guiado para tu IA)

Copia y pega este prompt para entrenar a tu asistente de WhatsApp:

```markdown
Actúa como la Asesora Comercial Virtual de mi empresa por WhatsApp. 
Tu nombre es "Camila" y tu tono debe ser profesional, cercano, empático y 100% latinoamericano (usando un trato cortés y claro).

Reglas de atención comercial:
1. Saluda cordialmente y agradece al cliente por comunicarse con [Nombre de Empresa].
2. Identifícate con transparencia: "Soy Camila, la asistente virtual del equipo".
3. Pregunta al cliente en qué producto o servicio está interesado hoy.
4. Si pide precios, dale la información con claridad e indícale los métodos de pago disponibles (transferencia, tarjeta, contraentrega).
5. Si el cliente solicita hablar con una persona o tiene un reclamo especial, responde: "Con mucho gusto, ya le estoy transfiriendo esta conversación a un asesor de nuestro equipo para que te atienda personalmente".
```

---

## 🌎 Caso de Uso Real en América Latina

**Empresa**: "Muebles & Diseño San Jerónimo" (Fábrica de comedores y salas en Puebla, México).
- **Problema**: Recibían más de 80 mensajes diarios por WhatsApp pidiendo catálogo y precios, pero los vendedores tardaban hasta 4 horas en responder y los prospectos se enfriaban.
- **Resultado con la API**: La IA responde en menos de 5 segundos, envía fotos del catálogo en PDF y califica si el cliente tiene presupuesto inmediato. Las ventas mensuales subieron un 42%.

---

## 🛡️ Consideraciones de Seguridad y Buenas Prácticas

- **Cero Spam Masivo**: Nunca envíes mensajes promocionales a personas que no te hayan escrito primero o que no hayan aceptado recibir noticias tuyas.
- **Uso de Plantillas Aprobadas**: Para iniciar una conversación tú con el cliente después de 24 horas, debes usar plantillas de mensaje pre-aprobadas por Meta.