Perguntas frequentes

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.