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

# Histórico de alterações da API

> Histórico de lançamentos, adições e alterações de compatibilidade da API da YCloud de março de 2023 até julho de 2026.

Este arquivo preserva as entradas datadas da documentação anterior da API,
até 13 de julho de 2026. Um anúncio histórico descreve o contrato daquele
momento; entradas posteriores e a referência atual da API têm precedência.

<Note>
  Para cobrança atual, consulte [Preços do WhatsApp](/pt/documentation/pricing-and-billing/whatsapp-pricing-and-billing).
  A [migração de preços de 2025](/pt/api-reference/getting-started/changelog/whatsapp-pricing-2025)
  é mantida separadamente para interpretar registros mais antigos.
</Note>

## 2026-07-13

* Adicionada uma API de consulta de Automatic Creative Optimizations no nível da WABA: `GET /v2/whatsapp/businessAccounts/{wabaId}/automatic-creative-optimizations`.
* Adicionada uma API de atualização parcial de Automatic Creative Optimizations no nível da WABA: `PATCH /v2/whatsapp/businessAccounts/{wabaId}/automatic-creative-optimizations`.

## 2026-07-07

### Atualizado

* Atualizada a documentação de status do WhatsApp Business Username para usar `reserved` para solicitações de Business Username que estão reservadas pela Meta e ainda podem estar em análise.
* Marcado `pending_review` como um valor de compatibilidade legado. Novas gravações de Business Username usam `reserved`.

### Adicionado

* Adicionado `reserved` ao enum de status do WhatsApp Business Username.
* Adicionado um exemplo de webhook `whatsapp.phone_number.business_username_updated` com `businessUsernameStatus` definido como `reserved`.

## 2026-06-10

### Atualizado

* Revertido o estado de `removed` da conta do WhatsApp Business documentado anteriormente e introduzido em 25/05/2026.
* Eventos de remoção de parceiro agora são representados por payloads de webhook `whatsapp.business_account.deleted` em vez de `whatsapp.business_account.updated`.
* `removedReason`, `removedInitiatedBy` e `removedTime` são mantidos como metadados opcionais de remoção em payloads de webhook de conta do WhatsApp Business excluída.

### Adicionado

* Adicionado `PARTNER_APP_UNINSTALLED` a `WhatsappBusinessAccountUpdateEventEnum`.

## 2026-06-08

### Adicionado

* Novo campo no objeto WhatsApp Phone Number:
  * `updateEvent`
* Adicionado `updateEvent` a payloads de webhook `whatsapp.phone_number.quality_updated` para identificar o evento de atualização da conta que acionou a mudança de status do número de telefone, como `ACCOUNT_OFFBOARDED` ou `ACCOUNT_RECONNECTED`.

## 2026-06-01

### Adicionado

* Novas APIs para consultar, atualizar, excluir e recuperar sugestões para WhatsApp Business Usernames.
* Novos campos no objeto WhatsApp Phone Number:
  * businessUsername
  * businessUsernameStatus
  * requestedBusinessUsername
  * businessUsernameUpdatedAt
* Novo tipo de evento de webhook: whatsapp.phone\_number.business\_username\_updated.

## 2026-05-25

* Suporte a atualizações de Partner Removed da conta do WhatsApp Business em webhooks `whatsapp.business_account.updated`.
  * Adicionados `removed`, `removedReason`, `removedInitiatedBy` e `removedTime` a payloads de webhook da conta do WhatsApp Business.
  * Adicionado `PARTNER_REMOVED` a `updateEvent` da conta do WhatsApp Business.
  * Documentados motivos conhecidos de Partner Removed: `ACCOUNT_DISCONNECTED`, `BUSINESS_DOWNGRADE`, `CHANGE_NUMBER`, `COMPANION_INACTIVITY`, `PRIMARY_INACTIVITY` e `USER_RE_REGISTERED`.
  * Documentados iniciadores conhecidos de Partner Removed: `USER` e `SYSTEM`.

## 2026-05-19

<Note>
  Anúncio histórico: esta entrada não estabelece a disponibilidade atual de webhooks
  para mensagens em grupo. Use o [Guia de grupos](/pt/api-reference/guides/whatsapp-platform/manage-whatsapp-groups) atual
  e o catálogo publicado de webhooks para conferir as operações e eventos suportados.
</Note>

* Suporte à WhatsApp Groups API.
* Suporte a operações de link de convite, solicitação de entrada, participante e configurações de grupos do WhatsApp.
* Adicionado `group_id` aos parâmetros de componentes de modelo do WhatsApp.
* Adicionados tipos de eventos de webhook para grupos do WhatsApp e payloads `whatsappGroup`. Consulte também [Webhook Events & Payloads](/pt/api-reference/guides/examples/webhook-examples/webhook-payload-examples) e [Webhook Payload Examples](/pt/api-reference/guides/examples/webhook-examples/webhook-payload-examples).
* Adicionado `groupId` a payloads de mensagens recebidas do WhatsApp para mensagens em grupo.

## 2025-05-08

<Note>
  O changelog original registra esta data como 2025-05-08. Sua posição entre
  as entradas de 2026 é preservada sem deduzir uma data de lançamento diferente.
</Note>

* Suporte a [inbound-unsupported-message](/pt/api-reference/guides/examples/webhook-examples/whatsapp-inbound-message-webhook-examples#inbound-unsupported-message)  `UNSUPPORTED_TYPE` do WhatsApp

## 2026-04-29

* Adicionado `ARCHIVED` a `status` de modelo do WhatsApp.
* Adicionados `ARCHIVED` e `UNARCHIVED` a `statusUpdateEvent` de modelo do WhatsApp.
* Adicionados exemplos de webhook para eventos de modelo do WhatsApp arquivado e desarquivado. Consulte também [WhatsApp Template Reviewed Webhook Examples](/pt/api-reference/guides/examples/webhook-examples/whatsapp-template-reviewed-webhook-examples).
* Adicionado `filter.status` ao endpoint List templates (`GET /v2/whatsapp/templates`) para filtrar modelos por status, incluindo `ARCHIVED`.

## 2026-03-13

* Para suportar o lançamento do BSUID pela Meta a partir de 31 de março de 2026, a YCloud atualizou vários payloads de webhook relacionados a mensagens e identidade do usuário. Consulte [Atualizações de Webhook Relacionadas ao BSUID](/pt/api-reference/guides/whatsapp-platform/use-business-scoped-user-ids)

## 2026-03-04

* Suporte a [interactive-media-carousel-messages-with-quick-reply-buttons](/pt/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-media-carousel-messages-with-quick-reply-buttons) do WhatsApp

## 2026-01-28

* Suporte a [create Gif template](/pt/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#marketing-template-with-gif)/[send Gif template message](/pt/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#gif-template-message) do WhatsApp

## 2025-12-15

* Suporte a [deep link template](/pt/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#android-deep-link-template) do WhatsApp

## 2025-12-03

* Suporte a [interactive-media-carousel-messages](/pt/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-media-carousel-messages) do WhatsApp.
* contact-retrieve (`GET /v2/contact/contacts/{id}`)/contact-update (`PATCH /v2/contact/contacts/{id}`)/contact-delete (`DELETE /v2/contact/contacts/{id}`) suportam número de telefone.

## 2025-11-06

* Adicionado novo tipo de evento de webhook: **whatsapp.user.preferences**

## 2025-10-22

* Adicionado source à resposta do endpoint List unsubscribers (`GET /v2/unsubscribers`)
* Adicionado source à resposta do endpoint List all unsubscribers by customer (`GET /v2/unsubscribers/{customer}`)
* Adicionado source à resposta do endpoint Retrieve an unsubscriber (`GET /v2/unsubscribers/{customer}/{channel}`)
* Adicionados novos tipos de evento de webhook: **contact.unsubscribe.created**, **contact.unsubscribe.deleted** Veja também:
  * [Exemplos de webhook para cancelamento de inscrição de contato criado](/pt/api-reference/guides/examples/webhook-examples/contact-unsubscribe-created-webhook-examples)
  * [Exemplos de webhook para cancelamento de inscrição de contato excluído](/pt/api-reference/guides/examples/webhook-examples/contact-unsubscribe-deleted-webhook-examples)

## 2025-10-20

* Adicionado o campo `whatsappBusinessManagerMessagingLimit` a vários endpoints:
  * Endpoints Listar WABAs (`GET /v2/whatsapp/businessAccounts`) e Obter uma WABA (`GET /v2/whatsapp/businessAccounts/{id}`)
  * Endpoints Listar números de telefone (`GET /v2/whatsapp/phoneNumbers`) e Obter um número de telefone (`GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}`)
  * Payload do webhook [whatsapp.phone\_number.quality\_updated](/pt/api-reference/guides/examples/webhook-examples/webhook-payload-examples)

## 2025-10-10

* Adicionados `businessId`, `businessStatus` e `businessName` à resposta do endpoint Listar WABAs (`GET /v2/whatsapp/businessAccounts`) e do endpoint Obter uma WABA (`GET /v2/whatsapp/businessAccounts/{id}`)

## 2025-09-24

* Suporte ao endpoint [Atualizar nome de exibição de um número de telefone](/pt/api-reference/guides/whatsapp-platform/manage-whatsapp-phone-numbers)
* Adicionado `newName` à resposta do endpoint Listar números de telefone (`GET /v2/whatsapp/phoneNumbers`) e do endpoint Obter um número de telefone (`GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}`).
* Adicionados `verifiedName`, `nameStatus` e `newName` à resposta de Obter perfil de um número de telefone (`GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/profile`)
* Adicionado o campo `whatsappBusinessManagerMessagingLimit` ao payload do webhook [whatsapp.phone\_number.quality\_updated](/pt/api-reference/guides/examples/webhook-examples/webhook-payload-examples)

## 2025-09-01

* Adicionado suporte ao recurso de redirecionamento de endpoint do WhatsApp Flow
  * Adicionado o parâmetro endpointUri à API de criação de Flow (`POST /v2/whatsapp/flows`) para especificar a URI do endpoint do Flow
  * Adicionado o parâmetro endpointUri à API de atualização de metadados do Flow (`PATCH /v2/whatsapp/flows/{flowId}/metadata`) para configuração do endpoint
  * Adicionado o recurso endpointUrl retornado na API de detalhes do Flow (`GET /v2/whatsapp/flows/{flowId}`)

## 2025-08-28

* Adicionados novos webhooks do WhatsApp SMB
  * [WhatsAppSmbAppStateSync-webhook-examples](/pt/api-reference/guides/examples/webhook-examples/webhook-payload-examples)

## 2025-08-20

* Adicionadas novas APIs de chamadas do WhatsApp
  * Iniciar uma chamada do WhatsApp de saída (`POST /v2/whatsapp/calls/connect`)
  * Pré-aceitar uma chamada do WhatsApp de entrada (`POST /v2/whatsapp/calls/preAccept`)
  * Aceitar uma chamada do WhatsApp de entrada (`POST /v2/whatsapp/calls/accept`)
  * Encerrar uma chamada do WhatsApp (`POST /v2/whatsapp/calls/terminate`)
  * Rejeitar uma chamada do WhatsApp de entrada (`POST /v2/whatsapp/calls/reject`)
* Adicionadas APIs para configurar definições de chamadas
  * Obter configurações de chamadas do número de telefone comercial (`GET /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/settings`)
  * Definir configurações de chamadas do número de telefone comercial (`POST /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/settings`)
* Adicionados novos webhooks de chamadas do WhatsApp
  * [whatsapp-calling-connect-webhook-examples](/pt/api-reference/guides/examples/webhook-examples/whatsapp-calling-connect-webhook-examples)
  * [whatsapp-calling-status-update-webhook-examples](/pt/api-reference/guides/examples/webhook-examples/whatsapp-calling-status-update-webhook-examples)
  * [whatsapp-calling-terminate-webhook-examples](/pt/api-reference/guides/examples/webhook-examples/whatsapp-calling-terminate-webhook-examples)
* Guia de uso de chamadas do WhatsApp: [whatsapp-calling-examples](/pt/api-reference/guides/whatsapp-platform/manage-whatsapp-calls)

## 2025-08-04

* Adicionado suporte à página web de pré-visualização do WhatsApp Flow (`GET /v2/whatsapp/flows/{flowId}/preview`)

## 2025-07-24

* Adicionado novo campo de array `supported_apps` a Criar um modelo (`POST /v2/whatsapp/templates`) para definir múltiplos nomes de pacotes de aplicativo e hashes de chave de assinatura (até 5 apps) em um modelo OTP (One-tap / Zero-tap).
  * Campos existentes `package_name` e `signature_hash` descontinuados em favor da nova estrutura de array `supported_apps `

## 2025-07-10

* Adicionado suporte a Listar atributos de contato (`GET /v2/contact/contacts/attributes`) para consultar todos os atributos de contato definidos.
* Adicionados novos tipos de evento de webhook: `contact.created`, `contact.deleted` e `contact.attributes_changed`. Veja também:
  * [Exemplos de webhook para contato criado](/pt/api-reference/guides/examples/webhook-examples/contact-created-webhook-examples)
  * [Exemplos de webhook para contato excluído](/pt/api-reference/guides/examples/webhook-examples/contact-deleted-webhook-examples)
  * [Exemplos de webhook para alteração de atributos de contato](/pt/api-reference/guides/examples/webhook-examples/contact-attributes-changed-webhook-examples)
* Adicionada uma nova propriedade `eventProperties` às seguintes APIs de endpoint de webhook:
  * Criar um endpoint de webhook (`POST /v2/webhookEndpoints`)
  * Atualizar um endpoint de webhook (`PATCH /v2/webhookEndpoints/{id}`)
  * Listar endpoints de webhook (`GET /v2/webhookEndpoints`)
  * Obter um endpoint de webhook (`GET /v2/webhookEndpoints/{id}`)
* Adicionados novos campos ao objeto Contact para rastrear informações de origem do contato:
  * `sourceType`: Enumeração de tipo de origem do contato (`WHATSAPP`, `GROWTH_TOOL`, `MANUALLY_ADDED`, `FILE_IMPORT`, `SHOPIFY`, `API`, `AD`, `POST`, `CALLING`, `SMB`, `UNKNOWN`)
  * `sourceId`: Identificador de origem para rastreamento da origem de criação do contato
  * `sourceUrl`: URL de origem onde o contato foi criado

## 2025-07-01

* Adicionado suporte à API de WhatsApp Flow (`POST /v2/whatsapp/flows`) com os seguintes endpoints:
  * Criar um flow、Listar flows、Atualizar metadados do flow、Atualizar estrutura do flow、Excluir um flow、Obter um flow、Publicar um flow、Descontinuar um flow

## 2024-10-10

* Suporte a [mensagens de detalhes do pedido](/pt/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#order-details-template-message) e [mensagens de status do pedido](/pt/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#order-status-template-message) do WhatsApp.
* Adicionado novo tipo de evento de webhook `whatsapp.payment.updated`. Veja também [Exemplos de webhook para pagamento do WhatsApp atualizado](/pt/api-reference/guides/examples/webhook-examples/whatsapp-payment-updated-webhook-examples) .

## 2024-09-12

* Suporte a [WhatsApp Flows](https://developers.facebook.com/docs/whatsapp/flows). Veja também [Modelo de Flow](/pt/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#flow-template), [Mensagem de modelo de Flow](/pt/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#flow-template-message), [Mensagem de Flow interativa](/pt/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-flow-message) e [Mensagem de resposta interativa de Flow de entrada](/pt/api-reference/guides/examples/webhook-examples/whatsapp-inbound-message-webhook-examples#inbound-interactive-flow-response-message).

## 2024-08-22

* Adicionada API de **Eventos personalizados** . Veja Enviar um evento (`POST /v2/event/events`).

## 2024-08-02

* Adicionado `lastMessageToPhoneNumber` ao objeto Contact. Veja Obter um contato (`GET /v2/contact/contacts/{id}`).

## 2024-07-18

* Adicionado `filterBlocked` ao endpoint Enfileirar uma mensagem do WhatsApp (`POST /v2/whatsapp/messages`). Se definido como `true`, não enviaremos mensagens para usuários na sua lista de bloqueio.

## 2024-05-24

* A partir de 1º de junho de 2024, o WhatsApp introduzirá uma nova tarifa de autenticação internacional na Indonésia e na Índia. Veja [Tarifas de autenticação internacional](https://developers.facebook.com/docs/whatsapp/pricing/authentication-international-rates) .
* Adicionado `pricingCategory` ao objeto WhatsApp Message. Se uma conversa de autenticação for cobrada pela tarifa authentication-international, os webhooks [whatsapp.message.updated](/pt/api-reference/guides/examples/webhook-examples/webhook-payload-examples) terão sua propriedade `pricingCategory` definida como `authentication_international`.
* Adicionados `authIntlRateEligibilityCountries` e `primaryBusinessLocation` ao objeto conta do WhatsApp Business. Inscreva-se nos webhooks [Authentication-International Rate Eligibility](/pt/api-reference/guides/examples/webhook-examples/whatsapp-business-account-updated-webhook-examples#authentication-international-rate-eligibility) e [Primary Business Location Update](/pt/api-reference/guides/examples/webhook-examples/whatsapp-business-account-updated-webhook-examples#primary-business-location-update) para receber notificações.

## 2024-04-03

* Adicionado `regionCode` ao objeto WhatsApp Message.

## 2024-02-22

* Adicionado o endpoint do WhatsApp para marcar mensagem como lida (`POST /v2/whatsapp/inboundMessages/{id}/markAsRead`).

## 2024-01-30

* Suporte a [Interactive Location Request message](/pt/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-location-request-message) do WhatsApp.
* Suporte a [Inbound Request Welcome message](/pt/api-reference/guides/examples/webhook-examples/whatsapp-inbound-message-webhook-examples#inbound-request-welcome-message) do WhatsApp.
* Alterado o tempo de vida útil (TTL) do modelo de mensagem de autenticação de 24 horas para 30 dias se nunca tiver sido definido (ou seja, se `messageSendTtlSeconds` for `-1`).

## 2024-01-17

* Adicionado o parâmetro `externalId` ao endpoint Iniciar uma verificação (`POST /v2/verify/verifications`).

## 2024-01-05

* Adicionado o endpoint Registrar um número de telefone (`POST /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/register`).
* Adicionado `id` ao objeto WhatsApp Phone Number.
* Adicionado `paymentMethodAttached` ao objeto conta do WhatsApp Business.

## 2023-12-21

* Adicionados os endpoints de [Unsubscribers](/pt/api-reference/guides/customer-data-and-operations/manage-unsubscribers).

## 2023-12-13

* Adicionado o parâmetro de requisição `filterUnsubscribed` ao endpoint Enfileirar uma mensagem do WhatsApp (`POST /v2/whatsapp/messages`). Se definido como `true`, a mensagem não será enviada para usuários que cancelaram a inscrição na sua conta.

## 2023-11-24

* Suporte a [Catalog template](/pt/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#catalog-template) e [Catalog template message](/pt/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#catalog-template-message) do WhatsApp.
* Suporte a [Multi-Product Message template](/pt/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#multi-product-message-template) e [MPM template message](/pt/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#mpm-template-message) do WhatsApp.
* Suporte a [Interactive Catalog message](/pt/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-catalog-message) do WhatsApp.
* Adicionado o endpoint Atualizar configurações de comércio (`PATCH /v2/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/whatsappCommerceSettings`) para ativar ou desativar o carrinho de compras ou o catálogo de produtos para um número de telefone comercial específico.

## 2023-11-02

* Suporte a [Zero-Tap Authentication template](/pt/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#zero-tap-authentication-template) do WhatsApp.
* Adicionado tempo de vida útil (TTL) da mensagem para modelos de autenticação. O padrão é 600 segundos para modelos de autenticação recém-criados.

## 2023-10-27

* Suporte a [Limited-Time Offer template](/pt/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#limited-time-offer-template) e [Limited-Time Offer template message](/pt/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#limited-time-offer-template-message) do WhatsApp.
* Suporte a [Carousel template](/pt/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#carousel-template) e [Carousel template message](/pt/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#carousel-template-message) do WhatsApp.

## 2023-10-18

* Suporte a mensagens interativas do WhatsApp com botão de CTA por URL. Veja também [Interactive CTA URL Message Example](/pt/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#interactive-cta-url-message).

## 2023-10-12

* Adicionados os tipos de evento de webhook [whatsapp.business\_account.deleted](/pt/api-reference/guides/examples/webhook-examples/webhook-payload-examples) e [whatsapp.phone\_number.deleted](/pt/api-reference/guides/examples/webhook-examples/webhook-payload-examples).
* Suporte a [Coupon Templates](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/coupon-templates) do WhatsApp. Para mais exemplos, veja também [Coupon template](/pt/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples#coupon-template) e [Coupon template message](/pt/api-reference/guides/examples/api-examples/whatsapp-messaging-examples#coupon-template-message).

## 2023-09-07

* Adicionada a API Contacts `/v2/contact/contacts`. Use-a para criar, atualizar ou excluir seus contatos.

## 2023-07-05

* Adicionado `conversation.type` ao objeto WhatsApp Message. Se presente, os valores possíveis são `FREE_ENTRY`, `FREE_TIER` e `REGULAR`.
* Adicionado `isOfficialBusinessAccount` ao objeto WhatsApp Phone Number.

## 2023-06-01

* Adicionados cabeçalhos de limite de taxa a cada resposta. Veja também [Rate Limits](/pt/api-reference/guides/api-fundamentals/rate-limits).

## 2023-05-26

* Adicionado o tipo de evento de webhook `whatsapp.template.quality_updated` para ajudar a acompanhar as atualizações de [Template Quality Rating](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines/#quality-rating) do WhatsApp. Veja [Webhook Events & Payloads](/pt/api-reference/guides/examples/webhook-examples/webhook-payload-examples).
* Adicionado `qualityRating` ao objeto WhatsApp Template.

## 2023-05-16

* Adicionada a API de mensagens do WhatsApp `/v2/whatsapp/messages/sendDirectly`. Veja também [WhatsApp Errors](/pt/api-reference/guides/whatsapp-platform/handle-whatsapp-errors) para tratamento de erros.
* Adicionada a API de exclusão de modelo do WhatsApp `DELETE /v2/whatsapp/templates/{wabaId}/{name}/{language}`.
* Adicionado `whatsappApiError` ao objeto `error` no corpo da resposta.
* Adicionado `qualityUpdateEvent` ao objeto WhatsApp Phone Number.
* Adicionados `sendTime`, `deliverTime` e `readTime` ao objeto WhatsApp Message.
* Adicionado o novo valor enum `TIER_NOT_SET` a `messagingLimit` do WhatsApp Phone Number.

## 2023-03-24

* **As conversas do WhatsApp são cobradas quando a primeira mensagem dessa conversa for**`delivered`\*\* em vez de **`sent`**. Portanto, o campo **`totalPrice`** dos objetos de mensagem do WhatsApp é apenas um preço estimado antes de a mensagem ser entregue, tornando-se o preço final quando o **`status`** for **`delivered`** ou **`read`**. O saldo retido por essas mensagens que foram enviadas mas ainda não foram entregues não estará disponível até que as mensagens sejam descartadas (mensagens enviadas que não forem entregues por 30 dias são descartadas).\*\* O campo `conversation.expireTime` também é um prazo de expiração estimado até que a primeira mensagem dessa conversa seja `delivered` ou `read`.
* Adicionado o tipo de evento de webhook `whatsapp.template.category_updated` para ajudar você a acompanhar alterações de categoria de modelos do WhatsApp. Veja [WhatsApp template category updated payload](/pt/api-reference/guides/examples/webhook-examples/webhook-payload-examples). Para mais informações sobre a migração de categoria de modelo, consulte também [First template category migration](https://developers.facebook.com/docs/whatsapp/updates-to-pricing/launch-timeline#first-template-category-migration).
* Adicionados novos tipos de origem de conversa do WhatsApp: `authentication`, `marketing`, `utility` e `service`. A mudança para o novo modelo de preços será realizada em 1º de junho de 2023. Consulte também [Novas tarifas de conversa](https://developers.facebook.com/docs/whatsapp/updates-to-pricing/launch-timeline#new-conversation-rates), em vigor a partir de 1º de junho de 2023.
* Suporte à criação de [Modelos de autenticação com botões de senha de uso único](https://developers.facebook.com/docs/whatsapp/business-management-api/authentication-templates), que estarão disponíveis a partir de 1º de maio de 2023 e serão obrigatórios a partir de 29 de maio de 2023.

## 2023-03-09

* Adicionado cabeçalho de resposta `YCloud-Request-ID` para cada solicitação. Consulte [ID da solicitação](/pt/api-reference/guides/api-fundamentals/handle-errors#request-correlation).
* Adicionado `requestId` ao objeto `error` de resposta. Consulte [Erros](/pt/api-reference/guides/api-fundamentals/handle-errors#request-correlation).
* Adicionadas novas categorias de modelo do WhatsApp: `AUTHENTICATION` e `UTILITY`. Consulte também o [Cronograma de lançamento da alteração de preços](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.