Central de ajuda

No painel, abra a instância. Aparece um QR Code. No celular da empresa, abra o WhatsApp, toque em Aparelhos conectados e em Conectar um aparelho, e aponte a câmera para o QR. Funciona com o WhatsApp normal e com o WhatsApp Business.

O QR muda sozinho a cada poucos segundos: aponte a câmera assim que ele aparecer. Confira se o celular está com internet e com o WhatsApp atualizado. Se o WhatsApp disser que o limite de aparelhos foi atingido, desconecte um aparelho antigo em Aparelhos conectados. Não conseguiu? Use a aba Código pelo número: você digita um código no celular em vez de ler o QR.

Não: o ID e o Token continuam os mesmos e o seu sistema não precisa mudar nada. Abra a instância e leia o QR de novo. Costuma desconectar quando alguém remove o aparelho no celular, quando o celular fica muitos dias sem internet ou quando o WhatsApp é reinstalado. Mandamos um aviso quando isso acontece.

Não precisa deixar o WhatsApp aberto. Mas o celular precisa entrar na internet de vez em quando: se ficar muitos dias sem conexão, o WhatsApp desconecta os aparelhos ligados a ele.

Pode. Na instância há o Link de conexão para o seu cliente: mande o link e ele lê o QR pelo próprio celular, de onde estiver. No pacote Parceiro Pro, essa tela sai com a sua marca.

No painel, na página da instância, em Credenciais da API. O endereço base é https://api.pluguizap.com.br. Teste sem programar na aba Testar a API.

401 com null not allowed: faltou o cabeçalho Client-Token. 401 com "Instância ou token inválido": ID ou Token errados. 402: a instância está pausada por falta de pagamento. 409: o número não está conectado, leia o QR de novo.

DDI + DDD + número, só os dígitos: 5579999998888. Pode mandar com ou sem o nono dígito: a API descobre o certo. Para grupo, use o ID que termina em -group.

O número pode não ter WhatsApp: confira com GET phone-exists/{telefone} antes de enviar. Também acontece quando o contato bloqueou o número da empresa.

Use POST send-document/pdf com o link público do arquivo ou o conteúdo em base64. As bibliotecas prontas (Delphi, PHP, Java, C#, Python e Node) têm uma função que envia direto um arquivo do disco. Veja a documentação.

Sim. O WhatsApp só mostra botões de verdade na API oficial da Meta. Aqui eles chegam como menu numerado ("responda 1, 2 ou 3") e a escolha volta no webhook no mesmo formato de botão, então o seu bot não muda.

Não recomendamos e os termos proíbem disparo para quem não conhece a empresa: é o que mais leva o WhatsApp a bloquear o número. Use para avisos, cobrança e atendimento de quem já é seu cliente. Já colocamos um intervalo automático entre os envios.

É o endereço do seu sistema que recebe, na hora, as mensagens que chegam no número, e os avisos de entregue, lida, conectou e desconectou. Configure na página da instância ou pela API (update-every-webhooks).

Abra a aba Webhook da instância: cada aviso aparece com o que o seu sistema respondeu. 401 ou 403: o endereço pede login ou confere um segredo diferente. 404: a URL está errada. 500: o seu sistema deu erro ao processar; veja o log dele. "Sem resposta em 15 segundos": responda 200 primeiro e processe depois.

Todo aviso traz o cabeçalho X-Webhook-Secret com o segredo da instância, que aparece na aba Webhook. Compare antes de aceitar. Cada instância tem o seu segredo.

Na aba Webhook, abra o aviso com erro e clique em Reenviar. Tentamos 3 vezes cada aviso, com alguns segundos de intervalo, antes de dar como erro.

Ignore os avisos com fromMe: true: são as mensagens que o próprio número enviou.

A primeira instância tem 3 dias grátis, sem cartão. Quando acaba, o envio pausa até a primeira mensalidade ser paga; o número continua conectado.

PIX, boleto e cartão de crédito, direto no painel em Faturas. PIX e cartão liberam na hora. No cartão, você pode salvar e deixar a cobrança automática todo mês.

O número continua conectado, mas o envio pela API pausa 2 dias depois do vencimento. Pagou, volta na hora. Depois de 30 dias sem pagamento, a instância é excluída.

Cada número avulso custa R$ 89,90 por mês. A partir de 5 números, os pacotes saem mais baratos por número e vêm numa fatura só. Veja e troque de pacote em Pacotes. Sem fidelidade.

Cada pessoa que se cadastrar pelo seu link e pagar gera 20% de cada fatura para você, enquanto ela continuar cliente. O link fica em Indique e ganhe.

Na tela de entrar, clique em Esqueci a senha e informe o e-mail ou o celular da conta. O link para criar uma senha nova chega no seu WhatsApp e vale por 1 hora.

Em Minha conta. É nesse WhatsApp que chegam as faturas, os avisos de desconexão e o link de senha.

Instância avulsa: exclua na página dela e a cobrança daquele número para na hora. Pacote: excluir uma instância só libera a vaga; para cancelar o pacote inteiro, fale com o suporte. Não há multa nem fidelidade.