Pular para o conteúdo
Contratação 100% online · Pagamento por Pix com baixa automática.
Primux

API de WhatsApp

Envie mensagens de texto para contatos e grupos e links com prévia pelo seu sistema, com uma API simples, em português, cobrada por sessão.

  • Texto para contatos e grupos de WhatsApp
  • Link com prévia (título, descrição e imagem)
  • Conexão por QR code ou por código
Veja por dentro

Uma sessão por número, sob o seu controle

Conecte o seu número de WhatsApp, gere a chave de API e acompanhe o uso, tudo pelo painel.

  • Conexão por QR code ou código
    Escolha ler um QR code ou digitar um código de 8 caracteres no WhatsApp do celular. A conexão só é liberada depois do pagamento.
  • Chave de API sua
    Gere a chave pelo painel e use no cabeçalho das chamadas. Gerar outra invalida a anterior.
  • Uso e limites à vista
    Veja quantas mensagens, grupos e links foram enviados no dia e no mês, e os limites do plano.
  • Renovação e cancelamento simples
    Renove pelo painel e, se cancelar, o valor do período não usado volta como crédito.
platform.primux.com.br
Tela do painel: sessão da API de WhatsApp
Tela do console da Primux Cloud (dados de exemplo)
Por dentro da ferramenta

A API de WhatsApp por dentro

Veja as telas que você usa no dia a dia depois de contratar.

1

Envie mensagens com uma chamada

Uma requisição HTTP envia a mensagem pelo seu número de WhatsApp.

  • Uma chamada HTTP, resposta em português
  • Chaves de API geradas no console
Documentação · API de WhatsApp
Envie mensagens com uma chamada Clique para ampliar
Captura real da ferramenta, com dados fictícios de exemplo.
2

Conecte o número pelo QR

Leia o QR code uma vez e a sessão fica conectada.

  • Conecte uma vez e use sempre
  • Sessão conectada acompanhada no painel
API · Sessão conectada
Conecte o número pelo QR Clique para ampliar
Captura real da ferramenta, com dados fictícios de exemplo.
3

Saiba quanto você pode enviar

Conheça os limites por minuto e por dia, os estados da sessão e os códigos de erro.

  • Limite diário e por minuto de cada plano
  • Erros claros, em português
Documentação · Limites
Saiba quanto você pode enviar Clique para ampliar
Captura real da ferramenta, com dados fictícios de exemplo.
Casos de uso

Para que usar

Alguns exemplos de como os clientes aproveitam este serviço.

Avisos de pedido e entrega

Informe o cliente quando o pedido for confirmado, enviado ou entregue, direto do seu sistema.

Lembretes e cobranças

Mande lembretes de consulta, vencimentos e agendamentos para quem já é seu cliente.

Equipe e grupos

Publique alertas e relatórios em grupos de WhatsApp da sua equipe automaticamente.

Planos e preços

Escolha o seu plano

Valores em reais. Pagamento por Pix.

Planos em breve

Os planos deste serviço ainda estão sendo preparados. Crie a sua conta para acompanhar ou fale com o suporte para saber mais.

Documentação

Como usar a API

Rotas, campos e respostas em português. Todas as chamadas usam JSON e a chave da sua sessão.

Autenticação

Envie a chave da sessão no cabeçalho Authorization, no formato Bearer. A chave é gerada no painel e mostrada uma única vez; gerar outra invalida a anterior. Guarde-a como uma senha e nunca a coloque em páginas ou aplicativos públicos.

Endereço da API: https://api.primux.com.br

Rotas

GET /v1/whatsapp/sessaoSituação da sessão: estado, número conectado, plano e validade.
POST /v1/whatsapp/mensagensEnvia um texto para um contato (campos para e texto).
POST /v1/whatsapp/grupos/mensagensEnvia um texto para um grupo (campos grupo e texto).
POST /v1/whatsapp/mensagens/linkEnvia um link com prévia para um contato ou grupo (para ou grupo, texto e url).
POST /v1/whatsapp/mensagens/imagemEnvia uma imagem PNG ou JPEG (em base64, até 5 MB) para um contato ou grupo, com legenda opcional.
POST /v1/whatsapp/mensagens/documentoEnvia um documento PDF (em base64, até 5 MB) para um contato ou grupo, com nome de arquivo e legenda opcionais.
GET /v1/whatsapp/gruposLista os grupos em que o número participa.
GET /v1/whatsapp/usoUso do dia e do mês, por tipo, e o que resta do limite diário.

Limites e boas práticas

  • O plano define o limite de envios por dia (zera à meia-noite) e por minuto; acima dele a API responde 429.
  • Números aceitam máscara; sem o código do país, o Brasil (+55) é assumido.
  • Textos têm até 4096 caracteres; links precisam ser http ou https públicos.
  • Envie só para quem autorizou receber mensagens. Spam é proibido e pode bloquear o seu número.
  • Imagens e PDFs têm até 5 MB (base64 no corpo, até 8 MB); só PNG, JPEG e PDF são aceitos.

Leia os termos de uso da API de WhatsApp

Documentação completa da API ›

Enviar texto para um contato

curl -X POST https://api.primux.com.br/v1/whatsapp/mensagens \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"para":"77999999999","texto":"Olá! Seu pedido saiu para entrega."}'

Enviar texto para um grupo

curl -X POST https://api.primux.com.br/v1/whatsapp/grupos/mensagens \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"grupo":"120363025246125486","texto":"Reunião às 15h."}'

Enviar link com prévia

curl -X POST https://api.primux.com.br/v1/whatsapp/mensagens/link \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"para":"77999999999","texto":"Confira nossa novidade:","url":"https://exemplo.com.br/novidade"}'

Resposta de sucesso

{
  "id": "3EB01931ACD50366D198B8",
  "estado": "enviada",
  "enviada_em": "2026-11-03T14:30:00Z"
}

Resposta de erro

{
  "erro": "numero_sem_whatsapp",
  "mensagem": "Este número não tem WhatsApp."
}

Erros

Todo erro traz um código estável (campo erro) e uma mensagem em português (campo mensagem).

StatusCódigoQuando acontece
401chave_invalidaChave ausente, errada ou mal formatada.
403chave_de_outra_apiA chave pertence a outro tipo de API.
403sessao_suspensaA sessão foi suspensa por falta de pagamento.
403sessao_canceladaA sessão foi cancelada.
409sessao_nao_conectadaA sessão ainda não foi conectada ao WhatsApp ou foi desconectada.
422numero_invalidoO número informado não tem formato válido.
422numero_sem_whatsappO número não tem WhatsApp.
422grupo_invalidoIdentificador de grupo inválido.
422destino_invalidoCampo de destino na rota errada: contato em /mensagens, grupo em /grupos/mensagens.
422texto_vazioO texto é obrigatório.
422texto_grandeO texto passa de 4096 caracteres.
422url_invalidaLink inválido ou não público.
422imagem_invalidaImagem inválida: envie PNG ou JPEG de até 5 MB, em base64.
422documento_invalidoDocumento inválido: envie um PDF de até 5 MB, em base64.
400corpo_invalidoJSON inválido ou com campos desconhecidos.
429limite_por_minutoLimite de envios por minuto do plano atingido.
429limite_diarioLimite diário de envios do plano atingido.
502falha_no_envioO WhatsApp não aceitou a mensagem; tente de novo.
503servico_indisponivelO serviço não respondeu agora; tente de novo.
Contratação sem risco
Sem fidelidade

Cancele pelo painel quando quiser e receba como crédito o valor do período que não usou.

Ativação automática

O serviço é ativado assim que o pagamento é confirmado: na hora com Pix e em até 3 dias úteis com boleto.

Suporte em português

Abra chamados pelo painel, acompanhe as respostas e receba aviso por e-mail.

Outros produtos

Conheça também

Dúvidas

Perguntas frequentes

Preciso do WhatsApp Business oficial?

Não. A API conecta o número de WhatsApp que você já usa, como um aparelho conectado. Ela não é a API oficial da Meta, por isso há riscos descritos nos termos de uso.

Meu número pode ser bloqueado?

Pode. Envio em massa, mensagens sem consentimento e denúncias de spam podem levar a Meta a restringir o número. Use apenas com quem autorizou receber as suas mensagens e leia os termos de uso.

Posso enviar para grupos?

Sim. O número conectado precisa participar do grupo. A API lista os grupos e envia texto e links para eles.

Como funciona a cobrança?

É cobrada por sessão (um número de WhatsApp), por mês ou por ano, no mesmo painel dos outros serviços, com Pix ou boleto. A sessão só é criada depois do pagamento confirmado.

Como faço para contratar?

Escolha o plano, clique em Contratar e entre ou crie a sua conta. A sua escolha fica salva: depois do cadastro é só concluir a contratação e pagar.

Quais são as formas de pagamento?

O pagamento é feito pela própria plataforma, por Pix ou boleto, com baixa automática. Você também pode manter saldo na conta para pagar pedidos e renovações.

Posso pagar com boleto?

Sim. Você escolhe Pix ou boleto na hora de pagar. O Pix é confirmado na hora; o boleto, em até 3 dias úteis. Para emitir boleto é preciso ter o CPF ou CNPJ e o endereço no cadastro.

Preciso ter conhecimento técnico?

Não para começar: o painel tem gerenciador de arquivos, instalador de WordPress e terminal no navegador. Para máquinas virtuais e servidores dedicados, saber administrar servidores ajuda.

Posso trocar de plano depois?

Sim. Você troca o plano pelo painel e paga só a diferença proporcional ao período que falta. Se o novo plano for mais barato, o valor não usado vira crédito na conta.

O que acontece se eu atrasar o pagamento?

Enviamos avisos por e-mail antes do vencimento. Sem o pagamento, o serviço é suspenso até a regularização.

Ainda com dúvida sobre qual plano escolher?

Escreva para o suporte e indicamos a melhor opção para o seu projeto.

Falar com o suporte

Pronto para começar?

Crie a sua conta em poucos minutos e contrate o primeiro serviço quando quiser.

Ver planos Criar conta