> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Historial de cambios de la API

> Historial de lanzamientos, adiciones y cambios de compatibilidad de la API de YCloud desde marzo de 2023 hasta julio de 2026.

Este archivo conserva las entradas fechadas de la documentación anterior de la API,
hasta el 13 de julio de 2026. Un anuncio histórico describe el contrato en ese
momento; las entradas posteriores y la referencia actual de la API tienen prioridad.

<Note>
  Para consultar la facturación actual, consulta los [precios de WhatsApp](/es/documentation/pricing-and-billing/whatsapp-pricing-and-billing).
  La [migración de precios de 2025](/es/api-reference/getting-started/changelog/whatsapp-pricing-2025)
  se conserva por separado para interpretar registros anteriores.
</Note>

## 2026-07-13

* Se añadió una API de consulta de Automatic Creative Optimizations a nivel de WABA: `GET /v2/whatsapp/businessAccounts/{wabaId}/automatic-creative-optimizations`.
* Se añadió una API de actualización parcial de Automatic Creative Optimizations a nivel de WABA: `PATCH /v2/whatsapp/businessAccounts/{wabaId}/automatic-creative-optimizations`.

## 2026-07-07

### Actualizado

* Se actualizó la documentación de estado del WhatsApp Business Username para usar `reserved` en solicitudes de Business Username reservadas por Meta que aún puedan estar en revisión.
* Se marcó `pending_review` como un valor de compatibilidad heredado. Las nuevas escrituras de Business Username usan `reserved`.

### Añadido

* Se añadió `reserved` al enum de estado de WhatsApp Business Username.
* Se añadió un ejemplo de webhook de `whatsapp.phone_number.business_username_updated` con `businessUsernameStatus` establecido en `reserved`.

## 2026-06-10

### Actualizado

* Se revirtió el estado `removed` de la cuenta de WhatsApp Business previamente documentado e introducido el 2026-05-25.
* Los eventos de eliminación de socios ahora se representan mediante cargas útiles de webhook de `whatsapp.business_account.deleted` en lugar de `whatsapp.business_account.updated`.
* `removedReason`, `removedInitiatedBy` y `removedTime` se conservan como metadatos opcionales de eliminación en las cargas útiles de webhook de cuentas de WhatsApp Business eliminadas.

### Añadido

* Se añadió `PARTNER_APP_UNINSTALLED` a `WhatsappBusinessAccountUpdateEventEnum`.

## 2026-06-08

### Añadido

* Nuevo campo en el objeto WhatsApp Phone Number:
  * `updateEvent`
* Se añadió `updateEvent` a las cargas útiles de webhook de `whatsapp.phone_number.quality_updated` para identificar el evento de actualización de cuenta que activó el cambio de estado del número de teléfono, como `ACCOUNT_OFFBOARDED` o `ACCOUNT_RECONNECTED`.

## 2026-06-01

### Añadido

* Nuevas API para consultar, actualizar, eliminar y recuperar sugerencias de WhatsApp Business Usernames.
* Nuevos campos en el objeto WhatsApp Phone Number:
  * businessUsername
  * businessUsernameStatus
  * requestedBusinessUsername
  * businessUsernameUpdatedAt
* Nuevo tipo de evento de webhook: whatsapp.phone\_number.business\_username\_updated.

## 2026-05-25

* Soporte para actualizaciones de Partner Removed de la cuenta de WhatsApp Business en webhooks de `whatsapp.business_account.updated`.
  * Se añadieron `removed`, `removedReason`, `removedInitiatedBy` y `removedTime` a las cargas útiles de webhook de la cuenta de WhatsApp Business.
  * Se añadió `PARTNER_REMOVED` a `updateEvent` de la cuenta de WhatsApp Business.
  * Se documentaron los motivos conocidos de Partner Removed: `ACCOUNT_DISCONNECTED`, `BUSINESS_DOWNGRADE`, `CHANGE_NUMBER`, `COMPANION_INACTIVITY`, `PRIMARY_INACTIVITY` y `USER_RE_REGISTERED`.
  * Se documentaron los iniciadores conocidos de Partner Removed: `USER` y `SYSTEM`.

## 2026-05-19

<Note>
  Anuncio histórico: esta entrada no establece la disponibilidad actual del webhook
  para mensajes grupales. Consulta la [Guía de grupos](/es/api-reference/guides/whatsapp-platform/manage-whatsapp-groups) actual
  y el catálogo publicado de webhooks para ver las operaciones y eventos admitidos.
</Note>

* Soporte para la API de WhatsApp Groups.
* Soporte para operaciones de enlaces de invitación a grupos, solicitudes de unión, participantes y configuraciones de WhatsApp.
* Se añadió `group_id` a los parámetros de componentes de la plantilla de mensaje de WhatsApp.
* Se añadieron tipos de eventos de webhook para grupos de WhatsApp y cargas útiles de `whatsappGroup`. Consulta también [Webhook Events & Payloads](/es/api-reference/guides/examples/webhook-examples/webhook-payload-examples) y [Webhook Payload Examples](/es/api-reference/guides/examples/webhook-examples/webhook-payload-examples).
* Se añadió `groupId` a las cargas útiles de mensajes entrantes de WhatsApp para mensajes grupales.

## 2025-05-08

<Note>
  El registro de cambios original documenta esta fecha como 2025-05-08. Su posición entre
  las entradas de 2026 se conserva sin inferir una fecha de lanzamiento diferente.
</Note>

* Soporte para WhatsApp [inbound-unsupported-message](/es/api-reference/guides/examples/webhook-examples/whatsapp-inbound-message-webhook-examples#inbound-unsupported-message) `UNSUPPORTED_TYPE`

## 2026-04-29

* Se añadió `ARCHIVED` a `status` de plantilla de mensaje de WhatsApp.
* Se añadieron `ARCHIVED` y `UNARCHIVED` a `statusUpdateEvent` de plantilla de mensaje de WhatsApp.
* Se añadieron ejemplos de webhook para eventos de plantillas archivadas y desarchivadas de WhatsApp. Consulta también [WhatsApp Template Reviewed Webhook Examples](/es/api-reference/guides/examples/webhook-examples/whatsapp-template-reviewed-webhook-examples).
* Se añadió `filter.status` al endpoint List templates (`GET /v2/whatsapp/templates`) para filtrar plantillas por estado, incluyendo `ARCHIVED`.

## 2026-03-13

* Para dar soporte al despliegue de BSUID de Meta a partir del 31 de marzo de 2026, YCloud ha actualizado varias cargas útiles de webhook relacionadas con la mensajería y la identidad del usuario. Consulta [BSUID-Related Webhook Updates](/es/api-reference/guides/whatsapp-platform/use-business-scoped-user-ids)

## 2026-03-04

* Soporte para WhatsApp [interactive-media-carousel-messages-with-quick-reply-buttons](/es/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-media-carousel-messages-with-quick-reply-buttons)

## 2026-01-28

* Soporte para WhatsApp [create Gif template](/es/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#marketing-template-with-gif)/[send Gif template message](/es/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#gif-template-message)

## 2025-12-15

* Soporte para WhatsApp [deep link template](/es/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#android-deep-link-template)

## 2025-12-03

* Soporte para WhatsApp [interactive-media-carousel-messages](/es/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-media-carousel-messages).
* contact-retrieve (`GET /v2/contact/contacts/{id}`)/contact-update (`PATCH /v2/contact/contacts/{id}`)/contact-delete (`DELETE /v2/contact/contacts/{id}`) admiten número de teléfono.

## 2025-11-06

* Se añadió un nuevo tipo de evento de webhook: **whatsapp.user.preferences**

## 2025-10-22

* Se añadió source a la respuesta del endpoint List unsubscribers (`GET /v2/unsubscribers`)
* Se añadió source a la respuesta del endpoint List all unsubscribers by customer (`GET /v2/unsubscribers/{customer}`)
* Se añadió source a la respuesta del endpoint Retrieve an unsubscriber (`GET /v2/unsubscribers/{customer}/{channel}`)
* Se agregaron nuevos tipos de eventos de webhook: **contact.unsubscribe.created**, **contact.unsubscribe.deleted** Consulta también:
  * [Ejemplos de webhook para contacto desuscrito creado](/es/api-reference/guides/examples/webhook-examples/contact-unsubscribe-created-webhook-examples)
  * [Ejemplos de webhook para contacto desuscrito eliminado](/es/api-reference/guides/examples/webhook-examples/contact-unsubscribe-deleted-webhook-examples)

## 2025-10-20

* Se agregó el campo `whatsappBusinessManagerMessagingLimit` a varios endpoints:
  * Endpoints Listar WABAs (`GET /v2/whatsapp/businessAccounts`) y Recuperar una WABA (`GET /v2/whatsapp/businessAccounts/{id}`)
  * Endpoints Listar números de teléfono (`GET /v2/whatsapp/phoneNumbers`) y Recuperar un número de teléfono (`GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}`)
  * Carga útil del webhook [whatsapp.phone\_number.quality\_updated](/es/api-reference/guides/examples/webhook-examples/webhook-payload-examples)

## 2025-10-10

* Se agregaron `businessId`, `businessStatus` y `businessName` a la respuesta del endpoint Listar WABAs (`GET /v2/whatsapp/businessAccounts`) y del endpoint Recuperar una WABA (`GET /v2/whatsapp/businessAccounts/{id}`)

## 2025-09-24

* Compatibilidad con el endpoint [Actualizar el nombre para mostrar de un número de teléfono](/es/api-reference/guides/whatsapp-platform/manage-whatsapp-phone-numbers)
* Se agregó `newName` a la respuesta del endpoint Listar números de teléfono (`GET /v2/whatsapp/phoneNumbers`) y del endpoint Recuperar un número de teléfono (`GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}`).
* Se agregaron `verifiedName`, `nameStatus` y `newName` a la respuesta de Recuperar el perfil de un número de teléfono (`GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/profile`)
* Se agregó el campo `whatsappBusinessManagerMessagingLimit` a la carga útil del webhook [whatsapp.phone\_number.quality\_updated](/es/api-reference/guides/examples/webhook-examples/webhook-payload-examples)

## 2025-09-01

* Se agregó compatibilidad con la función de redirección de endpoints de WhatsApp Flows
  * Se agregó el parámetro endpointUri a la API de creación de Flows (`POST /v2/whatsapp/flows`) para especificar el URI del endpoint del Flow
  * Se agregó el parámetro endpointUri a la API de actualización de metadatos de Flows (`PATCH /v2/whatsapp/flows/{flowId}/metadata`) para la configuración del endpoint
  * Se agregó el recurso endpointUrl devuelto en la API de detalles de Flow (`GET /v2/whatsapp/flows/{flowId}`)

## 2025-08-28

* Se agregaron nuevos webhooks de WhatsApp SMB
  * [Ejemplos de webhook WhatsAppSmbAppStateSync](/es/api-reference/guides/examples/webhook-examples/webhook-payload-examples)

## 2025-08-20

* Se agregaron nuevas API de llamadas de WhatsApp
  * Iniciar una llamada saliente de WhatsApp (`POST /v2/whatsapp/calls/connect`)
  * Preaceptar una llamada entrante de WhatsApp (`POST /v2/whatsapp/calls/preAccept`)
  * Aceptar una llamada entrante de WhatsApp (`POST /v2/whatsapp/calls/accept`)
  * Finalizar una llamada de WhatsApp (`POST /v2/whatsapp/calls/terminate`)
  * Rechazar una llamada entrante de WhatsApp (`POST /v2/whatsapp/calls/reject`)
* Se agregaron API para configurar ajustes de llamadas
  * Obtener la configuración de llamadas de un número de teléfono comercial (`GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/settings`)
  * Definir la configuración de llamadas de un número de teléfono comercial (`POST /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/settings`)
* Se agregaron nuevos webhooks de llamadas de WhatsApp
  * [whatsapp-calling-connect-webhook-examples](/es/api-reference/guides/examples/webhook-examples/whatsapp-calling-connect-webhook-examples)
  * [whatsapp-calling-status-update-webhook-examples](/es/api-reference/guides/examples/webhook-examples/whatsapp-calling-status-update-webhook-examples)
  * [whatsapp-calling-terminate-webhook-examples](/es/api-reference/guides/examples/webhook-examples/whatsapp-calling-terminate-webhook-examples)
* Guía de uso de llamadas de WhatsApp: [whatsapp-calling-examples](/es/api-reference/guides/whatsapp-platform/manage-whatsapp-calls)

## 2025-08-04

* Se agregó compatibilidad con la página web de vista previa de WhatsApp Flow (`GET /v2/whatsapp/flows/{flowId}/preview`)

## 2025-07-24

* Se agregó el nuevo campo de matriz `supported_apps` a Crear una plantilla (`POST /v2/whatsapp/templates`) para definir múltiples nombres de paquetes de aplicaciones y hashes de claves de firma (hasta 5 aplicaciones) en una sola plantilla de OTP (One-tap / Zero-tap).
  * Se descontinuaron los campos existentes `package_name` y `signature_hash` en favor de la nueva estructura de matriz `supported_apps `

## 2025-07-10

* Se agregó compatibilidad con Listar atributos de contactos (`GET /v2/contact/contacts/attributes`) para consultar todos los atributos de contactos definidos.
* Se agregaron nuevos tipos de eventos de webhook: `contact.created`, `contact.deleted` y `contact.attributes_changed`. Consulta también:
  * [Ejemplos de webhook para contacto creado](/es/api-reference/guides/examples/webhook-examples/contact-created-webhook-examples)
  * [Ejemplos de webhook para contacto eliminado](/es/api-reference/guides/examples/webhook-examples/contact-deleted-webhook-examples)
  * [Ejemplos de webhook para atributos de contacto modificados](/es/api-reference/guides/examples/webhook-examples/contact-attributes-changed-webhook-examples)
* Se agregó una nueva propiedad `eventProperties` a las siguientes API de endpoints de webhook:
  * Crear un endpoint de webhook (`POST /v2/webhookEndpoints`)
  * Actualizar un endpoint de webhook (`PATCH /v2/webhookEndpoints/{id}`)
  * Listar endpoints de webhook (`GET /v2/webhookEndpoints`)
  * Recuperar un endpoint de webhook (`GET /v2/webhookEndpoints/{id}`)
* Se agregaron nuevos campos al objeto Contact para rastrear información sobre el origen del contacto:
  * `sourceType`: Enumeración de tipos de origen de contacto (`WHATSAPP`, `GROWTH_TOOL`, `MANUALLY_ADDED`, `FILE_IMPORT`, `SHOPIFY`, `API`, `AD`, `POST`, `CALLING`, `SMB`, `UNKNOWN`)
  * `sourceId`: Identificador de origen para rastrear el origen de creación del contacto
  * `sourceUrl`: URL de origen donde se creó el contacto

## 2025-07-01

* Se agregó compatibilidad con la API de WhatsApp Flow (`POST /v2/whatsapp/flows`) con los siguientes endpoints:
  * Crear un flow, Listar flows, Actualizar metadatos del flow, Actualizar la estructura del flow, Eliminar un flow, Recuperar un flow, Publicar un flow, Descontinuar un flow

## 2024-10-10

* Compatibilidad con los mensajes de WhatsApp [Detalles del pedido](/es/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#order-details-template-message) y los mensajes de [Estado del pedido](/es/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#order-status-template-message).
* Se agregó el nuevo tipo de evento de webhook `whatsapp.payment.updated`. Consulta también [Ejemplos de webhook para actualización de pago de WhatsApp](/es/api-reference/guides/examples/webhook-examples/whatsapp-payment-updated-webhook-examples).

## 2024-09-12

* Compatibilidad con [WhatsApp Flows](https://developers.facebook.com/docs/whatsapp/flows). Consulta también [Plantilla de Flow](/es/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#flow-template), [Mensaje de plantilla de Flow](/es/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#flow-template-message), [Mensaje interactivo de Flow](/es/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-flow-message) y [Mensaje entrante de respuesta interactiva de Flow](/es/api-reference/guides/examples/webhook-examples/whatsapp-inbound-message-webhook-examples#inbound-interactive-flow-response-message).

## 2024-08-22

* Se agregó la API de **Eventos personalizados** . Consulta Enviar un evento (`POST /v2/event/events`).

## 2024-08-02

* Se agregó `lastMessageToPhoneNumber` al objeto Contact. Consulta Recuperar un contacto (`GET /v2/contact/contacts/{id}`).

## 2024-07-18

* Se agregó `filterBlocked` al endpoint Poner en cola un mensaje de WhatsApp (`POST /v2/whatsapp/messages`). Si se establece en `true`, no enviaremos mensajes a los usuarios en tu lista de bloqueo.

## 2024-05-24

* A partir del 1 de junio de 2024, WhatsApp introducirá una nueva tarifa internacional de autenticación en Indonesia e India. Consulta [Tarifas internacionales de autenticación](https://developers.facebook.com/docs/whatsapp/pricing/authentication-international-rates).
* Se agrega `pricingCategory` al objeto WhatsApp Message. Si una conversación de autenticación se factura con la tarifa authentication-international, los webhooks [whatsapp.message.updated](/es/api-reference/guides/examples/webhook-examples/webhook-payload-examples) tendrán su propiedad `pricingCategory` establecida en `authentication_international`.
* Se agregan `authIntlRateEligibilityCountries` y `primaryBusinessLocation` al objeto cuenta de WhatsApp Business. Suscríbete a los webhooks [Authentication-International Rate Eligibility](/es/api-reference/guides/examples/webhook-examples/whatsapp-business-account-updated-webhook-examples#authentication-international-rate-eligibility) y [Primary Business Location Update](/es/api-reference/guides/examples/webhook-examples/whatsapp-business-account-updated-webhook-examples#primary-business-location-update) para recibir notificaciones.

## 2024-04-03

* Se agrega `regionCode` al objeto WhatsApp Message.

## 2024-02-22

* Se agrega el endpoint de WhatsApp Marcar mensaje como leído (`POST /v2/whatsapp/inboundMessages/{id}/markAsRead`).

## 2024-01-30

* Compatibilidad con el mensaje de WhatsApp [Interactive Location Request message](/es/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-location-request-message).
* Compatibilidad con el mensaje de WhatsApp [Inbound Request Welcome message](/es/api-reference/guides/examples/webhook-examples/whatsapp-inbound-message-webhook-examples#inbound-request-welcome-message).
* Se cambia el tiempo de vida (TTL) de los mensajes con plantilla de autenticación de 24 horas a 30 días si nunca se configuró (es decir, `messageSendTtlSeconds` es `-1`).

## 2024-01-17

* Se agrega el parámetro `externalId` al endpoint Iniciar una verificación (`POST /v2/verify/verifications`).

## 2024-01-05

* Se agrega el endpoint Registrar un número de teléfono (`POST /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/register`).
* Se agrega `id` al objeto WhatsApp Phone Number.
* Se agrega `paymentMethodAttached` al objeto cuenta de WhatsApp Business.

## 2023-12-21

* Se agregan los endpoints de [Unsubscribers](/es/api-reference/guides/customer-data-and-operations/manage-unsubscribers).

## 2023-12-13

* Se agrega el parámetro de solicitud `filterUnsubscribed` al endpoint Encolar un mensaje de WhatsApp (`POST /v2/whatsapp/messages`). Si se establece en `true`, el mensaje no se enviará a los usuarios que hayan cancelado la suscripción a tu cuenta.

## 2023-11-24

* Compatibilidad con WhatsApp [Catalog template](/es/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#catalog-template) y [Catalog template message](/es/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#catalog-template-message).
* Compatibilidad con WhatsApp [Multi-Product Message template](/es/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#multi-product-message-template) y [MPM template message](/es/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#mpm-template-message).
* Compatibilidad con el mensaje de WhatsApp [Interactive Catalog message](/es/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-catalog-message).
* Se agrega el endpoint Actualizar configuración de comercio (`PATCH /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/whatsappCommerceSettings`) para habilitar o deshabilitar el carrito de compras o el catálogo de productos para un número de teléfono comercial específico.

## 2023-11-02

* Compatibilidad con WhatsApp [Zero-Tap Authentication template](/es/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#zero-tap-authentication-template).
* Se agrega el tiempo de vida (TTL) del mensaje para las plantillas de autenticación. El valor predeterminado es de 600 segundos para las plantillas de autenticación recién creadas.

## 2023-10-27

* Compatibilidad con WhatsApp [Limited-Time Offer template](/es/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#limited-time-offer-template) y [Limited-Time Offer template message](/es/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#limited-time-offer-template-message).
* Compatibilidad con WhatsApp [Carousel template](/es/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#carousel-template) y [Carousel template message](/es/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#carousel-template-message).

## 2023-10-18

* Compatibilidad con los mensajes interactivos de botón CTA URL de WhatsApp. Consulta también [Interactive CTA URL Message Example](/es/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-cta-url-message).

## 2023-10-12

* Se agregan los tipos de evento de webhook [whatsapp.business\_account.deleted](/es/api-reference/guides/examples/webhook-examples/webhook-payload-examples) y [whatsapp.phone\_number.deleted](/es/api-reference/guides/examples/webhook-examples/webhook-payload-examples).
* Compatibilidad con WhatsApp [Coupon Templates](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/coupon-templates). Para ver más ejemplos, consulta también [Coupon template](/es/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#coupon-template) y [Coupon template message](/es/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#coupon-template-message).

## 2023-09-07

* Se agrega la Contacts API `/v2/contact/contacts`. Utilízala para crear, actualizar o eliminar tus contactos.

## 2023-07-05

* Se agrega `conversation.type` al objeto WhatsApp Message. Si está presente, los valores posibles son `FREE_ENTRY`, `FREE_TIER` y `REGULAR`.
* Se agrega `isOfficialBusinessAccount` al objeto WhatsApp Phone Number.

## 2023-06-01

* Se agregan encabezados de límite de frecuencia (rate limit) a cada respuesta. Consulta también [Rate Limits](/es/api-reference/guides/api-fundamentals/rate-limits).

## 2023-05-26

* Se agrega el tipo de evento de webhook `whatsapp.template.quality_updated` para ayudarte a realizar un seguimiento de las actualizaciones de WhatsApp [Template Quality Rating](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines/#quality-rating). Consulta [Webhook Events & Payloads](/es/api-reference/guides/examples/webhook-examples/webhook-payload-examples).
* Se agrega `qualityRating` al objeto WhatsApp Template.

## 2023-05-16

* Se agrega la API de mensajería de WhatsApp `/v2/whatsapp/messages/sendDirectly`. Consulta también [WhatsApp Errors](/es/api-reference/guides/whatsapp-platform/handle-whatsapp-errors) para la gestión de errores.
* Se agrega la API de eliminación de plantillas de WhatsApp `DELETE /v2/whatsapp/templates/{wabaId}/{name}/{language}`.
* Se agrega `whatsappApiError` al objeto `error` del cuerpo de respuesta.
* Se agrega `qualityUpdateEvent` al objeto WhatsApp Phone Number.
* Se agregan `sendTime`, `deliverTime` y `readTime` al objeto WhatsApp Message.
* Se agrega un nuevo valor enum `TIER_NOT_SET` a WhatsApp Phone Number `messagingLimit`.

## 2023-03-24

* **Las conversaciones de WhatsApp se cobran cuando el primer mensaje de esta conversación es**`delivered`\*\* en lugar de **`sent`**. Por lo tanto, el campo **`totalPrice`** de los objetos de mensaje de WhatsApp es solo un precio estimado antes de que se entregue el mensaje, y pasa a ser el precio definitivo cuando el **`status`** es **`delivered`** o **`read`**. El saldo retenido por aquellos mensajes que se envían pero aún no se han entregado no estará disponible hasta que los mensajes se descarten (los mensajes enviados que no se entregan durante 30 días se descartan).\*\* El `conversation.expireTime` también es una hora de vencimiento estimada hasta que el primer mensaje de esta conversación sea `delivered` o `read`.
* Se agrega el tipo de evento de webhook `whatsapp.template.category_updated` para ayudarte a realizar un seguimiento de los cambios en las categorías de plantilla de WhatsApp. Consulta [WhatsApp template category updated payload](/es/api-reference/guides/examples/webhook-examples/webhook-payload-examples). Para obtener más información sobre la migración de categorías de plantilla, consulta también [First template category migration](https://developers.facebook.com/docs/whatsapp/updates-to-pricing/launch-timeline#first-template-category-migration).
* Se agregan nuevos tipos de origen de conversación de WhatsApp: `authentication`, `marketing`, `utility` y `service`. El cambio al nuevo modelo de precios se realizará el 1 de junio de 2023. Consulta también [Nuevas tarifas de conversación](https://developers.facebook.com/docs/whatsapp/updates-to-pricing/launch-timeline#new-conversation-rates), vigentes a partir del 1 de junio de 2023.
* Se admite la creación de [Plantillas de autenticación con botones de contraseña de un solo uso](https://developers.facebook.com/docs/whatsapp/business-management-api/authentication-templates), que estarán disponibles a partir del 1 de mayo de 2023 y serán obligatorias a partir del 29 de mayo de 2023.

## 2023-03-09

* Se agrega el encabezado de respuesta `YCloud-Request-ID` para cada solicitud. Consulta [ID de solicitud](/es/api-reference/guides/api-fundamentals/handle-errors#request-correlation).
* Se agrega `requestId` al objeto de respuesta `error`. Consulta [Errores](/es/api-reference/guides/api-fundamentals/handle-errors#request-correlation).
* Se agregan nuevas categorías de plantilla de WhatsApp: `AUTHENTICATION` y `UTILITY`. Consulta también [Cronograma de lanzamiento del cambio de precios](https://developers.facebook.com/docs/whatsapp/updates-to-pricing/launch-timeline#new-template-categories)

<br />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.