Saltar al contenido principal
Sigue los cambios de la API y las actualizaciones de las guías y la referencia. Las entradas etiquetadas como Actualizaciones de la documentación usan la fecha de actualización de la documentación. Las entradas de lanzamientos históricos hasta el 13 de julio de 2026 conservan sus fechas originales. Las entradas posteriores y la referencia actual de la API tienen prioridad sobre los anuncios históricos.
Para consultar la facturación actual, consulta Precios de WhatsApp.

2026-11-10

Actualizaciones de la documentación

  • Se agregó la guía de YCloud Developer Kit, con la instalación para Codex, Claude Code y WorkBuddy, prompts de ejemplo, capacidades compatibles y pautas para pruebas locales y operaciones autorizadas de la API en vivo.
  • Se amplió el envío de mensajes de WhatsApp y la gestión de errores, incluidos los parámetros de plantilla, las respuestas citadas, los filtros de supresión y los fallos de envío frente a los de entrega.
  • Se ampliaron las pautas para receptores de Webhook con verificación de firmas en el cuerpo sin procesar (raw-body), almacenamiento duradero de eventos, gestión de duplicados y pruebas del receptor.
  • Se documentó el contrato de solicitud y respuesta del endpoint de Flow, incluidas las comprobaciones de estado, el intercambio de datos de pantalla, las notificaciones de errores y la gestión de la finalización.
  • Se actualizó la referencia de Meta Business Agent para herramientas de conectores, configuración de credenciales, registros de ejecución, ajustes, presupuestos y turnos de conversación. Consulta Configuración de Agent y Operación de Agent.

2026-11-03

Actualizaciones de la documentación

  • Se agregó una referencia de Webhook evento por evento, con esquemas de carga útil, ejemplos y descripciones de campos para eventos de mensajes, plantillas, cuentas, números de teléfono, Business App, Agent, llamadas, grupos, Flow, pagos y contactos.
  • Se documentaron los eventos de creación de eco, estado de eco y transferencia para Public REST API Agents. Consulta Ejemplos de Webhook de Agent.

2026-10-21

Actualizaciones de la documentación

  • Se aclaró que limited_time_offer solo se aplica a componentes de plantilla con type: LIMITED_TIME_OFFER. Su campo text solo es obligatorio cuando se incluye dicho objeto. Otros tipos de componentes no requieren el objeto. Consulta los ejemplos de creación de plantillas.

2026-09-18

Actualizaciones de la documentación

2026-09-17

Actualizaciones de la documentación

  • Se amplió la guía de Utility Direct Send, incluida la conversión de plantillas existentes con useDirectSend, el tiempo de vida de entrega y la asignación de nombres a plantillas generadas.
  • Se documentaron las operaciones de usuarios bloqueados de WhatsApp: POST /v2/whatsapp/{businessPhoneNumber}/blockUsers, POST /v2/whatsapp/{businessPhoneNumber}/unblockUsers y GET /v2/whatsapp/{businessPhoneNumber}/blockedUsers.
  • Se amplió la referencia de herramientas y conectores de Meta Business Agent para conectores HTTP y MCP, detección y ejecución de herramientas, credenciales y registros.

2026-09-16

Actualizaciones de documentación

2026-09-14

Actualizaciones de documentación

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 del estado de WhatsApp Business Username para usar reserved en las solicitudes de Business Username reservadas por Meta y 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 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 que se introdujo el 2026-05-25.
  • Los eventos de eliminación de socios ahora se representan mediante cargas útiles de Webhook 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 para 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 del Webhook 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 la cuenta de WhatsApp Business en webhooks whatsapp.business_account.updated.
    • Se agregaron removed, removedReason, removedInitiatedBy y removedTime a los payloads de webhook de la cuenta de WhatsApp Business.
    • Se agregó 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

Aviso histórico: esta entrada no establece la disponibilidad actual de webhooks de mensajes grupales. Usa la actual guía de Grupos y el catálogo publicado de webhooks para ver las operaciones y eventos admitidos.
  • Soporte para la API de grupos de WhatsApp.
  • Soporte para operaciones de enlaces de invitación, solicitudes para unirse, participantes y ajustes de grupos de WhatsApp.
  • Se agregó group_id a los parámetros de componentes de plantillas de WhatsApp.
  • Se agregaron tipos de eventos de webhook para grupos de WhatsApp y payloads de whatsappGroup. Consulta también Eventos y payloads de webhook y Ejemplos de payloads de webhook.
  • Se agregó groupId a los payloads de mensajes entrantes de WhatsApp para mensajes grupales.

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 agregó ARCHIVED a status de plantillas de WhatsApp.
  • Se agregaron ARCHIVED y UNARCHIVED a statusUpdateEvent de plantillas de WhatsApp.
  • Se agregaron ejemplos de webhook para eventos de plantillas de WhatsApp archivadas y desarchivadas. Consulta también Ejemplos de webhook para plantillas de WhatsApp revisadas.
  • Se agregó filter.status al endpoint Listar plantillas (GET /v2/whatsapp/templates) para filtrar plantillas por estado, incluido ARCHIVED.

2026-03-13

  • Para respaldar el despliegue de BSUID de Meta a partir del 31 de marzo de 2026, YCloud ha actualizado varios payloads de webhook relacionados 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

  • Soporte para 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 agregó un nuevo tipo de evento de webhook: whatsapp.user.preferences

2025-10-22

2025-10-20

  • Se agregó el campo whatsappBusinessManagerMessagingLimit a múltiples endpoints:
    • Endpoints Listar WABA (GET /v2/whatsapp/businessAccounts) y Obtener una WABA (GET /v2/whatsapp/businessAccounts/{id})
    • Endpoints Listar números de teléfono (GET /v2/whatsapp/phoneNumbers) y Obtener 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 WABA (GET /v2/whatsapp/businessAccounts) y del endpoint Obtener una WABA (GET /v2/whatsapp/businessAccounts/{id})

2025-09-24

  • Se admite 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 Obtener un número de teléfono (GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}).
  • Se agregaron verifiedName, nameStatus y newName a la respuesta del endpoint Obtener 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 redireccionamiento de endpoints de WhatsApp Flow
    • Se agregó el parámetro endpointUri a la API de creación de Flow (POST /v2/whatsapp/flows) para especificar la URI del endpoint de Flow
    • Se agregó 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
    • 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 los ajustes de llamadas
    • Obtener la configuración 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)
  • 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 varios 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 marcaron como obsoletos los campos existentes package_name e signature_hash en favor de la nueva estructura de matriz supported_apps

2025-07-10

  • Se agregó compatibilidad con Listar atributos de contacto (GET /v2/contact/contacts/attributes) para consultar todos los atributos de contacto 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 la información de 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 la fuente 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 flujo, Listar flujos, Actualizar metadatos de flujo, Actualizar estructura de flujo, Eliminar un flujo, Recuperar un flujo, Publicar un flujo, Desaprobar un flujo

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 añade filterBlocked al endpoint Poner un mensaje de WhatsApp en cola (POST /v2/whatsapp/messages). Si se establece en true, no enviaremos mensajes a los usuarios que estén en tu lista de bloqueo.

2024-05-24

  • A partir del 1 de junio de 2024, WhatsApp introduce una nueva tarifa de autenticación internacional en Indonesia e India. Consulta Authentication-International Rates.
  • Se añade pricingCategory al objeto WhatsApp Message. Si una conversación de autenticación se factura con la tarifa de autenticación internacional, los webhooks whatsapp.message.updated tendrán su propiedad pricingCategory establecida en authentication_international.
  • Se añaden authIntlRateEligibilityCountries y primaryBusinessLocation al objeto de la cuenta de WhatsApp Business. Suscríbete a los webhooks Authentication-International Rate Eligibility y Primary Business Location Update para recibir notificaciones.

2024-04-03

  • Se añade regionCode al objeto WhatsApp Message.

2024-02-22

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

2024-01-30

2024-01-17

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

2024-01-05

  • Se añade el endpoint 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 la cuenta de WhatsApp Business.

2023-12-21

2023-12-13

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

2023-11-24

2023-11-02

  • Compatibilidad con la plantilla Zero-Tap Authentication template de WhatsApp.
  • Se añade el tiempo de vida (TTL) de los mensajes para 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 agregó la API de contactos /v2/contact/contacts. Úsala para crear, actualizar o eliminar tus contactos.

2023-07-05

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

2023-06-01

  • Se agregaron encabezados de límite de frecuencia a cada respuesta. Consulta también Límites de frecuencia.

2023-05-26

2023-05-16

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

2023-03-24

  • Las conversaciones de WhatsApp se cobran cuando el primer mensaje de esta conversación se marca como 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 se entregue, y se convierte en el precio final cuando el campo status es delivered o read. El saldo retenido por los mensajes enviados que no se han entregado no estará disponible hasta que se descarten (los mensajes enviados que no se entreguen durante 30 días se descartan). El valor conversation.expireTime también es una hora de vencimiento estimada 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 un seguimiento de los cambios en las categorías de plantillas de WhatsApp. Consulta el payload de categoría de plantilla de WhatsApp actualizada. Para obtener más información sobre la migración de categorías de plantillas, consulta también Primera migración de categorías de plantillas.
  • Se añaden 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