Registro de cambios

Este documento es un registro de los cambios realizados en la Plataforma de WhatsApp Business.

5 de noviembre de 2024

Todas las API

• Se ha añadido el extremo POST /<BUSINESS_PORTFOLIO_ID>/self_certify_whatsapp_business para la verificación de la empresa realizada por socios.

11 de octubre de 2024

API de administración de WhatsApp Business

• Se ha añadido el extremo POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>/set_solution_migration_intent para añadir una cuenta WABA a una solución de varios socios activa.

2 de octubre de 2024

Cambios en la versión 21.0 de la API de nube

• A partir de la versión 21.0, al crear plantillas de autenticación de relleno automático con un toque y sin toques, los parámetros package_name y signature_hash deben definirse dentro de la matriz supported_apps.
• A partir de la versión 21.0, para activar el almacenamiento local en un número de teléfono de empresa, el número debe estar sin registrar y debes usar el extremo POST /<WHATSAPP_BUSINESS_PHONE_NUMBER>/settings para activar el almacenamiento local antes de registrar el número (en lugar de activarlo durante el registro). Para complementar estos cambios, se ha hecho lo siguiente:

  • Se ha añadido el parámetro storage_configuration al extremo POST /<WHATSAPP_BUSINESS_PHONE_NUMBER>/settings, que puede usarse para activar o desactivar el almacenamiento local.
  • Se ha eliminado el parámetro data_localization_region del extremo POST /<WHATSAPP_BUSINESS_PHONE_NUMBER>/register.

25 de septiembre de 2024

API de nube

• Se han cambiado los pasos del panel de aplicaciones para que convertirse en proveedor de tecnología sea más fácil.

24 de septiembre de 2024

API de nube

• Se han añadido plantillas de botón de finalización de compra (solo están disponibles para las empresas de la India que utilizan números de teléfono de empresa con códigos de llamada de ese país).

11 de septiembre de 2024

API de nube

• Se han añadido plantillas de mensaje de un solo producto.
• Se han añadido plantillas de secuencias de tarjetas de productos.

10 de septiembre de 2024

API de nube

• Se ha modificado el comportamiento del almacenamiento en caché de los activos multimedia definido por el desarrollador (mediante el encabezado Cache-Control) a un periodo fijo de diez minutos. Sin embargo, todavía puedes forzar la recuperación de activos de tu servidor en lugar de nuestro almacenamiento en caché. Consulta Almacenamiento en caché de contenido multimedia.

6 de septiembre de 2024

API de nube

• Se ha añadido el acceso a los activos comerciales para los mensajes para controlar con mayor detalle el acceso de las cuentas de WhatsApp Business.
• Se ha añadido la posibilidad de crear soluciones para varios socios mediante botones insertables.

1 de junio de 2024

API de nube

• Se ha añadido la posibilidad de establecer una duración personalizada en las plantillas de utilidad.

API de administración de WhatsApp Business

• Se han añadido actualizaciones automáticas de las categorías a fin de corregir las plantillas a las que se haya asignado una categoría incorrecta de acuerdo con nuestras normas.

10 de abril de 2024

API de nube

• Se ha añadido la biblioteca de plantillas de utilidad.

10 de abril de 2024

API de nube

• Se ha añadido la anulación de URL de devolución de llamada de webhooks en los números de teléfono de empresa.

18 de marzo de 2024

API de nube

• Se ha añadido la API de componentes de conversaciones.

13 de febrero de 2024

API de nube

• Se han cambiado los límites de intentos de registro o cancelación de registro de números de teléfono de empresa a diez solicitudes por número de empresa en un intervalo periódico de 72 horas (antes era un intervalo periódico de una semana).

6 de febrero de 2024

API de nube, API local

• Se han añadido límites de mensajes de plantilla de marketing por usuario para ayudar a ofrecer experiencias de usuario de alta calidad.

26 de enero de 2024

API de nube

• Se ha cambiado el periodo de vida de los reintentos de entrega de mensajes de plantilla de la API de nube de 24 horas a 30 días. Puedes seguir anulando este valor para las plantillas de autenticación.
• Se ha cambiado el máximo de caracteres de biz_opaque_callback_data de 256 a 512.

18 de enero de 2024

API de nube

• Se han añadido componentes de conversaciones.

18 de diciembre de 2023

API de nube

• Se han añadido los mensajes de solicitud de ubicación.

12 de diciembre de 2023

API de administración de WhatsApp Business

• Se ha añadido el campo cta_url_link_tracking_opted_out en el nodo de las plantillas de mensajes de WhatsApp para activar o desactivar el seguimiento de los clics en los botones.
• Los análisis de plantillas ahora incluyen los clics en los botones en plantillas categorizadas como UTILITY.

20 de noviembre de 2023

API de administración de WhatsApp Business

• Se ha añadido el registro de la consola para ayudar con la depuración de plantillas de autenticación con un toque y por pulsación cero.

14 de noviembre de 2023

API de nube

• Se ha añadido el campo health_status a varios nodos para comprobar el estado de los mensajes.
• Se ha añadido el campo biz_opaque_callback_data a los mensajes de formato libre para incluir cadenas arbitrarias en webhooks de mensajes.

3 de noviembre de 2023

API de administración de WhatsApp Business

• La creación de plantillas de secuencias ahora requiere al menos un botón.

23 de octubre de 2023

API de administración de WhatsApp Business, API de nube, API local

• Se han añadido los mensajes de autenticación por pulsación cero.

10 de octubre de 2023

Flows

• WhatsApp Flows ya está disponible.

API de nube

• Se ha añadido un nuevo campo data_localization_region en el extremo Número de teléfono de WhatsApp Business > Registro para permitir el almacenamiento local.
• Se han añadido botones de URL de llamada a la acción para los mensajes interactivos de formato libre.

4 de octubre de 2023

API de administración de WhatsApp Business, API de nube, API local

• Las plantillas de autenticación que utilizan la advertencia de caducidad del código ahora usan el valor de code_expiration_minutes (en lugar del valor predeterminado de diez minutos) para determinar si el mensaje de plantilla entregado debe mostrar un botón para rellenar automáticamente o uno para copiar el código.
• Los botones para rellenar automáticamente que se muestran en un mensaje de plantilla entregado se desactivarán una vez transcurrido el periodo de tiempo que indica el valor de code_expiration_minutes de la plantilla, si se incluye (o tras 10 minutos, si no se incluye).

2 de octubre de 2023

API de nube

• Se han añadido nuevas plantillas de ofertas por tiempo limitado y nuevos componentes de la plantilla limited_time_offer.

27 de septiembre de 2023

API de nube

• Se ha añadido la propiedad ctwa_clid al objeto referral en los webhooks de mensajes. Indica el identificador del clic que se genera cuando el usuario toca un anuncio de clic a WhatsApp para enviar el mensaje.

18 de septiembre de 2023

API de nube, API local

• Las plantillas de autenticación obsoletas (plantillas de autenticación sin botones de contraseña de un solo uso) pueden seguir enviándose, editándose y apelándose hasta el 1 de abril de 2024 (plazo ampliado desde el 2 de octubre de 2023).

12 de septiembre de 2023

API de administración de WhatsApp Business

• Las respuestas de las solicitudes GET en las plantillas de autenticación ahora incluyen los componentes de plantilla add_security_recommendation y code_expiration_minutes en el valor de component.
• Se han añadido nuevos niveles de acceso a las cuentas de WhatsApp Business para tener un control más detallado.
• Las solicitudes GET en Cuenta de WhatsApp Business > Números de teléfono y Cuenta de WhatsApp Business > Plantillas de mensajes ahora devuelven el código de error 200 si no se ha concedido el acceso a la cuenta de WhatsApp Business adecuado al usuario al que hace referencia el identificador.
• Se ha añadido la migración de las plantillas.

API de nube

• Se han añadido los campos throughput y platform_type a los números de teléfono de WhatsApp Business.
• Se han añadido las plantillas de secuencias.

API de nube, API local

• Al migrar números de teléfono de empresa que tengan una conexión múltiple y ejecuten dos o más particiones de la API local a la API de nube, los números se actualizan automáticamente a un rendimiento superior de la API de nube.

28 de agosto de 2023

API de nube, API local

• Se ha añadido la frecuencia de las plantillas (beta, para determinados países).

15 de agosto de 2023

API de administración de WhatsApp Business

• Se ha añadido template_analytics (en versión beta).

8 de agosto de 2023

Herramientas

• Se ha añadido el estado de almacenamiento localizado de la API de nube en la página de estado de la API de WhatsApp Business.

API de administración de WhatsApp Business

• Se ha añadido el componente de botón para copiar código para usarlo con las plantillas de código de cupón.
• Se ha aumentado a 10 el límite total de componentes de botón en las plantillas; ahora, los botones de respuesta rápida se pueden combinar con otros tipos de botón, y el límite de botones de URL se ha aumentado a 2.
• Se ha añadido la administración masiva de plantillas.
• Se han añadido las vistas previas de plantilla para obtener la vista previa del texto de las plantillas en varios idiomas.

Registro insertado

• Se ha añadido la capacidad de desactivar la selección de números de teléfono en el registro insertado.
• Se ha añadido el registro de números de teléfono de empresa de forma masiva o mediante programación.
• Se ha añadido el registro masivo de números de teléfono de empresa verificados previamente.
• Se ha añadido el uso compartido de números de teléfono de empresa verificados previamente.

2 de agosto de 2023

API de administración de WhatsApp Business

• Ahora los números de teléfono de empresa verificados previamente tienen el estado VERIFIED durante 28 días (antes eran 14).

11 de julio de 2023

API de nube

• Ya no se requiere una llamada en directo para programar ni llevar a cabo una actualización del rendimiento de un número de teléfono de empresa.
• Ahora puedes indicar una hora de actualización al enviar un ticket de Asistencia directa para solicitar una actualización del rendimiento de un número de teléfono de empresa.
• El tiempo de inactividad para los números de teléfono de empresa que se están sometiendo a una actualización de rendimiento se ha reducido a cinco minutos o menos.

7 de julio de 2023

Administración de empresas

• El texto del botón para copiar el código y el texto del botón para rellenar automáticamente de la plantilla de autenticación ahora son opcionales en el momento de la creación.

13 de junio de 2023

Herramientas

• Se ha añadido latencia a la página de estado de la API de WhatsApp Business.

Administración de empresas

• Se ha añadido el código de error 2494100 a la API de administración de WhatsApp Business para indicar que un número de teléfono de empresa está en modo de mantenimiento temporalmente.

API de nube

• Se ha añadido la función de comprobación de cambio de identidad.
• Se han añadido los mensajes de catálogo.
• Se han añadido las plantillas de catálogo.

26 de mayo de 2023

Herramientas

• Se han añadido señales de error que pueden ayudar a depurar las plantillas de autenticación con botones de relleno automático de contraseñas de un solo uso.

23 de mayo de 2023

API de nube

• El intento de envío de una plantilla en pausa en un mensaje de plantilla usando la versión 17 o posteriores ahora devuelve el código de error 132015 en lugar de 132001.
• El intento de envío de una plantilla desactivada en un mensaje de plantilla usando la versión 17 o posteriores ahora devuelve el código de error 132016 en lugar de 132001.

API local

• El intento de envío de una plantilla en pausa en un mensaje de plantilla ahora devuelve el código de error 2061.
• El intento de envío de una plantilla desactivada en un mensaje de plantilla ahora devuelve el código de error 2062.

9 de mayo de 2023

API de administración de WhatsApp Business

• Se han añadido las plantillas de mensajes multiproducto.

API de nube

• Se han añadido los pagos mediante Stripe (solo en Singapur).
• Se han añadido los mensajes de dirección para solicitar la dirección de los clientes (solo en Singapur y la India).
• Se ha añadido el rendimiento de 1000 mensajes por segundo.

API local

• Se han añadido los pagos mediante Stripe (solo en Singapur).
• Se han añadido los mensajes de dirección para solicitar la dirección de los clientes (solo en Singapur y la India).

1 de mayo de 2023

API de administración de WhatsApp Business

• Se han añadido nuevos webhooks al campo de webhooks account_alerts que notifican la denegación del aumento del límite de mensajes.
• Todas las plantillas ahora deben categorizarse como AUTHENTICATION, MARKETING o UTILITY.

26 de abril de 2023

API de administración de WhatsApp Business

• Se ha añadido el campo hsm_id al extremo DELETE Cuenta de WhatsApp Business > Plantillas de mensajes. Si se incluye, elimina una única plantilla que coincide con el identificador proporcionado (en lugar de eliminar todas las plantillas que coinciden con el nombre proporcionado).

18 de abril de 2023

API de nube

• Se ha añadido last_onboarded_time al nodo Número de teléfono de WhatsApp Business. Indica cuándo un usuario ha creado un número de teléfono de empresa en su cuenta de WhatsApp Business al completar el flujo de registro insertado.

11 de abril de 2023

API de nube

• Se ha añadido el extremo Número de teléfono de WhatsApp Business > Información de cumplimiento de la empresa para añadir o actualizar la información de cumplimiento del número de teléfono de una empresa en la India.

Registro insertado

• Se han añadido los siguientes extremos para admitir los números de teléfono verificados previamente para los usuarios del registro insertado:

  • Número de teléfono de WhatsApp Business verificado previamente
  • Número de teléfono de WhatsApp Business verificado previamente > Solicitar código
  • Número de teléfono de WhatsApp Business verificado previamente > Verificar código
  • Empresa > Añadir números de teléfono

4 de abril de 2023

API de administración de WhatsApp Business, API de nube, API local

• La primera migración de categorías de plantillas se ha completado.
• La validación de categorías ahora forma parte del proceso de revisión de plantillas para las plantillas recién creadas. Se aplica a la versión 16.0 y versiones posteriores.
• Las respuestas de la API a las solicitudes de creación o edición de plantillas ahora incluyen el estado y la categoría de la plantilla. Se aplica a todas las versiones de la API.
• Se ha añadido el parámetro allow_category_change al extremo POST Cuenta de WhatsApp Business > Plantillas de mensajes.
• Se ha añadido INCORRECT_CATEGORY como nuevo valor de rechazo de reason para los webhooks de estado de la plantilla.
• Las plantillas que dependen de variables ahora requieren valores de ejemplo al crearse o editarse. Se aplica a todas las versiones.
• Se ha añadido el campo previous_category a las plantillas de mensajes de WhatsApp.
• Las conversaciones iniciadas por la empresa ya no cumplen los requisitos de las conversaciones en periodo gratuito. Si la cuenta de WhatsApp Business depende de los servicios de socios de soluciones o de socios de Meta, estarás exento de estos cambios hasta el 1 de junio de 2023.

17 de marzo de 2023

API de administración de WhatsApp Business

• Se ha añadido un nuevo campo de suscripción a webhooks: template_category_update. Si te suscribes a este campo, cada vez que la categoría de una plantilla cambie, recibirás un webhook en el que se indicará la categoría anterior y la categoría nueva de la plantilla.
• Las respuestas de la API a las solicitudes de creación y edición de plantillas ahora incluyen el estado y la categoría de la plantilla.

14 de marzo de 2023

API de nube

• Ahora puedes compartir información sobre la ubicación con los usuarios; para ello, debes añadir un encabezado de ubicación en la plantilla.

API local

• Por otra parte, ahora los usuarios pueden compartir información sobre su ubicación con las empresas mediante mensajes de solicitud de ubicación.

1 de marzo de 2023

API de nube, API local

• Al migrar un número de teléfono de una empresa con sede en la India de la API local a la API de nube ya no se eliminan los datos de cumplimiento de venta en internet correspondientes, por lo que ya no es necesario volver a rellenar estos datos de forma manual después de la migración.

15 de febrero de 2023

API de administración de WhatsApp Business

• Se ha añadido un nuevo extremo de comparación de plantillas que permite comparar el número de envíos de plantillas de mensajes y los índices de bloqueos.

3 de febrero de 2023

API de nube, API local

• Se ha añadido un nuevo extremo Número de teléfono de WhatsApp Business > Configuración de comercio para activar o desactivar el carrito de la compra y el catálogo de productos en números de teléfono de empresa individuales. Si quieres ver las instrucciones de uso y obtener información sobre cómo estas configuraciones te pueden ayudar a vender productos y servicios, consulta Definir la configuración de comercio (en el caso de la API de nube) y Definir la configuración de comercio (en el caso de la API local).

2 de febrero de 2023

API de administración de WhatsApp Business, API de nube

• La versión 16 de la API Graph ya está disponible. Como parte de esta versión, se han introducido cambios en las categorías de plantillas de mensajes, las respuestas de error de la API y los webhooks.

API de nube

• Ahora las plantillas que se hayan creado o editado con la versión 16.0 se tienen que incluir en una de las siguientes categorías; el resto de categorías ya no se admiten. Se aplica a la versión 16.0 y posteriores de la API de nube. Se aplicará a todas las versiones a partir del 1 de mayo de 2023. Este cambio se ha introducido para admitir el cambio que llevaremos a cabo el 1 de junio de 2023 para adoptar un nuevo modelo de precios basados en conversaciones.

  • AUTHENTICATION
  • MARKETING
  • UTILITY
• Los subcódigos de error, que casi nunca se utilizan y en los que no te deberías basar, se dejarán de incluir en las respuestas de error de la versión 16.0 y posteriores. En su lugar, utiliza code y details.
• El código de error 100 ("code":100) tenía diversos títulos únicos que indicaban la naturaleza de un determinado error 100. Todos los códigos de error 100 ahora usarán Invalid parameter como título. Los títulos anteriores que describían la naturaleza de un determinado código de error 100 se han trasladado a la propiedad details. Este cambio ahora también se refleja en las cargas útiles de los webhooks que describen la respuesta de un código de error 100.

Webhook de la API de nube

• El objeto errors de los webhooks activados mediante errores de solicitudes de la versión 16.0 y posteriores ahora incluirán las propiedades message y error_data.details; además, los valores de title se han cambiado por varios códigos de error. Los objetos errors ahora tienen la estructura y los datos siguientes:

[
  {
    "code": <CODE>,
    "title" : "<TITLE>",
    "message": "<MESSAGE>",
    "error_data": {
      "details": "<DETAILS>"
    }
  },
  ...
]

• El valor de la propiedad title se ha actualizado para los siguientes códigos de error. Los valores anteriores ahora aparecerán en error_data.details.

  • El nuevo título de 130470 ahora es Re-engagement message.
  • El nuevo título de 130429 ahora es Rate limit hit.
  • El nuevo título de 131045 ahora es Incorrect certificate.
  • El nuevo título de 131031 ahora es Business Account locked.
  • El nuevo título de 131053 ahora es Media upload error.
  • El nuevo título de 131027 ahora es Something went wrong.
  • El nuevo título de 131042 ahora es Business eligibility payment issue.
  • El nuevo título de 131026 ahora es Message Undeliverable.
  • El nuevo título de 131000 ahora es Something went wrong.
• El valor de la propiedad message es el mismo que el de la propiedad title, que indica el título del código de error. Esta propiedad establece una asignación a la propiedad message de las cargas útiles de las respuestas de error de la API.
• La propiedad error_data.details ahora incluye los títulos de los códigos de error señalados anteriormente y describe la causa subyacente del error. Este valor establece una asignación a la propiedad details de las cargas útiles de las respuestas de error de la API.

Estos cambios se reflejan en las siguientes propiedades de errors en los webhooks relacionados con los errores:

• entry.changes.value.errors
• entry.changes.value.messages.errors
• entry.changes.value.statuses.errors

30 de enero de 2023

API de nube

Las empresas no verificadas ahora pueden iniciar un máximo de 250 conversaciones en un periodo renovable de 24 horas.

13 de diciembre de 2022

Comprobación de permisos de contenido multimedia

Se aplica a todas las versiones de la API de nube.

Se ha añadido un nuevo campo opcional phone_number_id al extremo de contenido multimedia. Si incluyes este parámetro y un identificador de número de teléfono de empresa, la operación solo se procesará si el identificador del número de teléfono coincide con el identificador del número de teléfono en el que se subió el contenido multimedia.

8 de diciembre de 2022

Almacenamiento en caché HTTP de contenido multimedia

El almacenamiento en caché HTTP de contenido multimedia de la API de nube ha finalizado la fase beta y ya está disponible para todos.

Webhooks

Ahora la API de nube intentará entregar las notificaciones de webhooks en las que se haya producido un error durante un máximo de 7 días, en lugar de 30. Consulta Error en la entrega de webhooks.

23 de noviembre de 2022

Nuevo campo de webhooks

Se aplica a todas las versiones.

• Se ha añadido un nuevo campo template_performance_metrics. Te notifica semanalmente de todas las métricas de rendimiento de las plantillas, tales como la cantidad de mensajes enviados, la cantidad de mensajes abiertos y los principales motivos de los bloqueos.

22 de noviembre de 2022

Nuevos campos y valores de webhooks

Se aplica a todas las versiones.

Nuevo campo account_alerts:

• Se ha añadido un nuevo campo account_alerts. Te notifica de las alertas empresariales, de la cuenta de WhatsApp Business y del número de teléfono de la empresa.

Nuevos valores del campo account_update:

• Se ha añadido un nuevo valor de account_update.events: ACCOUNT_DELETED. Indica que se ha anulado el registro de un número de teléfono o que se ha eliminado de una cuenta de WhatsApp Business.
• Se ha añadido un nuevo valor de message_template_status_update.events: PENDING_DELETION. Indica que una plantilla de mensaje se ha marcado para su eliminación.

Las notificaciones de webhooks de ejemplo que se envían cuando se activan estos nuevos eventos son las siguientes:

• ACCOUNT_DELETED: cuenta de WhatsApp Business eliminada.
• PENDING_DELETION: plantilla de mensaje pendiente de eliminación.

Nuevos campos del nodo de cuenta de WhatsApp Business

Se han añadido los siguientes campos del nodo de cuenta de WhatsApp Business:

• country (se aplica a las versiones v15.0+)
• ownership_type (se aplica a las versiones v15.0+)
• business_verification_status (se aplica a todas las versiones)

Nuevos filtros del extremo de empresa

Se aplica a la versión 15.0 y posteriores.

Se han añadido las siguientes opciones de filtro al extremo de cuentas de WhatsApp Business de un cliente empresarial:

• Filtra por el campo creation_time de la cuenta de WhatsApp Business con los operadores GREATER_THAN, LESS_THAN o IN_RANGE.
• Filtra por el campo ownership_type de la cuenta de WhatsApp Business con los operadores EQUAL o IN.

Se han añadido las siguientes opciones de filtro al extremo de cuentas de WhatsApp Business que pertenecen a una empresa:

• Filtra por el campo creation_time de la cuenta de WhatsApp Business con los operadores GREATER_THAN, LESS_THAN o IN_RANGE.
• Filtra por el campo ownership_type de la cuenta de WhatsApp Business con los operadores EQUAL o IN.
• Filtra por el campo country de la cuenta de WhatsApp Business con los operadores EQUAL o IN.

Nuevos campos del nodo de número de teléfono

Se aplica a la versión 15.0 y posteriores.

Se han añadido los siguientes campos del nodo de número de teléfono de WhatsApp Business:

• is_official_business_account
• messaging_limit_tier

Además, puedes filtrar el extremo de números de teléfono de la cuenta de WhatsApp Business por is_official_business_account.

3 de noviembre de 2022

Mensajes por segundo

Ahora la API de nube admite un máximo de 500 (anteriormente admitía 350 como máximo) mensajes por segundo (mps) de mensajes de texto y multimedia combinados. Para ello, se necesita una solicitud previa. Consulta Rendimiento para obtener más información.

Si ya tienes 350 mps, se aumentará a 500 mps automáticamente. Si ya has solicitado 350 mps, pero el proceso no ha finalizado, recibirás 500 mps en cuanto finalice.

Almacenamiento en caché HTTP de contenido multimedia

En este momento, estamos llevando a cabo las pruebas beta del almacenamiento en caché HTTP de contenido multimedia de la API de nube. Si eres un socio de soluciones, consulta Almacenamiento en caché HTTP de contenido multimedia para obtener información sobre cómo usar los encabezados de las respuestas del servidor a fin de indicarnos que almacenemos en caché tus activos de contenido multimedia para reutilizarlos en futuros mensajes.

Textos en documentos

La API de nube ahora admite textos en documentos intercambiados con los clientes. Consulta la documentación sobre el objeto Media en la referencia del contenido multimedia.

25 de octubre de 2022

Aumento del límite de plantillas de mensajes

Las cuentas de WhatsApp Business ahora pueden tener un máximo de 6000 plantillas de mensajes si la empresa principal se ha verificado y al menos una de las cuentas de WhatsApp Business de dicha empresa tiene un número de teléfono de empresa con un nombre para mostrar aprobado.

Como parte de este cambio, las versiones traducidas de una plantilla de mensaje ahora se tienen en cuenta para el límite de plantillas de una cuenta de WhatsApp Business.

20 de octubre de 2022

Facturación

Las empresas de la India ahora pueden usar una tarjeta de crédito para pagar los mensajes que envíen mediante la plataforma. Consulta Añadir una tarjeta de crédito a tu cuenta en la Plataforma de WhatsApp Business.

12 de octubre de 2022

Migración de números de teléfono de empresa

Ahora puedes migrar un número de teléfono de empresa con las cuentas de WhatsApp Business de la API de nube como origen y destino. Consulta Migrar un número de teléfono a otra cuenta WABA.

6 de octubre de 2022

Anulación de la devolución de llamada

Solo en la API de nube.

Ahora puedes usar URL de devolución de llamada diferentes para cada cuenta de WhatsApp Business sin tener que crear una aplicación única para cada una de ellas. Consulta Anular la URL de devolución de llamada para obtener más información.

Llamadas de la versión 15

Todos los extremos de la API de nube ahora admiten las llamadas de la versión 15.

Plantillas de mensajes

Solo en la API de nube.

Los parámetros de texto (components.parameters.text) de las plantillas de mensajes que solo usen un componente de cuerpo (components.type:body) ahora pueden tener un máximo de 32 768 caracteres. Consulta la documentación sobre el objeto Parameters.

Mensajes por segundo

Solo en la API de nube.

Ahora la API de nube admite un máximo de 350 (anteriormente admitía 250 como máximo) mensajes por segundo (mps) de mensajes de texto y multimedia combinados. Para ello, se necesita una solicitud previa. Consulta Rendimiento para obtener más información.

Si ya tienes 250 mps, se aumentará a 350 mps automáticamente. Si ya has solicitado 250 mps pero el proceso no ha finalizado, recibirás 350 mps en cuanto finalice.

API de nube: 22 de septiembre de 2022

Reacciones

Ahora se admiten las reacciones. Consulta Enviar mensajes: mensajes de reacción para obtener información sobre cómo enviar y recibir reacciones, y Ejemplos de cargas útiles: mensajes de reacción si quieres ver ejemplos de notificaciones de cargas útiles de webhooks.

Perfil de empresa

Ahora se admite el campo about en los perfiles de empresa. Consulta Perfiles de empresa para obtener más información.

API de nube: 7 de septiembre de 2022

Mensajes por segundo

Ya está disponible la documentación más reciente para solicitar la migración de 80 mensajes por segundo a 250 mensajes por segundo de envío y recepción combinados, tanto mensajes de texto como multimedia. Consulta Rendimiento.

API de nube: 25 de agosto de 2022

Stickers animados

Ahora puedes incluir stickers animados en los mensajes de salida iniciados por la empresa y recibir webhooks de mensajes en los que se describan los mensajes de la misma forma que lo harías si enviaras un sticker no animado. Consulta la propiedad sticker del objeto Message y los requisitos de los activos de los stickers animados.

Mensajes de productos

Ahora puedes incluir productos y servicios en los mensajes que envíes a los clientes, y los clientes pueden añadirlos a los carritos de la compra sin tener que salir de la conversación de chat. Consulta la guía para vender productos y servicios con el fin de obtener información sobre cómo enviar mensajes sobre un producto y sobre varios productos a los clientes.

API de nube: 21 de julio de 2022

Respuestas

Ahora las empresas pueden responder a cualquier mensaje en un hilo de conversación. Las respuestas tendrán una burbuja de contexto que hará referencia al mensaje al que se responde. Consulta la guía para enviar mensajes con el fin de obtener información sobre cómo responder a un mensaje.

Mensajes por segundo

Ahora la API de nube admite un máximo de 250 mensajes por segundo de envío y recepción combinados (incluidos mensajes de texto y multimedia). Para ello, se necesita una solicitud previa. Si eres socio empresarial, puedes crear una entrada de asistencia directa para solicitar un rendimiento de 250 MPS; para ello, selecciona el tema de preguntas “Problemas de la API de nube” y el tipo de solicitud “Solicitud para migrar a un rendimiento de 250 MPS” e introduce la información obligatoria.

Aviso para desarrolladores: Información sobre cambios incompatibles con versiones anteriores para las futuras versiones 2.43 y 2.45.

v2.43 11 de octubre de 2022

• A partir de la versión v2.43, se producirán cambios en el comportamiento del extremo contacts.

  • Las respuestas para status van a cambiar. Independientemente de si un usuario tiene WhatsApp, siempre devolverá valid para status en la respuesta y un wa_id. No hay ninguna garantía de que el valor de wa_id devuelto sea válido. Estos cambios son aplicables a ambas respuestas directas, así como a las respuestas del webhook para llamadas sin bloqueo.
  • Asegúrate de que el código evite basarse en los valores de status y wa_id que se devuelvan en el nodo contacts. Además, puedes completar el envío de un mensaje en la versión v2.39.1 o versiones posteriores sin llamar al nodo contacts.

• Asegúrate de que el código gestione un posible error 1013 (El usuario no es válido) al intentar enviar un mensaje de plantilla, el cual se devolverá si intentas enviar el mensaje de plantilla a un número de teléfono sin cuenta de WhatsApp.

• En el caso de los mensajes que no son de plantilla, enviar un mensaje a un número de teléfono sin cuenta de WhatsApp devolverá un error 470.

v2.45 10 de enero de 2023

• A partir de la versión v2.45, el parámetro opcional cert del nodo shards será obligatorio para todas las solicitudes. Actualiza la integración para incluir siempre un cert válido cuando llames al nodo shards.

• A partir de la versión v2.41.2, las empresas pueden usar el nodo application para filtrar y omitir los estados de mensaje enviado en los que no estén interesadas mediante el objeto message dentro del objeto webhooks. En la versión v2.45, se retirará sent_status, así que debes actualizar la integración para usar el objeto webhooks del nodo application para todos los controles del webhook.

• A partir de la versión v2.39.1, recipient_id está disponible en el objeto statuses y en el objeto message. En la versión v2.45, se eliminará recipient_id en el objeto statuses, así que debes actualizar la integración para usar recipient_id en el objeto message.

API local: 19 de septiembre de 2022 (v2.41.3)

Versión 2.41.3

La versión v2.41.3 del cliente de la API de WhatsApp Business incluye lo siguiente: adición de un nuevo índice de tabla en message_receipt_log que podría beneficiar a los socios con necesidades de alto rendimiento. Por ejemplo, esta mejora permite a los socios enviar más de 200 mensajes por segundo.

API local: 27 de junio de 2022 (v2.41.2)

Esta versión de cliente contiene las funciones y actualizaciones siguientes:

• Mejoras en la latencia de las solicitudes masivas al extremo /contacts y resolución de problemas de interbloqueo.
• Mejoras en el rendimiento y la fiabilidad del proceso de recolección de elementos no utilizados.
• Las empresas ahora pueden activar o desactivar las notificaciones de webhooks delivered y read, de forma que obtienen un mayor control sobre las notificaciones de webhooks para los mensajes. Para ello, deben usar el extremo settings/applications.
• El campo namespace es opcional para el objeto Template.
• Gestión más sólida de los errores de descarga de contenido multimedia, de forma que las empresas deberían tener menos problemas al descargar el contenido multimedia enviado por los clientes.
• Más correcciones de errores y fiabilidad en los procesos de registro y envío de mensajes.

API de nube de WhatsApp Business: 19 de mayo de 2022

A partir de hoy, la API de nube de WhatsApp Business está abierta para todos los desarrolladores que creen productos o servicios para ellos mismos o para sus organizaciones. Para empezar, consulta nuestra guía. Si te interesa ofrecer acceso a la API a tus clientes, únete a nuestra lista de espera.

API de administración de WhatsApp Business: 19 de mayo de 2022

Categorías de las plantillas de mensajes

Se han retirado los valores siguientes del parámetro category para el extremo /WHATSAPP-BUSINESS-ACCOUNT-ID/message_template para la versión v14.0 y posteriores:

Se han añadido los valores siguientes:

• TRANSACTIONAL
• MARKETING

API local de WhatsApp: 10 de mayo de 2022 (v2.39.4)

Esta versión del cliente incluye todas las funciones y correcciones publicadas con la versión v2.39.1. Además, esta versión:

• Corrige un error que impedía el envío de mensajes de vídeo en determinadas circunstancias. Esta corrección también se incluyó en la versión v2.39.2.
• Corrige un error que impedía a las empresas enviar mensajes a un cliente si este era el primero en iniciar una interacción entre ambas partes en WhatsApp, y dicho inicio se había producido hacía más de 7 días. Esta corrección también se incluyó en la versión v2.39.3.
• Corrige un error que impedía a las empresas recibir mensajes temporales de clientes. Una vez instalada la versión v2.39.4, las empresas obtendrán una notificación de webhooks con el tipo establecido en "ephemeral" cuando reciban un mensaje temporal. Las empresas no podrán ver el contenido del mensaje.

Cuando lanzamos la versión v2.39.3, WhatsApp gestionaba el problema de los mensajes temporales mediante la desactivación automática de estos mensajes en la conversación de chat con el cliente. En la versión v2.39.4, no realizaremos ese procedimiento. Con esta versión, las empresas que reciban mensajes temporales deben preguntar al cliente si quiere desactivar estos mensajes y volver a enviar el mensaje más reciente.

API local de WhatsApp: plantillas de AWS Service: 4 de mayo de 2022

Versión 2.3.8

URL de las plantillas

• Empresa: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent.yml?versionId=0pACuWHFUL7U1RjxGcTkAsza7rj._5tK
• Base de datos: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_db.yml?versionId=4BtYzof0_z0yl7Pbat9mln8Xj5CYS07Z
• Lambda: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_lambda.yml?versionId=o1JUcpuOHKfTU_hRExFxhib5YCeXeZx.
• Red: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_net.yml?versionId=_D2yaFcS1zEqRLf23t2Wesnh3M.Qw1UF
• Supervisión: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_monitoring.yml?versionId=H534ejFNiHnMpWyy1ERh3kr9TvM5VtyS

Registro de cambios

• Actualización de las AMI para ordenadores CentOS 7

API de nube: 3 de mayo de 2022

A partir de hoy, la API de nube incluye las actualizaciones siguientes:

• Se ha corregido un problema relacionado con mensajes temporales de los usuarios.
• Se ha mejorado la calidad de las miniaturas de los mensajes multimedia.

API local de WhatsApp: plantillas de AWS Service: 26 de abril de 2022

Versión 2.3.7

URL de las plantillas

• Empresa: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent.yml?versionId=bNECfwPYZZNGlhzkfCyheoQugydIiui4
• Base de datos: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_db.yml?versionId=RRa0vGtuodHnWNyww8uLyZUAWFOfQ7hN
• Lambda: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_lambda.yml?versionId=Sp2BO2LgxkVWH2XTxZ6pgOx3yf1xEqUQ
• Red: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_net.yml?versionId=uNubDzGLs1WddCGB0EgEa6OMSF1vw4Mn
• Supervisión: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent_monitoring.yml?versionId=HyC5PA5IZy9d.CFDkNTGDBEyxSHf5gHI

Registro de cambios

• Se ha pasado de usar pip a usar pip3 para instalar los scripts de arranque de AWS.
• Se ha corregido un problema con la instalación de awscli.

API de nube: 5 de abril de 2022

A partir de hoy, la API de nube está disponible con carácter general para todos los socios de soluciones y clientes directos existentes. Asimismo, vamos a lanzar las funciones siguientes para los desarrolladores de la API de nube:

• Mensajes con stickers: envío de mensajes multimedia con stickers estáticos de terceros. Consulta la documentación siguiente para obtener más información: Referencia, Mensajes y Referencia, Contenido multimedia. Admitimos stickers de entrada y de salida. En el caso de los stickers de salida, solo admitimos los stickers estáticos de terceros. En el caso de los stickers de entrada, admitimos todos los tipos.
• API para anular el registro de un número de teléfono: realiza llamadas POST a PHONE_NUMBER_ID/deregister para eliminar un número de teléfono de la API de WhatsApp Business. Consulta Registro para obtener más información.
• Nueva opción para la verificación del teléfono: verifica tu número de teléfono de la empresa mediante llamadas a la API Graph. Consulta Números de teléfono para obtener más información.
• Nuevos webhooks de referencia: recibe notificaciones de webhooks cuando un usuario haga clic en un anuncio que permita acceder a WhatsApp y enviar un mensaje a la empresa. Consulta Webhooks para obtener más información. Ten en cuenta que el objeto referral de los webhooks de la API de nube es distinto del objeto referral de la API local.

Asimismo, anunciamos que la revisión de la aplicación ya no será obligatoria para los desarrolladores de la empresa que usen la API de nube. Todos los desarrolladores están sujetos a los límites de mensajes de la Plataforma de WhatsApp Business.

API local: 26 de marzo de 2022

Esta versión incluye las mismas funciones que v2.37.1, pero tiene una fecha de caducidad diferente. La versión v2.37.2 caduca el 22 de septiembre de 2022.

Problemas conocidos

Es posible que algunos desarrolladores de Kubernetes vean el evento CrashLoopBackOff para el contenedor de la aplicación web y que se produzca un error al iniciar dicho contenedor. Para solucionar este problema, añade la línea siguiente en el archivo YML de implementación de Kubernetes, concretamente en la configuración de la aplicación web:

command: ["/opt/whatsapp/bin/wait_on_mysql.sh", "/opt/whatsapp/bin/launch_within_docker.sh"]

API local: 25 de marzo de 2022

La versión v2.39.3 del cliente de la API de WhatsApp Business está disponible a partir de hoy para desarrolladores. El nuevo cliente incluye dos correcciones y registros adicionales para respaldar la depuración. Las dos correcciones son:

• Se ha corregido un error que impedía a las empresas enviar mensajes a un cliente si este era el primero en iniciar una interacción entre ambas partes en WhatsApp, y dicho inicio se había producido hacía más de 7 días.
• Se ha corregido un error que impedía a las empresas recibir mensajes temporales de clientes. Una vez instalada la versión 2.39.3, las empresas obtendrán una notificación de webhooks cuando reciban un mensaje temporal. Por otro lado, los clientes verán una advertencia que les indicará que el modo de mensajes temporales se ha desactivado.

API de nube: 15 de marzo de 2022

Mensajes de lista y botones de respuesta

A partir de hoy, los usuarios de la versión beta de la API de nube pueden empezar a enviar mensajes de lista y botones de respuesta. Consulta la documentación siguiente para obtener más información:

• Referencia, Mensajes
• Webhooks: Mensajes de lista y Botón de respuesta
• Webhooks, Componentes

URL de vista previa

A partir de hoy, los usuarios de la versión beta de la API de nube pueden añadir una casilla de URL de vista previa a los mensajes de texto que incluyan una URL. Consulta la documentación siguiente para obtener más información:

• Referencia, Mensajes

Nuevas guías de documentación

• Migrar entre la API local y la API de nube

API local: 4 de marzo de 2022

Acabamos de lanzar la versión v2.39.2 de la API local. Esta versión corrige un error que impedía el envío de mensajes de vídeo en determinadas circunstancias.

Problemas conocidos

• Hay un error que impide a las empresas enviar mensajes a un cliente si este ha sido el primero en iniciar una interacción entre ambas partes en WhatsApp, y dicho inicio se produjo hace más de 7 días.
• Hay un error que impide a las empresas recibir mensajes temporales de clientes.

API de nube: 1 de marzo de 2022

Mensajes de vídeo

A partir de hoy, los usuarios de la versión beta de la API de nube pueden empezar a enviar y recibir mensajes de vídeo. Encontrarás más información en la documentación siguiente:

• Contenido multimedia, Subir contenido multimedia
• Tipos de contenido multimedia admitidos
• Mensajes, Ejemplos, Mensajes multimedia
• Webhooks, Componentes

1 de febrero de 2022

Plataforma de WhatsApp Business

A partir de hoy, WhatsApp ha cambiado de un modelo de precios basado en notificaciones a otro basado en conversaciones. Se cobra a los negocios por conversación, lo que incluye todos los mensajes entregados en una sesión de 24 horas. Consulta Precios basados en conversaciones para obtener información.

API de nube

Mensajes de contacto y ubicación

A partir de hoy, los usuarios de la versión beta de la API de nube pueden empezar a enviar y recibir mensajes de contacto y ubicación. Consulta la documentación siguiente para obtener más información:

• Referencia, Mensajes: Ubicación y Contactos
• Webhooks, Ejemplos: Mensajes recibidos

Actualización del rendimiento máximo

Ahora admitimos un rendimiento máximo por número de teléfono de 80 mensajes por segundo. Esto incluye los mensajes de entrada y de salida, así como los mensajes de texto, de plantilla y multimedia.

API local (2.39.1)

La versión 2.39.1 del cliente de la API de WhatsApp Business está disponible a partir de hoy para desarrolladores. El nuevo cliente incluye lo siguiente:

• Un nuevo campo para la API de definición de particiones.
• Un nuevo nombre de host añadido a los requisitos de red.
• Un nuevo código de error (1031).
• Las retiradas del tipo hsm y la configuración de la aplicación webhook_payload_conversation_pricingmodel_disabled.

API de definición de particiones

A partir de la nueva versión del cliente de la API, puedes proporcionar el certificado del teléfono al configurar la conexión múltiple. Esto significa que, al llamar al extremo /v1/account/shards, puedes añadir el certificado codificado mediante Base64 en el campo de certificado. Consulta Escalar el cliente de la API con la conexión múltiple para obtener más información.

Nuevo nombre de host

Hemos añadido el nombre de host graph.whatsapp.com a la lista de nombres de host de los servidores de WhatsApp con los que necesita conectividad el cliente de la API de WhatsApp Business. Consulta Configurar y depurar la red, Nombres de host para obtener más información.

Actualizaciones de los códigos de error

Con la versión v2.39, hemos añadido el código de error 1031. Obtendrás este error si tu cuenta se ha bloqueado y no puedes enviar mensajes debido a una infracción de la política de integridad. Consulta Mensajes de error y estado y Aplicación de políticas para obtener más información.

Retiradas

• API de mensajes: el tipo hsm se ha retirado con la versión v2.39. Debes utilizar el tipo template en su lugar.
• Configuración de la aplicación: la configuración de la aplicación webhook_payload_conversation_pricingmodel_disabled se ha retirado.

Problemas conocidos

Se produce un error al enviar algunos mensajes de vídeo en determinadas circunstancias.