¿Cuándo usarlo?
Cuando necesitas llevar las plantillas de WhatsApp de una cuenta de WhatsApp Business (WABA) a otra. Por ejemplo: migración de número, una empresa con más de una WABA que quiere las mismas plantillas en todas, o cambio de portafolio en Meta Business. Meta no tiene un botón de "duplicar" entre cuentas, pero se puede hacer con la API de Meta (Graph API) en pocos pasos.
Este procedimiento requiere a alguien con experiencia en llamadas de API. Si lo prefieres, habla con nuestro soporte y te ayudamos.
No es posible clonar el estado de aprobado. Cada plantilla recreada en la WABA de destino pasa de nuevo por la aprobación de Meta (normalmente minutos, pero puede tardar hasta 24h). Planifica el cambio teniendo en cuenta este plazo, para no quedarte sin plantillas aprobadas en la cuenta nueva.
¿Qué necesito antes?
- El WABA ID de origen y el WABA ID de destino
- Un access token con el permiso
whatsapp_business_managementque tenga acceso a las dos WABAs (de un usuario del sistema del Business Manager, por ejemplo)
¿Cómo lo hago, paso a paso?
1. Listar las plantillas aprobadas de la WABA de origen
curl -G "https://graph.facebook.com/v{version}/{WABA_ID_ORIGEN}/message_templates" \
-d "status=APPROVED" \
-d "fields=name,language,category,parameter_format,components" \
-d "limit=100" \
-H "Authorization: Bearer {TOKEN}"
La respuesta trae el nombre, idioma, categoría y contenido (components) de cada plantilla. Si hay más de 100, sigue el enlace paging.next de la respuesta hasta el final.
2. Crear cada plantilla en la WABA de destino
Para cada elemento de la lista, envía un POST con los mismos datos. Quita los campos que son de la cuenta de origen (id, status, calidad, etc.) y envía solo name, language, category, parameter_format (si viene) y components.
curl -X POST "https://graph.facebook.com/v{version}/{WABA_ID_DESTINO}/message_templates" \
-H "Authorization: Bearer {TOKEN}" \
-H "Content-Type: application/json" \
-d '{
"name": "bienvenida",
"language": "es",
"category": "UTILITY",
"components": [ ...copiado del origen... ]
}'
3. Seguir la aprobación
Vuelve a consultar con el GET en la WABA de destino revisando el campo status hasta que todas estén APPROVED. Las que vuelvan como REJECTED necesitan un ajuste manual.
¿Qué puntos debo tener en cuenta?
- Plantillas con multimedia en el encabezado (imagen, video, documento): el archivo de ejemplo del origen no sirve en la otra cuenta. Sube el archivo de nuevo con la Resumable Upload API, obtén el nuevo handle y reemplázalo en
header_handleantes del POST. - Variables: mantén los ejemplos (
example) que vienen en loscomponents. Sin ellos, Meta rechaza la plantilla. - Límite de creación: como máximo 100 plantillas creadas por hora en cada WABA. Si son muchas, hazlo por lotes.
- Límite total: 250 plantillas por WABA si el portafolio no está verificado (verificado permite muchas más).
- Categoría: Meta puede reclasificar la categoría en la nueva aprobación (por ejemplo, de utilidad a marketing), lo que cambia el costo de envío.
- Nombre: el mismo
name+ idioma no puede existir ya en la WABA de destino.
Observaciones
- Para crear, editar y usar plantillas dentro de Cloud Chat, consulta Plantillas de WhatsApp: crear, editar, eliminar y usar el constructor.
- Para entender las categorías y los motivos de rechazo, consulta Reglas de plantillas de WhatsApp (Meta).
- ¿Tienes alguna duda? Habla con nuestro soporte.
Referencia oficial: Plantillas de mensajes (Meta for Developers)