Perguntas frequentes

A WL API é uma API de WhatsApp brasileira: você conecta um número pelo QR Code e passa a enviar e receber mensagens pelo seu sistema, usando rotas REST e webhooks. É mantida pela WL Serviços Digitais Ltda (CNPJ 41.508.381/0001-00).

Crie uma instância no painel, leia o QR Code com o WhatsApp do celular e faça um POST na rota send-text com o telefone (DDI + DDD + número) e o texto, enviando o Client-Token no header. A resposta traz o id da mensagem, e a confirmação de entrega chega por webhook.

Texto, imagem, áudio, vídeo, documento, figurinha, link com prévia, localização, contato, enquete, reação, botões, lista de opções, botão de Pix e de código (OTP) e carrossel. Também é possível responder, mencionar, encaminhar e editar mensagens.

Você cadastra URLs na instância e recebe um POST em JSON a cada evento: mensagem recebida, mensagem enviada, status (entregue, lida), conexão e desconexão e presença. Se a sua URL não responder 2xx, tentamos de novo após 2, 4 e 8 segundos.

Sim. Dá para enviar mensagens em grupos, mencionar participantes e criar e administrar grupos pela API.

Sim. Qualquer sistema ou ferramenta que faça requisições HTTP e receba webhooks consegue usar a API. A documentação tem exemplos em curl, Node e PHP e uma coleção Postman.

Não. A WL API conecta o número como aparelho, do mesmo jeito que o WhatsApp Web. A API oficial é a WhatsApp Business Platform (Cloud API) da Meta, que exige aprovação, modelos de mensagem aprovados e cobra por conversa. WhatsApp é marca da Meta, e a WL API não tem relação com ela.

A oficial é a melhor escolha para disparos de marketing em grande volume e para quem não pode correr nenhum risco de bloqueio. A não oficial é mais simples de começar, usa o número que você já tem, não exige aprovação de modelos e custa um valor fixo por número, por isso costuma servir bem para atendimento, lembretes, confirmações e integrações de sistemas.

Pode. O WhatsApp bane números que recebem muitas denúncias ou se comportam como robô, e nenhuma API não oficial elimina esse risco. A fila com intervalo aleatório entre envios ajuda, mas o principal é falar só com quem pediu, aquecer números novos e evitar disparos em massa. Veja o guia de boas práticas.

Não cobramos por mensagem: todos os planos têm mensagens ilimitadas. O limite prático é o do próprio WhatsApp, que pune volumes que parecem spam.

O preço é por número (instância) por mês e cai conforme a quantidade de números da conta: R$ 49,90 no plano Start (1 a 4 números), R$ 39,90 no plano Pro (5 a 19 números), R$ 29,90 no plano Business (20 a 99 números), R$ 19,90 no plano Parceiro (100 ou mais números). Mensagens ilimitadas em todos os planos.

Sim. Cada instância nova tem 2 dias grátis, sem cartão de crédito.

Em Pagamentos, no painel, com dois cliques e sem multa. A instância funciona até o fim do período pago. Pessoa física tem 7 dias de arrependimento com reembolso integral na primeira assinatura.

Sim. Ative a emissão de NFS-e nos dados da conta.

Sim. A partir de 100 números você vira Parceiro, paga a partir de R$ 19,90 por número e usa a Partner API para criar instâncias dos seus clientes por código.

Na maioria dos casos, sim, e rápido: as rotas, os headers e os payloads de webhook seguem o mesmo formato. Normalmente basta trocar a URL base, o ID e o token da instância e o Client-Token, e ler o QR Code de novo. Teste nos 2 dias grátis antes de cancelar o serviço anterior.

Comparando preços de lista por número: a Z-API anunciava R$ 99,99 por mês (consulta em novembro de 2026), e a WL API cobra de R$ 49,90 a R$ 19,90, conforme a quantidade de números. Confira sempre o preço atual no site de cada fornecedor.