> ## 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.
# Migração de preços do WhatsApp em 2025
> Regras históricas de preços por mensagem de julho de 2025, campos de callback, exemplos e casos de transição.
Referência histórica: estas regras descrevem a migração de 1º de julho de 2025 para
preços por mensagem, em vigor à meia-noite no fuso horário de cada WABA. Elas não
substituem as [regras de preços atuais](/pt/documentation/pricing-and-billing/whatsapp-pricing-and-billing)
ou o [guia de integração de preços atual](/pt/api-reference/guides/whatsapp-platform/whatsapp-message-pricing-integration-guide).
Em particular, a franquia de serviço e as regras de mensagens de utilidade mudaram em
1º de outubro de 2026.
## Explicação sobre preços
Com os preços por mensagem, as empresas em nossa plataforma serão cobradas:
* Por mensagem de modelo de marketing entregue
* Por mensagem de modelo de autenticação entregue
* Por mensagem de modelo de utilidade entregue, se entregue fora de uma janela de atendimento ao cliente
**Observação**
* As empresas podem responder aos usuários gratuitamente com `free-form `mensagens e mensagens de modelo de utilidade
* As empresas podem responder aos usuários gratuitamente com `free entry points `mensagens
**Exemplo ilustrativo de preços**
* Se uma empresa enviar 1 mensagem de marketing e 1 mensagem de utilidade, isso gerará 1 cobrança para cada categoria.
* Quando a janela de atendimento ao cliente estiver aberta, as empresas podem enviar mensagens de formato livre ou mensagens de utilidade gratuitamente.
> A janela de atendimento ao cliente é um temporizador de 24 horas que começa com uma mensagem do usuário e é reiniciado a cada nova mensagem do usuário. Enquanto a janela de atendimento ao cliente estiver aberta, as empresas podem responder aos usuários por meio de mensagens de formato livre ou mensagens de utilidade, sem cobrança. Mensagens de formato livre são qualquer tipo de mensagem que não seja um modelo de mensagem.
* Quando um usuário envia uma mensagem para uma empresa a partir de um anúncio de clique para o WhatsApp ou de um botão de ação da Página do Facebook, e a empresa responde dentro de 24 horas, essa resposta abre uma janela de 72 horas (3 dias) `free entry point` em que os modelos de mensagem não são cobrados.
* Um exemplo ilustrativo abrangente
## Webhooks de preços por mensagem
Com efeito a partir de 1º de julho de 2025, o [WhatsApp Message Updated Webhook](/pt/api-reference/guides/examples/webhook-examples/whatsapp-message-updated-webhook-examples) implementará as seguintes alterações:
* Modificações no campo conversation existente
* Adição de novos campos relacionados a faturamento
**Especificações de alteração de parâmetros do Webhook**
| Nome do campo | Tipo de dados | Descrição |
| - | - | - |
| pricingModel | String | Nova propriedade. Os valores podem ser: \* `"PMP"`— indica que o preço por mensagem é aplicado. \* `"CBP" `— indica que o preço baseado em conversas é aplicado. |
| pricingType | String | Nova propriedade. Disponível exclusivamente no modo PMP (Preço por Mensagem). Os valores podem ser: \* `regular` — indica que a mensagem é faturável. \* `free_customer_service` — indica que a mensagem é gratuita por ter sido uma mensagem de modelo de utilidade ou uma mensagem que não seja modelo enviada dentro de uma janela de atendimento ao cliente. \* `free_entry_point `— indica que a mensagem é gratuita por fazer parte de uma conversa de ponto de entrada gratuito. |
| whatsappMessage.conversation | Object | No modo PMP (Preço por Mensagem), o objeto conversation não será mais retornado. |
**Exemplo de Webhook no modo CBP**
```shell theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"id": "evt_djeIQXaQPQyUcRFi",
"type": "whatsapp.message.updated",
"apiVersion": "v2",
"createTime": "2022-03-01T12:00:00.000Z",
"whatsappMessage": {
"id": "63f5d602367ea403f8175a6c",
"wamid": "wamid.BgNODYxN...",
"wabaId": "whatsapp-business-account-id",
"from": "+16315551111",
"to": "+16315552222",
"status": "read",
"type": "template",
"template": {
"name": "login_otp",
"language": {
"code": "en_US",
"policy": "deterministic"
}
},
"conversation": {
"id": "8078ed05301c40a08d3d1845c94ca18b",
"type": "REGULAR",
"originType": "authentication",
"expireTime": "2022-03-02T12:00:00.000Z"
},
"regionCode": "GB",
"pricingCategory": "authentication_international",
"pricingModel": "CBP",
"totalPrice": 0.085,
"currency": "USD",
"createTime": "2022-03-01T12:00:00.000Z",
"sendTime": "2022-03-01T12:00:01.000Z",
"deliverTime": "2022-03-01T12:00:02.000Z",
"readTime": "2022-03-01T12:00:02.000Z",
"externalId": "ext_123456"
}
}
```
**Exemplo de Webhook no modo PMP**
```shell theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"id": "evt_djeIQXaQPQyUcRFi",
"type": "whatsapp.message.updated",
"apiVersion": "v2",
"createTime": "2022-03-01T12:00:00.000Z",
"whatsappMessage": {
"id": "63f5d602367ea403f8175a6c",
"wamid": "wamid.BgNODYxN...",
"wabaId": "whatsapp-business-account-id",
"from": "+16315551111",
"to": "+16315552222",
"status": "read",
"type": "template",
"template": {
"name": "login_otp",
"language": {
"code": "en_US",
"policy": "deterministic"
}
},
"regionCode": "GB",
"pricingCategory": "authentication_international",
"pricingModel": "PMP",
"pricingType": "regular",
"totalPrice": 0.085,
"currency": "USD",
"createTime": "2022-03-01T12:00:00.000Z",
"sendTime": "2022-03-01T12:00:01.000Z",
"deliverTime": "2022-03-01T12:00:02.000Z",
"readTime": "2022-03-01T12:00:02.000Z",
"externalId": "ext_123456"
}
}
```
## Caso limite de transição
Se uma conversa de utilidade for aberta entre você e um usuário que abranja a mudança para preços por mensagem (a conversa foi aberta antes da transição, mas não será encerrada até depois dela), os modelos de utilidade enviados ao usuário após a transição enquanto a conversa estiver aberta serão gratuitos, porém atribuídos à conversa aberta. Essas mensagens terão um `pricingModel` de `CBP `e o ID da conversa de utilidade será atribuído a conversation.id nos webhooks de mensagens de status. Depois que a conversa for encerrada, as mensagens de utilidade subsequentes enviadas ao usuário seguirão o novo comportamento ilustrado acima.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.