Saltar para o conteúdo principal
A YCloud fornece informações de preços por mensagem por meio de webhooks de atualização de mensagens do WhatsApp. Este guia descreve o evento de assinatura, os campos de preços, as regras de cobrança e quando os preços das mensagens se tornam definitivos. A YCloud cobra apenas por mensagens do WhatsApp de saída (mensagens enviadas da sua empresa para os usuários). As mensagens recebidas são gratuitas.

1. Evento de assinatura

A YCloud envia atualizações de status e preços de mensagens por meio do evento whatsapp.message.updated. As assinaturas estão disponíveis em Desenvolvedores → Webhook no Console da YCloud. A solicitação a seguir cria uma assinatura por meio da API. Consulte Criar um endpoint de webhook para a referência do endpoint:
url especifica o endpoint de recebimento do webhook. O tratamento de eventos e a verificação de assinatura são descritos no Guia de integração de webhook.

2. Campos de preços

As informações de preços estão incluídas no objeto whatsappMessage do callback: Outros campos são descritos em Obter uma mensagem.

3. Regras de preços

3.1 Definitividade de preços

A YCloud relata preços estimados ou definitivos de acordo com o status da mensagem: Para mensagens de marketing com Preço Máximo, o teto de preço efetivo é o maxBid do modelo multiplicado pelo multiplicador de país e pelo multiplicador por mensagem. Use o totalPrice entregue/lido para a cobrança final. Consulte o Guia de integração do Preço Máximo para configuração e o exemplo de lance entregue para ver um callback completo.

3.2 Tipos de precificação tarifável e gratuita

A YCloud relata os seguintes três tipos de precificação por meio de pricingType: A partir de 1º de outubro de 2026, a franquia de serviço será redefinida mensalmente para cada número de telefone comercial. A franquia não utilizada não acumula, e as mensagens de serviço individuais e em grupo compartilham a mesma franquia. Quando ela se esgota, as mensagens de serviço individuais passam a usar a precificação regular, a menos que as regras de ponto de entrada gratuito se apliquem. A partir da mesma data, modelos de utilidade dentro da janela de atendimento ao cliente não serão mais gratuitos apenas porque a janela está aberta e não serão cobertos pela franquia de serviço. Mensagens qualificadas para precificação de ponto de entrada gratuito continuam a usar free_entry_point. Uma janela de ponto de entrada gratuito é aberta quando um usuário envia uma mensagem para uma empresa por meio de um anúncio de clique para o WhatsApp ou de um botão do WhatsApp em uma Página do Facebook usando o WhatsApp para Android ou iOS, e a empresa responde dentro de 24 horas. A janela dura 72 horas a partir da resposta da empresa. Os clientes do WhatsApp para computador e web não se qualificam para esta regra de ponto de entrada.

4. Exemplos de payload de webhook

Os seguintes trechos de retorno de chamada representam mensagens individuais. Os IDs e valores cobrados são ilustrativos, não cotações reais de tarifas. Para obter os payloads completos, consulte Exemplos de Webhook para WhatsApp Message Updated.

4.1 Mensagem de marketing: faturável

Uma mensagem de marketing entregue utiliza a precificação regular. O valor final ilustrativo é 0.05 USD.

4.2 Mensagem de serviço: faturável

A partir de 1º de outubro de 2026, quando o número de telefone comercial tiver esgotado sua franquia mensal de 1.000 mensagens de serviço gratuitas e a mensagem não for qualificada para a precificação de ponto de entrada gratuito, a YCloud reportará pricingType=regular. O valor final ilustrativo é 0.01 USD.

4.3 Mensagem de serviço: dentro da franquia gratuita

A partir de 1º de outubro de 2026, para uma mensagem coberta pela franquia mensal de 1.000 mensagens de serviço gratuitas do número de telefone comercial, a YCloud reportará pricingType=free_customer_service e um valor final de 0.

4.4 Mensagem de ponto de entrada gratuito

Para uma mensagem entregue dentro da janela de 72 horas do ponto de entrada gratuito, a YCloud reportará pricingType=free_entry_point, pricingCategory=referral_conversion e um valor final de 0.