1. Evento de assinatura
A YCloud envia atualizações de status e preços de mensagens por meio do eventowhatsapp.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 objetowhatsappMessage 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 depricingType:
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çãoregular. 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.

