Dúvidas sobre a Chasque
Como funciona, quanto custa, o que a Meta cobra e como integrar. Não achou a resposta? Fale com a equipe.
Produto
O que é a Chasque?
A camada de infraestrutura que liga o WhatsApp ao seu software pela Cloud API da Meta. Você conecta o número, gera uma chave e envia com POST /v1/messages. Cada mudança de status (na fila, enviado, entregue, lido, falhou) chega no seu webhook, assinada.
A Chasque usa a API oficial do WhatsApp?
Sim. As mensagens passam pela Cloud API da Meta e a Chasque atua como provedora de tecnologia (Tech Provider). A Chasque não é afiliada ao WhatsApp ou à Meta.
Por que não integrar direto na Meta?
Pode, e a Chasque usa a mesma Cloud API oficial. A diferença é o que fica com o seu time: direto na Meta, você mantém o app e os tokens, recebe e valida os webhooks, trata novas tentativas e códigos de erro e monta logs e painel. Na Chasque, essa camada já está pronta: você integra uma API REST com uma chave e acompanha tudo pelo painel. As tarifas por mensagem continuam sendo cobradas pela Meta, sem markup.
Preciso criar um app na Meta ou passar por App Review?
Não. Você conecta o número pelo Embedded Signup do app da Chasque, numa janela da própria Meta. A verificação do app e as permissões ficam com a Chasque.
Posso usar o número que já uso no app WhatsApp Business?
Sim, com o Coexistence: a empresa continua atendendo pelo app e a sua integração usa a API. Ao conectar, isto muda no app:
- Aparelhos conectados (WhatsApp Web, desktop) são desvinculados.
- Mensagens temporárias, visualização única e localização em tempo real ficam desativadas nas conversas 1:1.
- Listas de transmissão ficam somente leitura.
- O app precisa ser aberto no celular pelo menos a cada 14 dias, senão a Meta desconecta o número.
- Grupos, ligações e catálogo continuam só no app.
Preços e cobrança
Quanto custa?
Free: R$ 0, 1 número e 1.000 mensagens por mês. Starter: R$ 59, 2 números e 10.000 mensagens incluídas (excedente R$ 8 por 1.000). Pro: R$ 179, 5 números e 50.000 incluídas (excedente R$ 6). Business: R$ 399, 15 números e 200.000 incluídas (excedente R$ 4), contratado com a equipe. A cota conta só mensagens enviadas pela API; mensagens recebidas nunca são bloqueadas. Veja os planos.
A Meta cobra à parte?
Sim. A Meta cobra por mensagem enviada pela Cloud API, direto no cartão cadastrado na sua conta WhatsApp Business. Essa tarifa não está no preço da Chasque e é repassada sem markup: ela varia por categoria e, a partir de 1º de outubro de 2026, mensagens de serviço também passam a ser cobradas no Brasil. O plano Free é gratuito na Chasque, não no WhatsApp. Mensagens enviadas pelo app, no Coexistence, continuam sem custo.
O que acontece quando a cota do mês acaba?
Aos 80% o seu webhook recebe o evento account.quota_warning, e o painel e um e-mail avisam. No Free, aos 100% novos envios respondem 402 quota_exceeded até o mês seguinte ou até um upgrade. Nos planos pagos você escolhe em Plano: por padrão a cobrança fica limitada à mensalidade e os envios pausam até o dia 1; se autorizar a cobrança por uso, os envios continuam como excedente, cobrado por mil na fatura seguinte, até o limite mensal que você define (ao atingi-lo, 402 spend_cap_reached). Mensagens recebidas continuam chegando.
Como evito uma fatura inesperada?
A cobrança por uso é opcional e vem desligada: sem ela, você paga só a mensalidade e os envios param ao fim da cota incluída. Se ligar, em Plano, defina o limite de gasto mensal com excedente (o padrão é uma mensalidade). Ao atingir o limite, os envios pausam até o dia 1 e você recebe um e-mail; aumentar o limite libera na hora. O excedente entra na fatura da assinatura, nunca numa cobrança à parte.
Como cancelo a assinatura?
No painel, em Plano › Gerenciar assinatura. A conta volta para o Free no fim do período pago, sem perder dados.
Mensagens e WhatsApp
Por que minha mensagem falhou com window_closed?
O WhatsApp só aceita texto livre até 24 h depois da última mensagem do usuário. Fora dessa janela, e em toda conversa nova, envie um template aprovado. O template hello_world vem aprovado em toda conta WhatsApp Business e serve para o primeiro teste.
Quem aprova os templates?
A Meta. Você cria o template no painel ou pela API, acompanha o status em Templates e recebe o resultado no evento template.status_updated. O prazo da análise é da Meta.
O que é o user_id que chega nos eventos?
É o identificador do usuário na sua conta (BSUID). Quem usa username no WhatsApp pode ocultar o telefone, e aí from.phone chega como null. Guarde o user_id: dá para enviar mensagens para ele no campo to.
Integração
Como recebo mensagens e status?
Por um webhook por conta, configurado no painel. Cada entrega traz o header Chasque-Signature (HMAC-SHA256 com o seu signing secret) e Chasque-Event-Id para deduplicar. Se o seu servidor não responder 2xx, tentamos de novo em 30 s, 2 min, 10 min, 1 h, 6 h, 12 h e depois a cada 24 h, por até 7 dias; cada entrega fica no painel, com reenvio manual. Tentativas atrasadas podem chegar repetidas ou fora de ordem: deduplique pelo Chasque-Event-Id.
Como evito enviar a mesma mensagem duas vezes?
Envie o header Idempotency-Key com um valor único por mensagem. Se a requisição for repetida com a mesma chave, a API devolve o resultado da primeira sem enviar de novo.
Onde está a referência completa da API?
Na documentação, gerada do OpenAPI (/openapi.json), com exemplos de envio, erros e eventos.
Conta e dados
Como crio a conta?
Com a sua conta do GitHub. Não pedimos senha nem acesso aos seus repositórios. Durante o beta a entrada é por convite: peça pelo formulário de contato.
Como os dados são protegidos?
O token da Meta fica cifrado (AES-GCM), as chaves de API são guardadas só como hash e todo o tráfego usa HTTPS. Os logs de mensagens são apagados depois de 3, 14, 30 ou 90 dias, conforme o plano. Detalhes na Política de privacidade.
Como apago minha conta e meus dados?
Siga a página de exclusão de dados ou envie o pedido pelo formulário de contato, com o e-mail da sua conta do GitHub.
Ainda com dúvida?
Escreva para a equipe. Respondemos no e-mail que você informar.