Skip to main content
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.
Para consultar la facturación actual, consulta los precios de WhatsApp. La migración de precios de 2025 se conserva por separado para interpretar registros anteriores.

​
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

Anuncio histórico: esta entrada no establece la disponibilidad actual del webhook para mensajes grupales. Consulta la Guía de grupos actual y el catálogo publicado de webhooks para ver las operaciones y eventos admitidos.
  • 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 y Webhook Payload Examples.
  • Se añadió groupId a las cargas útiles de mensajes entrantes de WhatsApp para mensajes grupales.

​
2025-05-08

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.

​
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.
  • 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

​
2026-03-04

​
2026-01-28

​
2025-12-15

​
2025-12-03

  • Soporte para WhatsApp 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:

​
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

​
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
  • 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

​
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

​
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
  • Guía de uso de llamadas de WhatsApp: whatsapp-calling-examples

​
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:
  • 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

​
2024-09-12

​
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

​
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

​
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

​
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

​
2023-11-02

  • Compatibilidad con WhatsApp 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

​
2023-10-18

​
2023-10-12

​
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.

​
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. Consulta Webhook Events & Payloads.
  • 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 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 esdelivered** 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. Para obtener más información sobre la migración de categorías de plantilla, consulta también 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, 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, 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