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 retorno de chamada (callback):
Outros campos são descritos em Recuperar uma mensagem.
3. Regras de preços
3.1 Definição final de preço
A YCloud relata preços estimados ou finais de acordo com o status da mensagem:3.2 Tipos de preços cobráveis e gratuitos
A YCloud relata os três tipos de preços a seguir por meio depricingType:
A partir de 1º de outubro de 2026, a franquia de serviço será reiniciada mensalmente para cada número de telefone comercial. A franquia não utilizada não acumula para o mês seguinte, e mensagens de serviço individuais e em grupo compartilham a mesma franquia. Quando esgotada, as mensagens de serviço individuais passam a usar o preç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 preços de ponto de entrada gratuito continuarão a usar free_entry_point.
Uma janela de ponto de entrada gratuito é iniciada 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 (desktop) e web não são elegíveis para essa regra de ponto de entrada.
4. Exemplos de payload de webhook
Os seguintes trechos de retorno de chamada representam mensagens individuais (one-to-one). Os IDs e valores cobrados são meramente ilustrativos, não cotações de tarifas reais. Para obter payloads completos, consulte Exemplos de webhook de mensagem atualizada do WhatsApp.4.1 Mensagem de marketing: cobrável
Uma mensagem de marketing entregue utiliza o preçoregular. O valor final ilustrativo é 0.05 USD.
4.2 Mensagem de serviço: cobrá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 elegível para o preço de ponto de entrada gratuito, a YCloud relatarápricingType=regular. O valor final ilustrativo é 0.01 USD.
4.3 Mensagem de serviço: dentro do limite gratuito
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 informapricingType=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 informapricingType=free_entry_point, pricingCategory=referral_conversion e um valor final de 0.