> ## 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.
# Preço máximo (Max Price) para mensagens de marketing do WhatsApp
> Controle o valor máximo que você está disposto a pagar por cada mensagem de marketing do WhatsApp entregue e use esse preço em envios via API ou campanhas em massa.
O Preço Máximo ajuda você a controlar e otimizar seus gastos com mensagens de marketing do WhatsApp. Você define o valor máximo que está disposto a pagar por cada mensagem de marketing entregue com sucesso. A Meta calcula o preço real de entrega dinamicamente e cobra esse valor ou menos.
**Um Preço Máximo é um teto de preço, não uma cobrança fixa.** Um Preço Máximo mais alto pode melhorar as oportunidades de entrega, enquanto um Preço Máximo mais baixo pode ajudar a controlar custos. Nenhuma das configurações garante uma taxa de entrega específica. Mensagens que não forem entregues não geram cobrança de entrega.
## Como o Preço Máximo efetivo é calculado
Primeiro, você define um Preço Máximo padrão em um modelo de mensagem de marketing. Em seguida, você pode adicionar multiplicadores específicos por país para destinos que precisem de um teto diferente.
Ao enviar uma mensagem individual pela API, você pode opcionalmente aplicar mais um multiplicador para essa mensagem:
Preço Máximo efetivo = Preço Máximo do modelo × multiplicador do país × multiplicador por mensagem
* Países sem ajuste de país utilizam um multiplicador de `1`.
* Envios via API sem um multiplicador por mensagem utilizam um multiplicador de `1`.
* As Campanhas em Massa usam as configurações de preço salvas no modelo. Elas não oferecem suporte a multiplicador por mensagem.
As taxas de entrega estimadas ajudam a comparar as configurações de preço, mas servem apenas para planejamento. A entrega real e as cobranças finais podem variar devido a lances em tempo real, status do destinatário e verificações de elegibilidade da Meta.
## Definir um Preço Máximo em um modelo
Escolha a API ou o painel da YCloud ao criar o modelo de mensagem de marketing.
### Opção 1: Usar a API
Ao criar um modelo de mensagem de marketing, inclua `bidSpec` na requisição:
1. Defina `maxBid` com o Preço Máximo padrão. A moeda utiliza a moeda de faturamento da sua YCloud.
2. Opcionalmente, adicione `countryPriceAdjustments` para até 50 países.
3. Para cada ajuste por país, forneça um código de país ISO 3166-1 alfa-2 e um multiplicador maior que `0` e não superior a `10`.
4. Envie o modelo e aguarde o término da análise do modelo antes de dispará-lo.
Consulte [Criar um modelo com Preço Máximo](/pt/api-reference/guides/whatsapp-platform/max-price-integration-guide#4-create-a-template-with-max-price) para ver os campos da requisição, exemplos e a resposta.
### Opção 2: Usar o painel da YCloud
1. Na YCloud, acesse **Modelos** e crie um novo modelo de **Marketing** .
2. Preencha o conteúdo do modelo e os valores de exemplo.
3. Em **Configurações avançadas**, ative a opção **Especificação de lance**.
4. Insira o **Preço máximo padrão**.
5. Opcional: selecione **Adicionar país**, escolha um país e informe seu **Multiplicador de preço**. Verifique o **Preço máximo efetivo** calculado e a **Taxa de entrega estimada**.
6. Selecione **Enviar** e aguarde a conclusão da análise do modelo.
Os países que você não adicionar utilizarão o Preço Máximo padrão. Por exemplo, se o padrão for `0.09 USD` e a Índia tiver um multiplicador de `1.1`, o Preço Máximo efetivo para a Índia será `0.099 USD`.
## Enviar mensagens com um modelo com Preço Máximo
### Opção 1: Enviar pela API
Envie o modelo aprovado com a API de mensagens do WhatsApp. Para usar as configurações de preço do modelo sem nenhum outro ajuste, omita o `bidSpec` no nível da mensagem. Para ajustar o Preço Máximo efetivo para um destinatário, defina `bidSpec.per_message_bid_multiplier` com um valor maior que `0`.
Consulte o [Guia de Integração do Preço Máximo](/pt/api-reference/guides/whatsapp-platform/max-price-integration-guide) para conferir a requisição de envio, regras de preço efetivo, estimativas de alcance e campos de Webhook de cobrança final.
### Opção 2: Enviar uma Campanha em Massa
1. Na YCloud, acesse **Envios** > **Campanhas em massa** > **Adicionar campanha** > **WhatsApp**.
2. Selecione o remetente, um modelo com Preço Máximo habilitado e o idioma correspondente.
3. Revise os **Preços de lance do modelo**. O painel exibe o preço máximo final e a taxa de entrega estimada para cada país configurado. Todos os outros países usarão o Preço Máximo padrão do modelo.
4. Selecione **Avançar**, escolha os destinatários, revise a campanha e faça o envio.
As Campanhas em Massa não oferecem suporte a um multiplicador separado para cada mensagem. Cada destinatário utiliza o Preço Máximo salvo no modelo, incluindo o multiplicador do país aplicável. Para definir um multiplicador por mensagem, faça o envio pela API.
## Tópicos relacionados
* [Preços do WhatsApp](/pt/documentation/whatsapp-business-platform/pricing-limits-and-quality/whatsapp-pricing)
* [Criar uma campanha de marketing no WhatsApp](/pt/documentation/campaign/create-a-whatsapp-marketing-campaign)
* [Guia de Integração do Preço Máximo](/pt/api-reference/guides/whatsapp-platform/max-price-integration-guide)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.