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_offersolo se aplica a componentes de plantilla contype: LIMITED_TIME_OFFER. Su campotextsolo 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
- Se agregaron guías de integración de Meta Business Agent para elegibilidad, incorporación, configuración, pruebas, despliegue y operació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}/unblockUsersyGET /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
- Se actualizó la guía de Business-Scoped User ID con la gestión de identidades en la API y el Webhook.
2026-09-14
Actualizaciones de documentación
- Se documentaron
phaseyprogresspara la sincronización del historial de WhatsApp Business App. Consulta los ejemplos de webhooks de historial. - Se documentó el reporte de eventos personalizados por nombre de usuario. Consulta Rastrear eventos personalizados.
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
reserveden las solicitudes de Business Username reservadas por Meta y que aún puedan estar en revisión. - Se marcó
pending_reviewcomo un valor de compatibilidad heredado. Las nuevas escrituras de Business Username usanreserved.
Añadido
- Se añadió
reservedal enum de estado de WhatsApp Business Username. - Se añadió un ejemplo de webhook
whatsapp.phone_number.business_username_updatedconbusinessUsernameStatusestablecido enreserved.
2026-06-10
Actualizado
- Se revirtió el estado
removedde 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.deleteden lugar dewhatsapp.business_account.updated. removedReason,removedInitiatedByyremovedTimese 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_UNINSTALLEDaWhatsappBusinessAccountUpdateEventEnum.
2026-06-08
Añadido
- Nuevo campo en el objeto WhatsApp Phone Number:
updateEvent
- Se añadió
updateEventa las cargas útiles del Webhookwhatsapp.phone_number.quality_updatedpara identificar el evento de actualización de cuenta que activó el cambio de estado del número de teléfono, comoACCOUNT_OFFBOARDEDoACCOUNT_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,removedInitiatedByyremovedTimea los payloads de webhook de la cuenta de WhatsApp Business. - Se agregó
PARTNER_REMOVEDaupdateEventde la cuenta de WhatsApp Business. - Se documentaron los motivos conocidos de Partner Removed:
ACCOUNT_DISCONNECTED,BUSINESS_DOWNGRADE,CHANGE_NUMBER,COMPANION_INACTIVITY,PRIMARY_INACTIVITYyUSER_RE_REGISTERED. - Se documentaron los iniciadores conocidos de Partner Removed:
USERySYSTEM.
- Se agregaron
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_ida 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ó
groupIda 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.
- Soporte para inbound-unsupported-message de WhatsApp
UNSUPPORTED_TYPE
2026-04-29
- Se agregó
ARCHIVEDastatusde plantillas de WhatsApp. - Se agregaron
ARCHIVEDyUNARCHIVEDastatusUpdateEventde 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.statusal endpoint Listar plantillas (GET /v2/whatsapp/templates) para filtrar plantillas por estado, incluidoARCHIVED.
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
- Soporte para interactive-media-carousel-messages-with-quick-reply-buttons de WhatsApp
2026-01-28
- Soporte en WhatsApp para crear plantilla de GIF/enviar mensaje con plantilla de GIF
2025-12-15
- Soporte para plantilla de enlace profundo de WhatsApp
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
- Se agregó source a la respuesta del endpoint Listar cancelaciones de suscripción (
GET /v2/unsubscribers) - Se agregó source a la respuesta del endpoint Listar todas las cancelaciones de suscripción por cliente (
GET /v2/unsubscribers/{customer}) - Se agregó source a la respuesta del endpoint Obtener una cancelación de suscripción (
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
whatsappBusinessManagerMessagingLimita 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
- Endpoints Listar WABA (
2025-10-10
- Se agregaron
businessId,businessStatusybusinessNamea 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ó
newNamea 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,nameStatusynewNamea 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
whatsappBusinessManagerMessagingLimita 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})
- Se agregó el parámetro endpointUri a la API de creación de Flow (
2025-08-28
- Se agregaron nuevos Webhooks de WhatsApp Smb
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)
- Iniciar una llamada saliente de WhatsApp (
- 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)
- Obtener la configuración de llamadas del número de teléfono comercial (
- 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_appsa 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_nameesignature_hashen favor de la nueva estructura de matrizsupported_apps
- Se marcaron como obsoletos los campos existentes
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.deletedycontact.attributes_changed. Consulta también: - Se agregó una nueva propiedad
eventPropertiesa 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})
- Crear un endpoint de webhook (
- 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 contactosourceUrl: 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
- Compatibilidad con mensajes de detalles del pedido y mensajes de estado del pedido de WhatsApp.
- Se agregó el nuevo tipo de evento de webhook
whatsapp.payment.updated. Consulta también Ejemplos de webhook de pago de WhatsApp actualizado.
2024-09-12
- Compatibilidad con WhatsApp Flows. Consulta también Plantilla de flujo, Mensaje de plantilla de flujo, Mensaje interactivo de flujo y Mensaje de respuesta de flujo interactivo entrante.
2024-08-22
- Se agregó la API de Eventos personalizados . Consulta Enviar un evento (
POST /v2/event/events).
2024-08-02
- Se agregó
lastMessageToPhoneNumberal objeto Contact. Consulta Recuperar un contacto (GET /v2/contact/contacts/{id}).
2024-07-18
- Se añade
filterBlockedal endpoint Poner un mensaje de WhatsApp en cola (POST /v2/whatsapp/messages). Si se establece entrue, 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
pricingCategoryal 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 propiedadpricingCategoryestablecida enauthentication_international. - Se añaden
authIntlRateEligibilityCountriesyprimaryBusinessLocational 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
regionCodeal 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
- Compatibilidad con el Interactive Location Request message de WhatsApp.
- Compatibilidad con el Inbound Request Welcome message de WhatsApp.
- Se cambia el tiempo de vida (TTL) de las plantillas de mensaje de autenticación de 24 horas a 30 días si nunca se configuró (es decir, cuando
messageSendTtlSecondses-1).
2024-01-17
- Se añade el parámetro
externalIdal 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
idal objeto WhatsApp Phone Number. - Se añade
paymentMethodAttachedal objeto de la cuenta de WhatsApp Business.
2023-12-21
- Se añaden los endpoints de Unsubscribers.
2023-12-13
- Se añade el parámetro de solicitud
filterUnsubscribedal endpoint Poner un mensaje de WhatsApp en cola (POST /v2/whatsapp/messages). Si se establece entrue, el mensaje no se enviará a los usuarios que se hayan dado de baja de tu cuenta.
2023-11-24
- Compatibilidad con Catalog template y Catalog template message de WhatsApp.
- Compatibilidad con Multi-Product Message template y MPM template message de WhatsApp.
- Compatibilidad con el Interactive Catalog message de WhatsApp.
- Se añade el endpoint Actualizar la configuración comercial (
PATCH /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/whatsappCommerceSettings) para activar o desactivar el carrito de compras o el catálogo de productos de un número de teléfono comercial específico.
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
- Compatibilidad con la plantilla de oferta por tiempo limitado de WhatsApp y el mensaje de plantilla de oferta por tiempo limitado.
- Compatibilidad con la plantilla de carrusel de WhatsApp y el mensaje de plantilla de carrusel.
2023-10-18
- Compatibilidad con mensajes interactivos con botón de URL de CTA de WhatsApp. Consulta también el ejemplo de mensaje interactivo con URL de CTA.
2023-10-12
- Se agregaron los tipos de evento de webhook whatsapp.business_account.deleted y whatsapp.phone_number.deleted.
- Compatibilidad con las plantillas de cupones de WhatsApp. Para ver más ejemplos, consulta también Plantilla de cupón y Mensaje de plantilla de cupón.
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.typeal objeto WhatsApp Message. Si está presente, los valores posibles sonFREE_ENTRY,FREE_TIERyREGULAR. - Se agregó
isOfficialBusinessAccountal 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
- Se agregó el tipo de evento de webhook
whatsapp.template.quality_updatedpara ayudarte a realizar el seguimiento de las actualizaciones de la calificación de calidad de plantillas de WhatsApp. Consulta Eventos y cargas útiles de webhook. - Se agregó
qualityRatingal objeto WhatsApp Template.
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ó
whatsappApiErroral objetoerrordel cuerpo de la respuesta. - Se agregó
qualityUpdateEvental objeto WhatsApp Phone Number. - Se agregaron
sendTime,deliverTimeyreadTimeal objeto WhatsApp Message. - Se agregó el nuevo valor de enumeración
TIER_NOT_SETamessagingLimitde WhatsApp Phone Number.
2023-03-24
- Las conversaciones de WhatsApp se cobran cuando el primer mensaje de esta conversación se marca como
delivereden lugar desent. Por lo tanto, el campototalPricede 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 campostatusesdeliveredoread. 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 valorconversation.expireTimetambién es una hora de vencimiento estimada hasta que el primer mensaje de esta conversación seadeliveredoread. - Se añade el tipo de evento de webhook
whatsapp.template.category_updatedpara 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,utilityyservice. 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
- Se añade el encabezado de respuesta
YCloud-Request-IDpara cada solicitud. Consulta ID de solicitud. - Se añade
requestIdal objeto de respuestaerror. Consulta Errores. - Se añaden nuevas categorías de plantillas de WhatsApp:
AUTHENTICATIONyUTILITY. Consulta también el Cronograma de lanzamiento del cambio de precios

