API de gestión de plantillas de WhatsApp

La API de gestión de plantillas de WhatsApp permite enumerar las plantillas de WhatsApp existentes, crear plantillas nuevas, eliminar plantillas y cargar medios para su uso en plantillas. Aunque las plantillas de WhatsApp se pueden gestionar manualmente a través de la WhatsApp Business Manager UI: la API de gestión de plantillas de WhatsApp de Vonage ahora te permite gestionar tus plantillas mediante programación a través de la API de WhatsApp Business.

Actualmente, la API de gestión de plantillas de WhatsApp permite realizar las siguientes operaciones:

• Consigue una lista de plantillas
• Crear una plantilla
• Eliminar una plantilla
• Actualizar una plantilla
• Subir archivos multimedia

Obtener una lista de plantillas

Mediante la API de gestión de plantillas de WhatsApp, puede obtener una lista de las plantillas que pertenecen a la Account de WhatsApp Business especificada. La API proporciona algunas funciones de paginación y filtrado. Por ejemplo, puede filtrar las solicitudes por plantilla status, languagey name_or_content.

Crear una plantilla

Puede crear plantillas de varios tipos y categorías, así como crear variaciones de una plantilla en varios idiomas. Cuando cree plantillas con versiones en varios idiomas, asegúrese de ser coherente con las traducciones en todas las versiones.

Proceso de aprobación

Las plantillas deben ser aprobadas por Meta antes de poder ser utilizadas en un mensaje de WhatsApp. Cuando se crean, las plantillas tienen inicialmente un status de PENDING. Una vez aprobados, tendrán un status de APPROVEDy puede utilizarse.

Plantillas de mensajes para los medios de comunicación

Al crear plantillas de mensajes multimedia, primero debe cargar en la plataforma WhatsApp los medios que se van a utilizar (consulte Cargar medios). Los archivos multimedia subidos tendrán un identificador único que se puede especificar al crear una plantilla.

Variantes lingüísticas

Puede crear múltiples variantes de una plantilla para adaptarla a distintos idiomas. Para ello, cree una plantilla con el mismo formato name y category como plantilla ya existente, y configurar language y todo el contenido del texto según corresponda a la nueva variante lingüística. La lista de idiomas admitidos está disponible en la sección Documentación de WhatsApp.

Categorías de plantillas

A partir del 1 de junio de 2023, WhatsApp introducirá nuevas categorías de conversación para las empresas que envíen mensajes; encontrará información sobre estas categorías y sus precios aquí. Ahora hay tres categorías de plantillas compatibles para cada uno de los tipos de conversación iniciados por la empresa:

• UTILITY: Permitir la realización de una solicitud o transacción concreta y acordada o proporcionar a un cliente información actualizada sobre una transacción en curso, incluidas las notificaciones posteriores a la compra y los extractos de facturación periódicos.
• AUTHENTICATION: Permite a las empresas utilizar códigos de acceso de un solo uso para verificar a los usuarios en distintas fases del proceso de inicio de sesión, si fuera necesario (por ejemplo, verificación de la cuenta, recuperación de la cuenta o comprobaciones de integridad).
• MARKETING: Conversaciones iniciadas por la empresa para comercializar un bien o servicio a los clientes, como el envío de ofertas pertinentes a los clientes que hayan optado por ello. Esto también incluiría cualquier interacción relacionada con la empresa que no sea una conversación de autenticación o utilidad.

Todas las plantillas existentes en una de estas categorías se migrarán a una de las nuevas categorías de plantillas: TRANSACTIONAL, MARKETING, OTP, ACCOUNT_UPDATE, PAYMENT_UPDATE, PERSONAL_FINANCE_UPDATE, SHIPPING_UPDATE, RESERVATION_UPDATE, ISSUE_RESOLUTION, APPOINTMENT_UPDATE, TRANSPORTATION_UPDATE, TICKET_UPDATE, ALERT_UPDATE o AUTO_REPLY.

Borrar una plantilla

Puedes eliminar una plantilla asociada a un Account específico de WhatsApp Business indicando el nombre de la plantilla o su ID. Si una plantilla concreta tiene varias versiones lingüísticas con el mismo nombre, todos se eliminarán las versiones de ese nombre de plantilla.

Una vez eliminada, el nombre de la plantilla (aprobada) no se podrá volver a utilizar durante 30 días.

Actualización de una plantilla

Puede actualizar una plantilla existente identificada a través de su ID de plantilla. Hay que tener en cuenta algunas cosas al editar una plantilla:

1. Las plantillas de mensajes solo se pueden editar cuando se está en un Approved, Rejected, o Paused estado.
2. Al editar una plantilla activa, las plantillas podrán ser objeto de aprobación automática. Las plantillas que superen las comprobaciones de formato y de la Política de Negocios y Comercio volverán a estar activas de inmediato, sin que sea necesario realizar ninguna acción adicional para seguir enviando los mensajes que ya utilizan dichas plantillas.
3. Al editar un Paused plantilla; las plantillas podrán ser aprobadas automáticamente. Las plantillas que superen las comprobaciones de formato y las de la Política de Negocios y Comercio podrán volver a publicarse. Para empezar a enviar mensajes utilizando esas plantillas, las empresas tendrán que realizar una llamada a la API de mensajería.
4. El punto final «Update» te permite cambiar la categoría de la plantilla. Una vez enviada la solicitud con éxito, podrás ver tanto la «previous_category» como la «category» actualizada al utilizar el punto final «List Templates».
5. Las plantillas de mensajes en estado Aprobado pueden editarse hasta 10 veces en un plazo de 30 días, o 1 vez en un plazo de 24 horas. Los mensajes en estado Rechazado o Pausado pueden editarse un número ilimitado de veces.

Cargar medios

Puedes subir archivos multimedia, como imágenes, vídeos y archivos PDF, a la plataforma de WhatsApp para utilizarlos en plantillas de mensajes multimedia. Los archivos multimedia deben subirse antes de poder utilizarlos en una plantilla de mensajes multimedia. Una vez subidos, los archivos multimedia estarán disponibles durante 30 días a través del identificador de subida de archivos multimedia que se devuelve en la respuesta. Consulta la Documentación de Meta para más información.

Ejemplo de solicitud cURL

curl --location 'https://api.nexmo.com/v2/whatsapp-manager/media/uploads?file_type=image%2Fjpg' \
--header 'Authorization: Basic NTE1...g==' \
--form 'mediafile=@"Directory/WhatsApp_Image.jpeg"'