Registro de cambios

En este documento, se registran los cambios en la plataforma de WhatsApp Business.

5 de noviembre de 2024

Todas las API

• Se agregó el punto de conexión POST /<BUSINESS_PORTFOLIO_ID>/self_certify_whatsapp_business para verificación de negocio liderada por los socios.

11 de octubre de 2024

API de administración comercial

• Se agregó el punto de conexión POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>/set_solution_migration_intent para agregar una 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 la nube

• A partir de la versión 21.0, los parámetros package_name y signature_hash se deben definir dentro de la matriz supported_apps cuando se crean plantillas de autenticación de tipo autocompletar con un toque y sin toque.
• 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 tener estado de no registrado y debes usar el punto de conexión POST /<WHATSAPP_BUSINESS_PHONE_NUMBER>/settings a fin de activar el almacenamiento local antes de registrar el número (en lugar de activarlo durante el registro). Para permitir la implementación de estos cambios:

  • Se agregó un parámetro storage_configuration al punto de conexión POST /<WHATSAPP_BUSINESS_PHONE_NUMBER>/settings, que se puede usar para activar o desactivar el almacenamiento local.
  • Se eliminó el parámetro data_localization_region del punto de conexión POST /<WHATSAPP_BUSINESS_PHONE_NUMBER>/register.

25 de septiembre 2024

API de la nube

• Se cambiaron los pasos en el panel de apps para que sea más fácil convertirse en proveedor de tecnología.

24 de septiembre 2024

API de la nube

• Se agregaron plantillas de botón "Finalizar compra" (solo disponibles en empresas de India que usan números de teléfono de la empresa con códigos de ese país).

11 de septiembre de 2024

API de la nube

• Se agregaron plantillas de mensajes de un solo producto.
• Se agregaron plantillas de secuencias de tarjetas de productos.

10 de septiembre de 2024

API de la nube

• Cambió el comportamiento de almacenamiento en caché de activos de contenido multimedia de definible por el desarrollador (mediante el encabezado de control de caché) a un intervalo fijo de 10 minutos. Sin embargo, sigues contando con la posibilidad de hacer que obtengamos activos de tu servidor, en lugar de nuestra memoria caché. Consulta Almacenamiento en caché de contenido multimedia.

6 de septiembre de 2024

API de la nube

• Se agregó acceso a activos comerciales de mensajes para tener un control más detallado del acceso a la cuenta de WhatsApp Business.
• Se agregó la posibilidad de crear soluciones de varios socios mediante el botón insertable.

1 de junio de 2024

API de la nube

• Se agregó la capacidad para establecer un tiempo de duración personalizado en las plantillas de utilidad.

API de administración comercial

• Se agregaron actualizaciones automáticas de categoría para corregir plantillas que se clasificaron de forma incorrecta según nuestras directrices.

10 de abril de 2024

API de la nube

• Se agregó la biblioteca de plantillas de utilidad.

10 de abril de 2024

API de la nube

• Se agregó una anulación de URL de devolución de llamada de webhook en números de teléfono del negocio.

18 de marzo de 2024

API de la nube

• Se agregó la API de componentes conversacionales.

13 de febrero de 2024

API de la nube

• Se limitaron los intentos de registro o anulación de registro del número de teléfono del negocio a 10 solicitudes por número de negocio en un intervalo de uso de 72 horas (anteriormente, el intervalo era de una semana).

6 de febrero de 2024

API de la nube, API de instalaciones locales

• Se agregaron límites de mensajes de plantillas de marketing por usuario para ayudar a ofrecer experiencias de usuario de alta calidad.

26 de enero de 2024

API de la nube

• El tiempo de duración de la entrega de mensajes de la plantilla de API de la nube cambió de 24 horas a 30 días. Puedes anular este valor en las plantillas de autenticación.
• Se cambió el máximo de caracteres de biz_opaque_callback_data de 256 a 512.

18 de enero de 2024

API de la nube

• Se agregaron componentes conversacionales.

18 de diciembre de 2023

API de la nube

• Se agregaron los mensajes de solicitud de ubicación.

12 de diciembre de 2023

API de administración comercial

• Se agregó el campo cta_url_link_tracking_opted_out en el nodo de la plantilla de mensaje de WhatsApp para habilitar/deshabilitar el seguimiento de clics en el botón.
• El análisis de plantillas ahora incluye clics en los botones de las plantillas categorizadas como UTILITY.

20 de noviembre de 2023

API de administración comercial

• Se agregó la función de registro de la consola para ayudar con la depuración de las plantillas de autenticación con un botón de un solo toque y sin toque.

14 de noviembre de 2023

API de la nube

• Se agregó el campo health_status a varios nodos para comprobar el estado general de los mensajes.
• Se agregó el campo biz_opaque_callback_data en los mensajes sin formato para incluir cadenas arbitrarias en los webhooks de mensajes.

3 de noviembre de 2023

API de administración comercial

• La creación de la plantilla de secuencia requiere ahora un botón, como mínimo.

23 de octubre de 2023

API de administración comercial, API de la nube, API de instalaciones locales

• Se agregaron los mensajes de autenticación sin toque.

10 de octubre de 2023

Procesos

• Ahora está disponible WhatsApp Flows.

API de la nube

• Se agregó el nuevo campo data_localization_region en el punto de conexión Número de teléfono de WhatsApp Business> Registro para activar el almacenamiento local.
• Se agregaron nuevos botones de URL de llamada a la acción relacionados con los mensajes interactivos sin formato.

4 de octubre de 2023

API de administración comercial, API de la nube, API de instalaciones locales

• Las plantillas de autenticación que usan la advertencia de caducidad de código ahora utilizan el valor code_expiration_minutes (en vez del predeterminado de 10 minutos) para determinar si el mensaje de plantilla entregada deberá mostrar un botón de relleno automático o un botón de copia de código.
• Los botones de relleno automático que se muestran en un mensaje de plantilla entregado se desactivarán una vez que transcurra el tiempo indicado en el valor code_expiration_minutes de la plantilla, si se incluyera (o después de 10 minutos, si no se estableció ningún valor).

2 de octubre de 2023

API de la nube

• Se agregaron nuevas plantillas de ofertas por tiempo limitado y el nuevo componente de plantilla limited_time_offer.

27 de septiembre de 2023

API de la nube

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

18 de septiembre de 2023

API de la nube, API de instalaciones locales

• Las plantillas de autenticación heredadas (plantillas de autenticación sin botones de contraseña de un solo uso) se pueden enviar, editar y apelar hasta el 1 de abril de 2024 (se extendió el plazo anterior, que originariamente era el 2 de octubre de 2023).

12 de septiembre de 2023

API de administración comercial

• Las respuestas de la solicitud GET en las plantillas de autenticación ahora incluyen los componentes de la plantilla add_security_recommendation y code_expiration_minutes en el valor component.
• Se agregaron nuevos niveles de acceso a la cuenta de WhatsApp Business, que brindan mayor control granular.
• Las solicitudes GET en Cuenta de WhatsApp Business > Número de teléfono y Cuenta de WhatsApp Business > Plantillas de mensaje devuelven ahora el código de error 200 si al usuario al que identifica el token no se le otorgó el acceso a la cuenta de WhatsApp Business correspondiente.
• Se agregó la función de migración de plantillas.

API de la nube

• Se agregaron los campos throughput y platform_type a los números de teléfono de WhatsApp Business.
• Se agregaron plantillas de secuencia.

API de la nube, API de instalaciones locales

• Si se migran números de teléfono del negocio que tienen conexiones múltiples y que ejecutan 2 o más fragmentos de la API de instalaciones locales a la API de la nube, se actualizan de manera automática los números para lograr un rendimiento de la API de la nube mayor.

28 de agosto de 2023

API de la nube, API de instalaciones locales

• Se agregó frecuencia de las plantillas (versión beta; solo disponible para determinados países).

15 de agosto de 2023

API de administración comercial

• Se agregó template_analytics (versión beta).

8 de agosto de 2023

Herramientas

• Se agregó el estado de almacenamiento localizado de la API de la nube a la página de estado de la API de WhatsApp Business.

API de administración comercial

• Se agregó el componente del botón "Copiar código" para que se pueda utilizar con las plantillas de código de cupón.
• Se aumentó el límite total de los componentes del botón de plantilla a 10. Los botones de respuesta rápida ahora pueden mezclarse con otros tipos de botones. También se incrementó el límite de botones de URL a 2.
• Se agregó la administración masiva de plantillas.
• Se agregaron vistas previas de plantillas para poder tener una vista previa del texto de la plantilla en varios idiomas.

Registro insertado

• Se agregó la posibilidad de desactivar la selección del número de teléfono en el inicio de sesión insertado.
• Se agregó el registro masivo/programático de números de teléfono comerciales.
• Se agregó el registro masivo de números de teléfono comerciales preverificados.
• Se agregó la posibilidad de compartir números de teléfono comerciales preverificados.

2 de agosto de 2023

API de administración comercial

• Los números de teléfono del negocio preverificados cuentan ahora con un estado VERIFIED de 28 días (a partir de 14).

11 de julio de 2023

API de la nube

• Si se desea programar y realizar un actualización de la capacidad de un número de teléfono de empresa, ya no es necesario realizar una llamada en vivo.
• Ahora, puedes especificar un horario de actualización cuando envías un ticket de asistencia directa para solicitar la actualización de la capacidad de un número de teléfono de empresa.
• El tiempo de inactividad de los números de teléfono de empresa durante la actualización de la capacidad se redujo a 5 minutos o menos.

7 de julio de 2023

Administración comercial

• El texto del botón de copia de código y el texto del botón de relleno automático de la plantilla de autenticación ahora son opcionales durante el proceso de creación.

13 de junio de 2023

Herramientas

• Se agregó latencia a la página de estado de la API de WhatsApp Business

Administración comercial

• Se agregó el código de error 2494100 de la API de administración de WhatsApp Business, que indica que el número de teléfono de la empresa se encuentra temporalmente en modo de mantenimiento.

API de la nube

• Se agregó la función de comprobación de cambio de identidad.
• Se agregaron mensajes de catálogo.
• Se agregaron plantillas de catálogo.

26 de mayo de 2023

Herramientas

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

23 de mayo de 2023

API de la nube

• Al intentar enviar una plantilla en pausa en un mensaje de plantilla con la versión 17 o una posterior, ahora se devuelve el código de error 132015, en lugar del 132001.
• Al intentar enviar una plantilla desactivada en un mensaje de plantilla con la versión 17 o una posterior, ahora se devuelve el código de error 132016, en lugar del código 132001.

API de instalaciones locales

• Al intentar enviar una plantilla en pausa en un mensaje de plantilla, ahora se devuelve el código de error 2061.
• Al intentar enviar una plantilla desactivada en un mensaje de plantilla, ahora se devuelve el código de error 2062.

9 de mayo de 2023

API de administración comercial

• Se agregaron plantillas de mensajes multiproducto.

API de la nube

• Se agregaron los pagos con Stripe (solo en Singapur).
• Se agregaron los mensajes de dirección para solicitar direcciones de clientes (solo en Singapur e India).
• Se agregó un volumen de 1.000 mensajes por segundo.

API de instalaciones locales

• Se agregaron los pagos con Stripe (solo en Singapur).
• Se agregaron los mensajes de dirección para solicitar direcciones de clientes (solo en Singapur e India).

1 de mayo de 2023

API de administración comercial

• Se agregaron nuevos webhooks que te notifican sobre los rechazos de los aumentos del límite de mensajes en el campo de webhooks account_alerts.
• Ahora, todas las categorías se deben categorizar como AUTHENTICATION, MARKETING o UTILITY.

26 de abril de 2023

API de administración comercial

• Se agregó el campo hsm_id para ELIMINAR el punto de conexión Cuenta de WhatsApp Business > Plantillas de mensaje. Si se incluye, elimina una sola 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 la nube

• Se agregó last_onboarded_time al nodo de número de WhatsApp Business. Indica cuando un usuario creó un número de teléfono de empresa en su cuenta de WhatsApp Business al completar el proceso de registro integrado.

11 de abril de 2023

API de la nube

• Se agregó el punto de conexión Número de teléfono de WhatsApp Business > Información sobre cumplimiento de la empresa para agregar o actualizar la información sobre cumplimiento de los números de teléfono de empresas radicadas en India.

Registro insertado

• Se agregaron los siguientes puntos de conexión a fin de admitir números de teléfono de negocios previamente verificados vinculados a usuarios del registro insertado:

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

4 de abril de 2023

API de administración comercial, API de la nube, API de instalaciones locales

• La migración de la primera categoría de plantilla está completa.
• La validación de categorías ahora es parte del proceso de revisión de las nuevas plantillas creadas. Se aplica a las versiones 16.0 y posteriores.
• Las respuestas de la API a las solicitudes de creación o edición de plantillas incluyen ahora el estado y la categoría de la plantilla. Se aplica a todas las versiones.
• Se agregó el parámetro allow_category_change al punto de conexión POST Cuenta de WhatsApp Business > Plantillas de mensajes.
• Se agregó INCORRECT_CATEGORY como nuevo reason de rechazo en los webhooks de estado de la plantilla.
• Las planillas que se basan en variables ahora requieren valores de muestra durante la creación o edición. Se aplica a todas las versiones.
• Se agregó el campo previous_category a Plantillas de mensajes de WhatsApp.
• Las conversaciones iniciadas por la empresa ya no cumplen con los requisitos para conversaciones en período gratuito. Si tu cuenta de WhatsApp Business depende de los servicios de un socio de soluciones o un socio de Meta, estarás exento de estos cambios hasta el 1 de junio de 2023.

17 de marzo de 2023

API de administración comercial

• Se agregó un nuevo campo de suscripción de webhooktemplate_category_update. Si te suscribes a este campo, cada vez que la categoría de una plantilla cambie, recibirás un webhook que te informará sobre la categoría anterior y la nueva de la plantilla.
• Las respuestas de la API a las solicitudes de creación y edición de plantillas incluyen ahora el estado y la categoría de la plantilla.

14 de marzo de 2023

API de la nube

• Ahora puedes compartir la información de ubicación con los usuarios mediante un encabezado de ubicación en la plantilla.

API de instalaciones locales

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

1 de marzo de 2023

API de la nube, API de instalaciones locales

• Al migrar un número de teléfono radicado en India de la API de instalaciones locales a la API de la nube, ya no se eliminan los datos de cumplimiento de ventas online, por lo que ya no es necesario completar estos datos de forma manual después de la migración.

15 de febrero de 2023

API de administración comercial

• Se agregó un nuevo punto de conexión de comparación de plantillas que permite comparar recuentos de envío de plantillas y relaciones de bloqueo.

3 de febrero de 2023

API de la nube, API de instalaciones locales

• Se agregó un nuevo punto de conexión Número de teléfono de WhatsApp Business > Configuración de comercio para habilitar o inhabilitar el carrito de compras y el catálogo de productos en números de teléfono de empresa individuales. Consulta Establecer la configuración comercial para la API de la nube y Establecer la configuración comercial para la API de instalaciones locales si deseas conocer las instrucciones de uso y descubrir de qué manera estas configuraciones pueden ayudarte a vender productos y servicios.

2 de febrero de 2023

API de administración empresarial, API de la nube

• Ya se encuentra disponible la versión 16 de la API Graph. Como parte de esta versión, se introdujeron cambios en las categorías de plantillas de mensajes, las respuestas de error de las API y los webhooks.

API de la nube

• Las plantillas que se creen o editen con la versión 16 ahora deben tener alguna de las siguientes categorías, ya que todas las demás se dejaron de admitir. Aplica a la versión 16 y posteriores de la API de la nube. Se implementará en todas las versiones el 1 de mayo de 2023. Este cambio se incorporó como respaldo al cambio del 1 de junio de 2023, cuando se pasará a usar un nuevo modelo de precios basado en conversaciones.

  • AUTHENTICATION
  • MARKETING
  • UTILITY
• Los subcódigos de error, que se utilizan con muy poca frecuencia y no son confiables, ya no se incluirán en las respuestas de las versiones 16.0 y posteriores. En cambio, debes usar code y details.
• El código de error 100 ("code":100) tenía varios títulos únicos que indicaban la naturaleza de un error 100 determinado. Ahora, todos los códigos de error 100 tendrán como título Invalid parameter. Los títulos antiguos que describían la naturaleza de un código de error 100 determinado se trasladaron a la propiedad details. Este cambio también se refleja en las cargas útiles de webhooks, que describen una respuesta a un código de error 100.

Solo se aplica a los webhooks de la API de la nube

• El objeto errors de los webhooks que en la versión 16.0 y posteriores se activa por errores de solicitud incluye ahora las propiedades message y error_data.details, y los valores title cambiaron a múltiples códigos de error. Ahora, los objetos errors tienen la siguiente estructura y los siguientes datos:

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

• El valor de la propiedad title se actualizó en relación con los siguientes códigos de error. Su valor anterior ahora aparece en error_data.details.

  • El nuevo título de 130470 es Re-engagement message
  • El nuevo título de 130429 es Rate limit hit
  • El nuevo título de 131045 es Incorrect certificate
  • El nuevo título de 131031 es Business Account locked
  • El nuevo título de 131053 es Media upload error
  • El nuevo título de 131027 es Something went wrong
  • El nuevo título de 131042 es Business eligibility payment issue
  • El nuevo título de 131026 es Message Undeliverable
  • El nuevo título de 131000 es Something went wrong
• El valor de la propiedad message es el mismo valor que el de la propiedad title, que indica el título del código de error. Esta propiedad se asigna a la propiedad message en Cargas de respuesta de errores de la API.
• La propiedad error_data.details ahora incluye títulos de código de error que se encuentran entre los que se mencionan más arriba y describe la causa subyacente del error. Este valor se asigna a la propiedad details en las cargas de respuesta de errores de la API.

Estos cambios se ven reflejados en las siguientes propiedades 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 la nube

Las empresas no verificadas ahora pueden iniciar hasta 250 conversaciones en un período continuo de 24 horas.

13 de diciembre de 2022

Verificación de permisos de contenido multimedia

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

Se agregó el nuevo campo phone_number_id opcional al punto de conexión de contenido multimedia. Si incluyes este parámetro y un identificador del número de la 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 con el que se subió el contenido multimedia.

8 de diciembre de 2022

Almacenamiento de contenido multimedia en caché HTTP

El almacenamiento de contenido multimedia en caché HTTP de la API de la nube ya no está en versión beta y está disponible para todos.

Webhooks

La API de la nube volverá a intentar entregar las notificaciones de webhooks fallidas por hasta 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 agregó un nuevo campo template_performance_metrics. Notifica de forma semanal las métricas de rendimiento de la plantilla, incluidos los conteos de mensajes enviados y abiertos, y los motivos principales 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 agregó un nuevo campo account_alerts. Te notifica sobre las alertas de negocios, cuentas de WhatsApp Business y números de teléfono de negocios.

Nuevos valores del campo account_update:

• Se agregó un nuevo valor posible para account_update.events: ACCOUNT_DELETED. Indica que el número de teléfono se registró o se eliminó de una cuenta de WhatsApp Business.
• Se agregó un nuevo valor posible para message_template_status_update.events: PENDING_DELETION. Indica que se seleccionó la plantilla de mensaje para eliminarla.

Ejemplo de notificaciones de webhook que se envían cuando se activan estos nuevos eventos:

• ACCOUNT_DELETED: Cuenta de WhatsApp Business eliminada
• PENDING_DELETION: Eliminación del mensaje de plantilla pendiente

Nuevos campos en el nodo de cuenta de WhatsApp Business

Se agregaron los siguientes campos al nodo de cuenta de WhatsApp Business:

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

Nuevos filtros de punto de conexión del negocio

Se aplica a la versión 15.0 y posteriores.

Se agregaron las siguientes opciones de filtro al punto de conexión de las cuentas de WhatsApp Business del cliente del negocio.

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

Se agregaron las siguientes opciones de filtro al punto de conexión de las cuentas de WhatsApp Business propias del negocio.

• Filtrar por creation_time de la cuenta de WhatsApp Business mediante los operadores GREATER_THAN, LESS_THAN o IN_RANGE.
• Filtrar por ownership_type de la cuenta de WhatsApp Business mediante los operadores EQUAL o IN.
• Filtrar por country de la cuenta de WhatsApp Business mediante los operadores EQUAL o IN.

Nuevos campos de nodos de número de teléfono

Se aplica a la versión 15.0 y posteriores.

Se agregaron los siguientes campos al nodo de número de WhatsApp Business:

• is_official_business_account
• messaging_limit_tier

Asimismo, puedes filtrar el punto de conexión de los números de teléfono de la cuenta de WhatsApp Business utilizando is_official_business_account.

3 de noviembre de 2022

Mensajes por segundo

Ahora, la API de la nube admite hasta 500 mensajes (antes se admitían 350) por segundo (mps), a pedido. Esto incluye tanto los mensajes de texto como los mensajes con contenido multimedia. Consulta Rendimiento para obtener información detallada.

Si ya cuentas con 350 mensajes por segundo, la cantidad aumentará automáticamente a 500. Si ya solicitaste 350 mensajes por segundo, pero no se completó aún el proceso, recibirás 500 mensajes por segundo cuando finalice dicho proceso.

Almacenamiento de contenido multimedia en caché HTTP

Estamos probando la versión beta del almacenamiento de contenido multimedia de la API de la nube en caché HTTP. Si eres socio de soluciones, consulta Almacenamiento en caché HTTP para obtener información sobre cómo usar encabezados en las respuestas del servidor en las que se nos solicita almacenar en caché los activos del contenido multimedia para usarlos en mensajes futuros.

Descripción de documentos

La API de la nube ahora admite descripciones en los documentos que enviamos a nuestros clientes y que recibimos de ellos. Consulta Objeto de contenido multimedia en la referencia Contenido multimedia.

25 de octubre de 2022

Aumento del límite de plantillas de mensajes

Ahora, las cuentas de WhatsApp Business pueden tener hasta 6.000 plantillas de mensajes, si la empresa principal está verificada y al menos una de las cuentas de WhatsApp Business de esta empresa tiene un número de teléfono del negocio con un nombre para mostrar aprobado.

Como parte de este cambio, las versiones traducidas de una plantilla de mensajes se descuentan ahora del límite de plantillas de las cuentas de WhatsApp Business.

20 de octubre de 2022

Facturación

Ahora, las empresas de la India pueden usar una tarjeta de crédito para pagar por los mensajes enviados mediante la plataforma. Consulta Agregar una tarjeta de crédito a la cuenta de la plataforma de WhatsApp Business.

12 de octubre de 2022

Migración del número de teléfono de una empresa

Ahora, puedes migrar el número de teléfono de una empresa a las cuentas de WhatsApp Business de la API de la nube o desde estas cuentas. Consulta Migrar un número de teléfono a una WABA diferente.

6 de octubre de 2022

Reemplazo de la devolución de llamada

Solo se aplica a la API de la nube.

Ahora, puedes usar diferentes URL de devolución de llamada para las cuentas de WhatsApp Business sin tener que crear una app única para cada cuenta. Consulta Reemplazar la URL de devolución de llamada para obtener información detallada.

Llamadas de la versión 15

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

Plantillas de mensajes

Solo se aplica a la API de la nube.

Ahora, los parámetros de texto (components.parameters.text) de las plantillas de mensajes que solo usan un componente en el cuerpo (components.type:body) pueden sumar un total de 32.768 caracteres. Consulta Objeto Parameters.

Mensajes por segundo

Solo se aplica a la API de la nube.

Ahora, la API de la nube admite hasta 350 mensajes (antes se admitían 250) por segundo (mps), a pedido. Esto incluye tanto los mensajes de texto como los mensajes con contenido multimedia. Consulta Volumen para obtener información detallada.

Si ya cuentas con 250 mensajes por segundo, la cantidad aumentará automáticamente a 350. Si ya solicitaste 250 mensajes por segundo, pero no se completó aún el proceso, recibirás 350 mensajes por segundo cuando finalice dicho proceso.

API de la 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 carga, mensajes de reacción para ver ejemplos de notificaciones de cargas del webhook.

Perfil de empresa

Ahora, se admite el campo about en los perfiles de empresa. Consulta Perfiles de empresa para obtener información detallada.

API de la 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. Este límite incluye tanto los mensajes enviados como los recibidos y tanto los de texto como los multimedia. Consulta Rendimiento.

API de la nube: 25 de agosto de 2022

Stickers animados

Ahora, puedes incluir stickers animados en los mensajes salientes iniciados por la empresa y recibir webhooks de mensajes que describan esos mensajes de la misma manera que enviando un sticker no animado. Consulta la propiedad sticker del objeto Message para conocer los requisitos sobre el recurso de sticker animado.

Mensajes de productos

Ahora, puedes incluir productos y servicios en los mensajes que envías a tus clientes, quienes pueden agregarlos a los carritos de compra sin necesidad de salir del chat. Consulta la guía Vender productos y servicios para aprender a enviar mensajes con un solo producto o varios productos a tus clientes.

API de la nube: 21 de julio de 2022

Respuestas

Ahora, las empresas pueden responder cualquier mensaje en un hilo de conversación. Las respuestas incluirán una burbuja contextual que hará referencia al mensaje respondido. Consulta la guía Enviar mensajes para aprender a responder un mensaje.

Mensajes por segundo

Ahora, la API de la nube admite hasta 250 mensajes por segundo a pedido. Este límite incluye tanto los mensajes enviados como los recibidos y tanto los de texto como los multimedia. Si eres socio empresarial, puedes abrir un ticket de asistencia directa para solicitar un rendimiento de 250 MPS. Para ello, en "Tema de la pregunta:" selecciona "Problemas de la API de la nube" y en "Tipo de solicitud:", "Solicitar migración a rendimiento de 250 MPS", e introduce la información necesaria.

Aviso a los desarrolladores: se anuncian cambios de incompatibilidad con versiones anteriores para las futuras versiones 2.43 y 2.45.

v2.43 11 de octubre de 2022

• A partir de la v2.43, habrá cambios en el comportamiento del punto de conexión contacts:

  • Cambiarán las respuestas de status. Independientemente de que un usuario cuente con WhatsApp, siempre se devolverá en la respuesta el statusvalid y un wa_id. No se puede garantizar que el wa_id que se devuelve sea válido. Estos cambios se aplican a las respuestas directas y a las de los webhooks de las llamadas sin bloqueo.
  • Asegúrate de que el código no dependa de los valores de status y wa_id que se devuelven en el nodo contacts. Asimismo, en la v2.39.1 o posteriores, es posible enviar un mensaje sin la necesidad de llamar al nodo contacts.

• Asegúrate de que el código identifique el error potencial 1013Usuario no válido cuando se intente enviar un mensaje de plantilla, que se devolverá si intentas enviar un mensaje de plantilla a un número de teléfono que no tenga una cuenta de WhatsApp.

• En el caso de los mensajes sin plantillas, se devolverá un error 470 si se envía un mensaje a un número de teléfono que no tenga una cuenta de WhatsApp.

v2.45 10 de enero de 2023

• A partir de la v2.45, será obligatorio incluir en todas las respuestas el parámetro opcional cert en el nodo shards. Actualiza la integración para que incluya siempre un cert válido cuando se realiza la llamada al nodo shards.

• A partir de la v2.41.2, las empresas pueden usar el nodo application para filtrar el estado de los mensajes enviados que no les interesan mediante el objeto message dentro del objeto webhooks. En la v2.45, sent_status quedará obsoleto, por lo que es necesario actualizar la integración para que use el objeto webhooks en el nodo application en todos los controles del webhook.

• A partir de la v2.39.1, recipient_id está disponible en los objetos statuses y message. En la v2.45, se eliminará recipient_id en el objeto statuses, por lo que es necesario actualizar la integración para usar recipient_id en el objeto message.

API de instalaciones locales: 19 de septiembre de 2022 (v2.41.3)

Versión 2.41.3

En la versión v2.41.3 de nuestro cliente de la API de negocios, se incluye un nuevo índice de tabla en message_receipt_log que podría beneficiar a los socios que necesitan tener un alto rendimiento. Por ejemplo, esta mejora permite a los socios enviar más de 200 mensajes por segundo.

API de instalaciones locales: 27 de junio de 2022 (v2.41.2)

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

• Mejoras en la latencia de las solicitudes masivas del punto de conexión /contacts y resolución de errores de bloqueo.
• Mejoras en el rendimiento y la confiabilidad del proceso de recolección de elementos no utilizados .
• Las empresas ahora tienen la capacidad de activar y desactivar las notificaciones de webhooks delivered y read. Esto les da un mayor control de estas notificaciones en los mensajes. Esto se puede lograr mediante el punto de conexión settings/applications.
• El campo namespace es opcional en el objeto de plantilla.
• Procesamiento más eficaz de los errores de descarga de contenido multimedia para que las empresas tengan menos problemas al descargar el contenido multimedia que envían los clientes.
• Otras correcciones de errores y de confiabilidad dentro de los procesos de trabajo de envío de mensajes y registro

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

A partir de hoy, la API de la nube de WhatsApp Business se encuentra abierta para todos los desarrolladores que crean productos o servicios para sí mismos o sus organizaciones. Para comenzar, consulta nuestra guía. Si tienes interés en ofrecer a tus clientes acceso a la API, únete a nuestra lista de espera.

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

Categorías de plantillas de mensajes

Los siguientes valores del parámetro category del punto de conexión /WHATSAPP-BUSINESS-ACCOUNT-ID/message_template dejaron de estar disponibles en la v14.0 y versiones posteriores:

Se agregaron los siguientes valores:

• TRANSACTIONAL
• MARKETING

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

Esta versión del cliente contiene todas las funciones y correcciones incluidas en la versión v2.39.1. Además, esta versión realiza las siguientes acciones:

• Corrige el error que provocaba que los mensajes de video no se enviaran en determinadas situaciones. 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 había iniciado la interacción entre las dos partes en WhatsApp y si lo había hecho con más de 7 días de anterioridad. 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. Después de instalar la versión v2.39.4, las empresas recibirán una notificación de webhooks en la que se les indicará que recibieron un mensaje temporal con el tipo configurado en "ephemeral". Las empresas no podrán ver el contenido del mensaje.

Cuando lanzamos la versión v2.39.3, WhatsApp solucionaba el problema de los mensajes temporales y los deshabilitaba automáticamente en el hilo de chat con el cliente. En la versión v2.39.4, no haremos lo mismo. En esta versión, las empresas que reciben mensajes temporales deben pedir al cliente que los inhabilite y vuelva a enviar el último mensaje.

API de instalaciones locales de WhatsApp: Plantillas del servicio AWS: 4 de mayo de 2022

Versión 2.3.8

URL de las plantillas

• Empresas: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent.yml?versionId=0pACuWHFUL7U1RjxGcTkAsza7rj._5tK
• Bases 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.
• Redes: 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 AMI para equipos CentOS 7

API de la nube: 3 de mayo de 2022

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

• Se corrigió un problema relacionado con la desaparición de mensajes de usuarios.
• Se mejoró la determinación de la calidad de las imágenes en miniatura de los mensajes multimedia.

API de instalaciones locales de WhatsApp: Plantillas de AWS: 26 de abril de 2022

Versión 2.3.7

URL de las plantillas

• Empresas: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa_ent.yml?versionId=bNECfwPYZZNGlhzkfCyheoQugydIiui4
• Bases 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
• Redes: 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 pasó de usar pip a pip3 para instalar los scripts de arranque de AWS.
• Se corrigió un error en la instalación de AWS CLI.

API de la nube: 5 de abril de 2022

A partir de hoy, la API de la nube está disponible para todos los socios de soluciones y clientes directos. Además, lanzaremos las siguientes funciones para desarrolladores de la API de la nube:

• Mensajes con stickers: envía mensajes multimedia con stickers estáticos de terceros. Consulta la siguiente documentación para obtener más detalles: Referencia, Mensajes y Referencia, Multimedia. Admitimos el envío y la recepción de stickers. En cuanto al envío, solo admitimos stickers estáticos de terceros. En cuanto a la recepción, admitimos todo tipo de stickers.
• Anular el registro de la API de número de teléfono: realiza llamadas POST a PHONE_NUMBER_ID/deregister para quitar un número de teléfono de la API de WhatsApp Business. Consulta Registro para obtener más información.
• Nueva opción de verificación del teléfono: verifica el número de teléfono de tu empresa mediante llamadas a la API Graph. Para obtener más información, consulta Números de teléfono.
• Nueva referencia de Webhooks: recibe notificaciones de Webhooks cuando un usuario hace clic en un anuncio de clic a WhatsApp y envía un mensaje a la empresa. Consulta Webhooks para obtener más información. Ten en cuenta que el objeto referral de webhooks de la API de la nube es diferente al objeto referral de la API de instalaciones locales.

Además, anunciamos que la revisión de apps ya no es obligatoria en el caso de los desarrolladores internos que usan la API de la nube. Todos los desarrolladores están sujetos a los límites de mensajes de la Plataforma de WhatsApp Business.

API de instalaciones locales: 26 de marzo de 2022

Esta versión incluye las mismas características que la versión v2.37.1, pero la fecha de vencimiento es diferente. La v2.37.2 caduca el 22 de septiembre de 2022.

Problemas conocidos

Es posible que a algunos desarrolladores de Kubernetes se les muestre CrashLoopBackOff en relación con el contenedor de su app y que el contenedor no se inicie. Para solucionar este problema, agrega la siguiente línea en el archivo YML de implementación de Kubernetes, en la configuración de la app web:

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

API de instalaciones locales: 25 de marzo de 2022

A partir de hoy, está disponible la versión v2.39.3 de nuestro cliente de la API de WhatsApp Business para desarrolladores. El nuevo cliente incluye la corrección de dos errores y registros adicionales que admiten depuración. Estas son los dos errores corregidos:

• Se corrigió un error que impedía a las empresas enviar mensajes a un cliente si el cliente era quien había iniciado la interacción entre las dos partes en WhatsApp y si lo había hecho con más de 7 días de anterioridad.
• Se corrigió un error por el cual las empresas no podían recibir mensajes temporales de los clientes. Después de instalar la versión 2.39.3, las empresas recibirán una notificación de webhooks en la que se les indicará que recibieron un mensaje temporal. Por su parte, los clientes verán una advertencia en la que se les indicará que se desactivó el modo de mensajes temporales.

API de la nube: 15 de marzo de 2022

Mensajes de lista y botones "Responder"

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

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

URL de vista previa

A partir de hoy, los usuarios de la versión beta de la API de la nube podrán agregar un cuadro de URL de vista previa a los mensajes de texto que incluyan una URL. Consulta la siguiente documentación para obtener más detalles:

• Referencia, Mensajes

Nuevas guías de documentación

• Migración entre las API de instalaciones locales y de la nube

API de instalaciones locales: 4 de marzo de 2022

Lanzamos la API de instalaciones locales v2.39.2. Con esta versión, se corrige el error que provocaba que los mensajes de video no se enviaran en determinadas situaciones.

Problemas conocidos

• Se encontró un error que impide a las empresas enviar mensajes a un cliente si el cliente era quien había iniciado la interacción entre las dos partes en WhatsApp y si lo había hecho con más de 7 días de anterioridad.
• Se encontró un error que impide a las empresas recibir mensajes temporales de clientes.

API de la nube: 1 de marzo de 2022

Mensajes de video

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

• 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 cambió el modelo de precios basado en notificaciones por uno basado en conversaciones. Los cobros a las empresas se realizan por conversación y se incluyen todos los mensajes entregados en una sesión de 24 horas. Consulta Precios basados en conversaciones para obtener más información.

API de la nube

Mensajes de ubicación y contacto

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

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

Actualización de rendimiento máximo

Ahora, admitimos un rendimiento máximo de 80 mensajes por segundo por número de teléfono. Este número incluye los mensajes entrantes y salientes, de texto, de plantilla y multimedia.

API de instalaciones locales (2.39.1)

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

• Un nuevo campo en la API para establecer fragmentos.
• Un nuevo nombre de organizador que se agregó a los requisitos de red.
• El nuevo código de error 1031.
• Obsolescencia del tipo hsm y la configuración de la aplicación webhook_payload_conversation_pricingmodel_disabled.

API para establecer fragmentos

A partir de la nueva versión del cliente de la API, puedes proporcionar el certificado del teléfono cuando configures una conexión múltiple. Eso implica que, al llamar al punto de conexión /v1/account/shards, puedes agregar el certificado con codificación Base64 en el campo del certificado. Consulta Ampliar el cliente de la API con conexión múltiple para obtener información.

Nuevo nombre de organizador

Agregamos graph.whatsapp.com a la lista de nombres de host del servidor de WhatsApp con los que debe tener conectividad el cliente de la API de WhatsApp Business. Consulta Configurar y depurar tu red, Nombres de organizador para obtener más información.

Actualizaciones de códigos de error

En la v2.39, agregamos el código de error 1031. Este error aparecerá si se bloqueó tu cuenta y no puedes enviar mensajes debido a una infracción de la política de integridad. Consulta Mensajes de error y de estado y Cumplimiento de la política para obtener más información.

Elementos obsoletos

• API de mensajes: el tipo hsm quedó obsoleto con la v2.39. Como alternativa, deberías usar el tipo template.
• Configuración de la app: la configuración de la app webhook_payload_conversation_pricingmodel_disabled quedó obsoleta.

Problemas conocidos

En determinadas situaciones, no es posible enviar algunos mensajes de video.