Licenças e teste

Cada número de WhatsApp precisa de uma licença ativa para enviar e receber pela API. Não existe plano gratuito; há um teste gratuito de 7 dias em todo número novo.

Preços

Um único preço, em USD, por número, por mês — o mesmo para uma conexão qr ou uma conexão cloud_api, e independentemente do que você enviar por ela.

Sem assentos, sem limite de mensagens, sem tarifas por requisição do nosso lado. As cobranças de conversa da própria Meta para números cloud_api são faturadas pela Meta à sua WhatsApp Business Account, não por nós. A ativação e as faturas ficam em https://developers.wasync.app/billing.

Slots

Um slot é capacidade, não um número de telefone, e não é algo que você vincula a um cliente:

• Ele é associado quando um número realmente é pareado — criar o registro de uma conexão não consome um até esse momento.
• Excluir uma conexão devolve o slot ao pool, com o tempo que ainda restar nele. O próximo número que você conectar o aproveita automaticamente.
• É isso que permite mover um slot pago de um cliente que está saindo para um novo, sem pagar duas vezes e sem pedir a ninguém que intervenha.

Consulte GET /account antes de prometer capacidade: slots.available é o que POST /connections ainda pode consumir com uma licença ativa, e slots.nextExpiry é a data antes da qual você precisa renovar.

Excluir um número, encerrar um workspace

As duas ações são suas, pela tela Billing do console de desenvolvedores ou pela API.

• Excluir um número — DELETE /v1/connections/{id}, ou o botão Delete na linha da conexão. A sessão de WhatsApp dele é encerrada, todas as mensagens armazenadas para ele são removidas e um slot pago volta ao pool, como descrito acima.
• Encerrar um workspace — o botão Close workspace em um workspace sem conexões restantes. Ele remove o workspace junto com suas API keys e sua configuração de webhooks, então tudo o que ainda chamar a API com essas chaves deixa de funcionar.

Um workspace que ainda tem números não pode ser encerrado: exclua-os antes, para que os telefones sejam desvinculados em vez de deixar sessões para trás. Um workspace com uma assinatura de slot ativa também não pode ser encerrado — cancele a assinatura primeiro.

Nenhuma das ações pode ser desfeita. O que permanece é o registro de que um número já usou o teste gratuito: encerrar um workspace e abrir outro não dá ao mesmo telefone um segundo teste.

O teste

Um número novo começa com um teste de 7 dias no momento em que é pareado — seja por leitura de QR, seja pela digitação de um código de pareamento. Parear por código não consome nada a mais: mesmo slot, mesmo teste.

Quando a licença expira, a conexão deixa de ser acessível: ela desaparece de GET /connections, os eventos deixam de ser entregues e os envios respondem 402.

Limites de aquecimento em números qr novos

Um número qr recém-pareado tem 72 horas de limites de aquecimento no volume de envio por hora. Ultrapassar um deles retorna 429 warmup_limited — um limite por hora, então espere alguns minutos antes de tentar de novo e não faça laços de repetição sem pausa.

Esse é um limitador separado do limitador de abuso, que retorna 429 rate_limited. Respeite Retry-After quando ele estiver presente, mas mantenha sempre um tempo de espera padrão próprio: o cabeçalho não é garantido em todo 409/429.