up

2026-01-12 11:06:43 -05:00
parent ce12ac2cce
commit dd36ed6fe0
110 changed files with 20873 additions and 696 deletions
@@ -0,0 +1,167 @@
+# Guía para Resolver Error de Plantillas WhatsApp
+
+## Error: "Template name does not exist in the translation" (#132001)
+
+### ¿Qué significa este error?
+Este error indica que WhatsApp no encuentra la plantilla especificada, o hay un problema con su configuración.
+
+### Causas Comunes:
+1. La plantilla no existe en WhatsApp Business Manager
+2. La plantilla no está aprobada por Meta
+3. El idioma especificado no coincide con el de la plantilla
+4. El nombre de la plantilla está mal escrito
+
+## Pasos para Resolverlo
+
+### 1. Verificar en WhatsApp Business Manager
+1. Ve a [business.facebook.com](https://business.facebook.com)
+2. Selecciona tu cuenta de negocio
+3. Ve a **WhatsApp Manager** → **Plantillas de mensaje**
+4. Verifica que existe la plantilla `jaspers_market_plain_text_v1`
+5. Confirma que el estado es **"Aprobada"** (no "Pendiente de revisión")
+
+### 2. Verificar el Idioma
+- Si la plantilla está en inglés, usa `language: "en"` 
+- Si está en español, usa `language: "es"`
+- El idioma debe coincidir EXACTAMENTE
+
+### 3. Verificar el Nombre
+- Usa el nombre EXACTO de la plantilla
+- No uses espacios ni caracteres especiales si no están en el nombre original
+- Verifica mayúsculas y minúsculas
+
+### 4. Usar el Diagnóstico del Sistema
+1. Ve a la pestaña **Configuración**
+2. Haz clic en **"Ejecutar"** en el panel de Diagnóstico
+3. Revisa el estado de tus plantillas
+
+## Ejemplos de Envío Correcto
+
+### Formato Simple:
+```json
+{
+  "phone": "+1234567890",
+  "type": "template",
+  "template_name": "jaspers_market_plain_text_v1",
+  "language": "en",
+  "parameters": ["Juan", "123456"]
+}
+```
+
+### Formato WhatsApp Business API:
+```json
+{
+  "messaging_product": "whatsapp",
+  "to": "+1234567890",
+  "type": "template",
+  "template": {
+    "name": "jaspers_market_plain_text_v1",
+    "language": {
+      "code": "en"
+    },
+    "components": [
+      {
+        "type": "body",
+        "parameters": [
+          {
+            "type": "text",
+            "text": "Juan"
+          },
+          {
+            "type": "text", 
+            "text": "123456"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Crear una Nueva Plantilla
+
+### En WhatsApp Business Manager:
+1. Ve a **Plantillas de mensaje** → **Crear plantilla**
+2. Escoge la categoría apropiada (UTILITY, MARKETING, AUTHENTICATION)
+3. Escribe el contenido usando variables como `{{1}}`, `{{2}}`, etc.
+4. Envía para aprobación
+5. Espera la aprobación de Meta (puede tomar 24-48 horas)
+
+### Ejemplo de Plantilla Simple:
+```
+Nombre: mi_plantilla_bienvenida
+Idioma: Español
+Categoría: UTILITY
+Contenido: Hola {{1}}, bienvenido a nuestro servicio. Tu código es: {{2}}
+```
+
+### Registrarla en el Sistema:
+1. Ve a la pestaña **Plantillas**
+2. Haz clic en **Nueva Plantilla**
+3. Completa los datos:
+   - Nombre: `mi_plantilla_bienvenida`
+   - Plantilla WhatsApp: `mi_plantilla_bienvenida` (igual al nombre)
+   - Idioma: `es`
+   - Categoría: `UTILITY`
+   - Estado: `approved` (solo después de que Meta la apruebe)
+
+## Herramientas de Debug
+
+### 1. Verificar Plantillas Disponibles
+```bash
+curl -X GET "http://tu-dominio.com/api/check_templates.php"
+```
+
+### 2. Ejecutar Diagnóstico Completo
+```bash
+curl -X GET "http://tu-dominio.com/api/diagnose_whatsapp.php?debug=1"
+```
+
+### 3. Probar Envío con Debug
+```bash
+curl -X POST "http://tu-dominio.com/api/send_message.php?debug=1" \
+-H "Content-Type: application/json" \
+-d '{
+  "phone": "+1234567890",
+  "type": "template",
+  "template_name": "mi_plantilla_test",
+  "language": "es",
+  "parameters": ["Pedro", "ABC123"]
+}'
+```
+
+## Estados de Plantillas
+
+| Estado | Descripción | ¿Se puede usar? |
+|--------|-------------|-----------------|
+| `pending` | En revisión por Meta | ❌ No |
+| `approved` | Aprobada por Meta | ✅ Sí |
+| `rejected` | Rechazada por Meta | ❌ No |
+| `disabled` | Deshabilitada | ❌ No |
+
+## Resolución por Pasos
+
+### ✅ Lista de Verificación:
+- [ ] La plantilla existe en WhatsApp Business Manager
+- [ ] La plantilla está aprobada (estado: "Aprobada")
+- [ ] El nombre de la plantilla es exacto
+- [ ] El idioma coincide con la configuración en Meta
+- [ ] Los parámetros coinciden con las variables de la plantilla
+- [ ] La configuración de WhatsApp Business API es correcta
+
+### 🔧 Si Sigues Teniendo Problemas:
+1. Revisa el Access Token (puede haber expirado)
+2. Confirma los permisos de la aplicación de Facebook
+3. Verifica que el Phone Number ID es correcto
+4. Asegúrate de que el número de WhatsApp Business está verificado
+
+## Contacto y Soporte
+
+Si después de seguir estos pasos sigues teniendo problemas:
+1. Usa el diagnóstico del sistema para obtener un reporte detallado
+2. Verifica los logs en la pestaña "Logs"
+3. Comprueba la documentación oficial de WhatsApp Business API
+4. Considera crear una plantilla de prueba simple para verificar conectividad
+
+---
+*Guía actualizada: Enero 2026*