167 lines
4.8 KiB
Markdown
167 lines
4.8 KiB
Markdown
# 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* |