Saltar al contenido principal
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 Precios de WhatsApp.

​
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 de WhatsApp Business Username para usar reserved en solicitudes de Business Username reservadas por Meta y que aún puedan estar en revisión.
  • Se marcó pending_review como valor de compatibilidad heredado. Las nuevas escrituras de Business Username utilizan 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 cuenta de WhatsApp Business previamente documentado e introducido el 25-05-2026.
  • 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 de eliminación opcionales en las cargas útiles de webhook de cuenta de WhatsApp Business eliminada.

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

  • Compatibilidad con actualizaciones de Partner Removed para 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 cuenta de WhatsApp Business.
    • Se añadió PARTNER_REMOVED a updateEvent de 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 de webhooks para mensajes de grupo. Utiliza la Guía de grupos actual y el catálogo de webhooks publicado para consultar las operaciones y eventos admitidos.
  • Compatibilidad con la API de WhatsApp Groups.
  • Compatibilidad con operaciones de enlace de invitación, solicitud para unirse, participantes y configuración de grupos de WhatsApp.
  • Se añadió group_id a los parámetros de componentes de plantillas de WhatsApp.
  • Se añadieron tipos de eventos de webhook para grupos de WhatsApp y cargas útiles de whatsappGroup. Consulta también Eventos y cargas útiles de webhook y Ejemplos de cargas útiles de webhook.
  • Se añadió groupId a las cargas útiles de mensajes entrantes de WhatsApp para mensajes de grupo.

​
2025-05-08

El registro de cambios original registra 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 WhatsApp.
  • Se añadieron ARCHIVED y UNARCHIVED a statusUpdateEvent de plantilla de WhatsApp.
  • Se añadieron ejemplos de webhook para eventos de plantillas de WhatsApp archivadas y desarchivadas. Consulta también Ejemplos de webhooks de plantillas de WhatsApp revisadas.
  • Se añadió filter.status al endpoint Listar plantillas (GET /v2/whatsapp/templates) para filtrar plantillas por estado, incluyendo ARCHIVED.

​
2026-03-13

  • Para admitir el despliegue del 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 Actualizaciones de webhooks relacionadas con BSUID

​
2026-03-04

​
2026-01-28

​
2025-12-15

​
2025-12-03

  • Compatibilidad con interactive-media-carousel-messages de WhatsApp.
  • 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 Listar usuarios que cancelaron suscripción (GET /v2/unsubscribers)
  • Se añadió source a la respuesta del endpoint Listar todos los usuarios que cancelaron suscripción por cliente (GET /v2/unsubscribers/{customer})
  • Se añadió source a la respuesta del endpoint Obtener un usuario que canceló la suscripción (GET /v2/unsubscribers/{customer}/{channel})
  • Se añadieron nuevos tipos de eventos de webhook: contact.unsubscribe.created, contact.unsubscribe.deleted . Consulta también:

​
2025-10-20

  • Se añadió el campo whatsappBusinessManagerMessagingLimit a varios endpoints:
    • Endpoints List WABAs (GET /v2/whatsapp/businessAccounts) y Retrieve a WABA (GET /v2/whatsapp/businessAccounts/{id})
    • Endpoints List phone numbers (GET /v2/whatsapp/phoneNumbers) y Retrieve a phone number (GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber})
    • Payload del webhook whatsapp.phone_number.quality_updated

​
2025-10-10

  • Se añadieron businessId, businessStatus e businessName a la respuesta del endpoint List WABAS (GET /v2/whatsapp/businessAccounts) y del endpoint Retrieve a WABA (GET /v2/whatsapp/businessAccounts/{id})

​
2025-09-24

  • Soporte para el endpoint Update a phone number’s display name
  • Se añadió newName a la respuesta del endpoint List phone numbers (GET /v2/whatsapp/phoneNumbers) y del endpoint Retrieve a phone number (GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}).
  • Se añadieron verifiedName, nameStatus e newName a la respuesta de Retrieve a phone number profile (GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/profile)
  • Se añadió el campo whatsappBusinessManagerMessagingLimit al payload del webhook whatsapp.phone_number.quality_updated

​
2025-09-01

  • Añadido soporte para la función de redirección de endpoint de WhatsApp Flow
    • Añadido el parámetro endpointUri a la API de creación de Flow (POST /v2/whatsapp/flows) para especificar el URI del endpoint del Flow
    • Añadido el parámetro endpointUri a la API de actualización de metadatos de Flow (PATCH /v2/whatsapp/flows/{flowId}/metadata) para la configuración del endpoint
    • Añadido el recurso endpointUrl devuelto en la API de detalle de Flow (GET /v2/whatsapp/flows/{flowId})

​
2025-08-28

​
2025-08-20

  • Añadidas nuevas API de llamadas de WhatsApp
    • Iniciar una llamada saliente de WhatsApp (POST /v2/whatsapp/calls/connect)
    • Aceptar previamente 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)
  • Añadidas API de configuración de ajustes de llamadas
    • Obtener los ajustes de llamadas del número de teléfono comercial (GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/settings)
    • Configurar los ajustes de llamadas del número de teléfono comercial (POST /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/settings)
  • Añadidos nuevos webhooks de llamadas de WhatsApp
  • Guía de uso de llamadas de Whatsapp: whatsapp-calling-examples

​
2025-08-04

  • Añadido soporte para la página web de vista previa de whatsapp flow (GET /v2/whatsapp/flows/{flowId}/preview)

​
2025-07-24

  • Se añadió el nuevo campo de matriz supported_apps a Create a template (POST /v2/whatsapp/templates) para definir múltiples nombres de paquetes de aplicaciones y hashes de clave de firma (hasta 5 aplicaciones) en una sola plantilla de OTP (One-tap / Zero-tap).
    • Se obsoletaron los campos existentes package_name y signature_hash en favor de la nueva estructura de matriz supported_apps

​
2025-07-10

  • Se añadió soporte para List contact attributes (GET /v2/contact/contacts/attributes) para consultar todos los atributos de contacto definidos.
  • Se añadieron nuevos tipos de evento de webhook: contact.created, contact.deleted y contact.attributes_changed. Consulta también:
  • Se añadió una nueva propiedad eventProperties a las siguientes API de endpoint de webhook:
    • Create a webhook endpoint (POST /v2/webhookEndpoints)
    • Update a webhook endpoint (PATCH /v2/webhookEndpoints/{id})
    • List webhook endpoints (GET /v2/webhookEndpoints)
    • Retrieve a webhook endpoint (GET /v2/webhookEndpoints/{id})
  • Se añadieron nuevos campos al objeto Contact para rastrear información sobre el origen del contacto:
    • sourceType: Enumeración del tipo de origen del 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 añadió soporte para la API de WhatsApp Flow (POST /v2/whatsapp/flows) con los siguientes endpoints:
    • Create a flow、List flows、Update flow metadata、Update flow structure、Delete a flow、Retrieve a flow、Publish a flow、Deprecate a flow

​
2024-10-10

​
2024-09-12

​
2024-08-22

  • Añadida la API de eventos personalizados . Consulta Send an event (POST /v2/event/events).

​
2024-08-02

  • Añadido lastMessageToPhoneNumber al objeto Contact. Consulta Retrieve a contact (GET /v2/contact/contacts/{id}).

​
2024-07-18

  • Añade filterBlocked al endpoint Enqueue a WhatsApp Message (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 añade regionCode al objeto WhatsApp Message.

​
2024-02-22

  • Se añade el endpoint de WhatsApp para marcar mensaje como leído (POST /v2/whatsapp/inboundMessages/{id}/markAsRead).

​
2024-01-30

  • Compatibilidad con el mensaje de solicitud interactiva de ubicación (Interactive Location Request message) de WhatsApp.
  • Compatibilidad con el mensaje de bienvenida a solicitud entrante (Inbound Request Welcome message) de WhatsApp.
  • Se cambia el tiempo de vida (TTL) del mensaje de plantilla de autenticación de 24 horas a 30 días si nunca se configuró (es decir, cuando messageSendTtlSeconds es -1).

​
2024-01-17

  • Se añade el parámetro externalId al endpoint para iniciar una verificación (POST /v2/verify/verifications).

​
2024-01-05

  • Se añade el endpoint para registrar un número de teléfono (POST /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/register).
  • Se añade id al objeto WhatsApp Phone Number.
  • Se añade paymentMethodAttached al objeto de cuenta de WhatsApp Business.

​
2023-12-21

  • Se añaden los endpoints de cancelaciones de suscripción (Unsubscribers).

​
2023-12-13

  • Se añade el parámetro de solicitud filterUnsubscribed al endpoint para poner en cola un mensaje de WhatsApp (POST /v2/whatsapp/messages). Si se establece en true, el mensaje no se enviará a los usuarios que hayan cancelado su suscripción a tu cuenta.

​
2023-11-24

  • Compatibilidad con Catalog template y con el mensaje de plantilla de catálogo (Catalog template message) de WhatsApp.
  • Compatibilidad con Multi-Product Message template y con el mensaje de plantilla MPM (MPM template message) de WhatsApp.
  • Compatibilidad con el mensaje interactivo de catálogo (Interactive Catalog message) de WhatsApp.
  • Se añade el endpoint para actualizar la configuración comercial (PATCH /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/whatsappCommerceSettings) con el fin de activar o desactivar 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 la plantilla de autenticación con un solo toque (Zero-Tap Authentication template) de WhatsApp.
  • Se añade 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 añade la API de Contactos /v2/contact/contacts. Utilízala para crear, actualizar o eliminar tus contactos.

​
2023-07-05

  • Se añade conversation.type al objeto WhatsApp Message. Si está presente, los valores posibles son FREE_ENTRY, FREE_TIER y REGULAR.
  • Se añade isOfficialBusinessAccount al objeto WhatsApp Phone Number.

​
2023-06-01

  • Se añaden encabezados de límite de tarifa (rate limit) a cada respuesta. Consulta también Rate Limits.

​
2023-05-26

  • Se añade el tipo de evento de webhook whatsapp.template.quality_updated para ayudarte a realizar el seguimiento de las actualizaciones de la calificación de calidad de plantillas (Template Quality Rating) de WhatsApp. Consulta Webhook Events & Payloads.
  • Se añade qualityRating al objeto WhatsApp Template.

​
2023-05-16

  • Se añade la API de mensajería de WhatsApp /v2/whatsapp/messages/sendDirectly. Consulta también WhatsApp Errors para la gestión de errores.
  • Se añade la API de eliminación de plantillas de WhatsApp DELETE /v2/whatsapp/templates/{wabaId}/{name}/{language}.
  • Se añade whatsappApiError al objeto error del cuerpo de la respuesta.
  • Se añade qualityUpdateEvent al objeto WhatsApp Phone Number.
  • Se añaden sendTime, deliverTime y readTime al objeto WhatsApp Message.
  • Se añade un nuevo valor de enumeración TIER_NOT_SET a WhatsApp Phone Number messagingLimit.

​
2023-03-24

  • Las conversaciones de WhatsApp se cobran cuando el primer mensaje de dicha 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 el mensaje sea entregado, y se convierte en el precio final cuando el status es delivered o read. El saldo retenido por aquellos mensajes que se han enviado pero aún no se han entregado no estará disponible hasta que los mensajes sean descartados (los mensajes enviados que no se entreguen durante 30 días se descartan). El conversation.expireTime también es un tiempo de expiración estimado hasta que el primer mensaje de esta conversación sea delivered o read.
  • Se añade el tipo de evento de webhook whatsapp.template.category_updated para ayudarte a realizar el seguimiento de los cambios de categoría de plantillas de WhatsApp. Consulta WhatsApp template category updated payload. Para obtener más información sobre la migración de categorías de plantillas, 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.
  • Compatibilidad para crear 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