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 Gestor de negocios de WhatsApp 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:

• Obtener una lista de plantillas
• Crear una plantilla
• Eliminar una plantilla
• Actualizar una plantilla
• Cargar medios

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 medios cargados tendrán un identificador único que puede especificarse 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 una plantilla existente, y establezca 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 contraseñas de un solo uso para verificar a los usuarios en varias etapas de inicio de sesión, si es necesario (por ejemplo, verificación de cuenta, recuperación de cuenta, desafíos 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

Puede eliminar una plantilla asociada a una determinada WhatsApp Business Account especificando la plantilla por su nombre o a través de su ID. Si una plantilla concreta tiene varias versiones lingüísticas para el mismo nombre, todos se eliminarán las versiones de ese nombre de plantilla.

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

Actualizar 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 sólo pueden editarse cuando se encuentran en un archivo Approved, Rejectedo Paused estado.
2. Al editar una plantilla activa, las plantillas podrán ser aprobadas automáticamente. Las plantillas que superen las comprobaciones de formato y de Política comercial y empresarial volverán a activarse inmediatamente, sin necesidad de realizar ninguna acción adicional para seguir enviando mensajes que ya utilicen esas plantillas.
3. Al editar un Paused las plantillas podrán ser aprobadas automáticamente. Las plantillas que superen las comprobaciones de formato y de política empresarial y comercial podrán volver a ponerse en funcionamiento. Para empezar a enviar mensajes utilizando esas plantillas, las empresas tendrán que hacer una llamada a la API de mensajería.
4. El punto final Actualizar le permite cambiar la categoría de la plantilla. Una vez que la solicitud se haya enviado correctamente, podrá ver tanto la "categoría_anterior" como la "categoría" actualizada cuando utilice el punto final Plantillas de lista.
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

Puede cargar medios como imágenes, vídeos y archivos PDF en la plataforma WhatsApp para utilizarlos en plantillas de mensajes multimedia. Los archivos multimedia deben cargarse antes de poder utilizarse en una plantilla de mensaje multimedia.

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