whatsapp/GUIA_ERROR_PLANTILLAS.md

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
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:

{
  "phone": "+1234567890",
  "type": "template",
  "template_name": "jaspers_market_plain_text_v1",
  "language": "en",
  "parameters": ["Juan", "123456"]
}

Formato WhatsApp Business API:

{
  "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

curl -X GET "http://tu-dominio.com/api/check_templates.php"

2. Ejecutar Diagnóstico Completo

curl -X GET "http://tu-dominio.com/api/diagnose_whatsapp.php?debug=1"

3. Probar Envío con Debug

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