consultando status

WhatsApp API, como sempre deveria ter sido.

Conecte seu número com QR ou pairing code e envie e receba mensagens via REST e webhooks assinados.

  1. Set up wuapi (a WhatsApp API: numbers linked as devices, REST and signed webhooks) in this project.
  2. Instalando as skills do wuapinpx skills add wuapidev/wuapipronto
  3. Instalando @wuapidev/sdkpronto
  4. Conectando o MCP server do wuapiwuapi.dev/api/mcppronto
  5. Conectando seu número…pairing code K7PQ-2M9X
  6. Número prontopronto
  7. Enviando uma mensagem de teste para +58 424 111 2233
  8. 202 queuedmessage.sentmessage.deliveredmessage.readpronto
  9. Pronto. Seu agente já manda e recebe mensagens no WhatsApp.

00/Setup com agente

Deixe o setup com seu agente

A mesma sessão da aba Agente, rodando no seu projeto.

Copie o prompt de setup pro seu agente
Funciona com qualquer modelo, agente ou editor

O que o prompt faz

01/Preço

Economize até 99% em relação à API oficial

A Cloud API oficial cobra cada mensagem, respostas incluídas. O wuapi cobra por número conectado. Veja 100.000 mensagens por mês, 5% de marketing e o resto de utilidade e respostas, no país dos seus destinatários.

100.000
1 número

Cloud API oficial

US$ 951/mês

cobrado por mensagem

wuapi

US$ 7/mês

1 número · sem taxa por mensagem

Você economiza

99%

US$ 11.328 a menos por ano

Brasil: marketing $0.0625 · utilidade e respostas $0.0068 · tarifas válidas a partir de 1 de out. de 2026 · conferidas em 2026-09-27. Os 99% são o caso de Alemanha, onde mais se economiza com 100.000 mensagens por mês e 5% de marketing, sem contar taxas do provedor.

02/Segurança

Seguro para os seus números e para os dos seus clientes

Nossa equipe tem mais de 10 anos de WhatsApp, criando agentes e SaaS. Fizemos o wuapi para ser fácil, escalar junto com você e ser seguro sem você mudar sua arquitetura: uma camada de proxy e uma de segurança protegem as suas contas e as dos seus clientes.

camada de proxy

Cada número, seu ou de cliente, conecta pelo próprio IP residencial no país dele e nunca cai para um datacenter.

camada de segurança

Webhooks assinados, keys restritas ao projeto de cada cliente, API keys guardadas como hash e sessões criptografadas.

escala

A mesma API de um número a centenas, com um projeto por cliente e envios em fila que esperam a conexão voltar.

Ritmo de envio e limites de primeiro contato são opcionais, por conta.

Como protegemos seus números

03/Suporte

Quem responde entende de WhatsApp

A mesma equipe, com mais de 10 anos construindo em cima do WhatsApp, responde você no chat. E a conexão fica monitorada 24 horas por dia.

a gente cuida disso

A gente cuida de reconexões e quedas de proxy 24 horas por dia. Você só fica sabendo de um número se ele continuar fora.

uptime que dá para conferir

Uma status page pública, checada a cada minuto, e um SLA com créditos de serviço de até 99.95%.

gente que conhece whatsapp

Fale direto com nossos engenheiros em qualquer plano, inclusive o Free. O tempo de resposta segue seu plano de suporte: a partir de 30 minutos no Enterprise.

Abrir o chat

100+ organizações no mesmo build, na mesma engine e na mesma status page

04/Como funciona

Comece a usar a API em um minuto

Crie sua conta, conecte o número que você já tem e envie. Sem verificação de empresa, sem templates para aprovar.

01

Cadastro sem cartão

O plano Free tem um número e 2.000 mensagens por mês, com envio, webhooks e a Caixa de entrada funcionando.

02

Vincule um número

Escaneie o QR em Dispositivos conectados no celular ou digite o pairing code. O número continua funcionando no celular.

03

Envie via REST

Você recebe um 202 na hora e, depois, os status enviado, entregue e lido conforme acontecem.

04

Receba por webhooks

Mensagens, confirmações de leitura e chamadas chegam no seu endpoint, assinadas e com retries.

Um envio visto de fora: a chamada retorna na hora e cada etapa chega depois no seu webhook.

eventos da msg k57a…0vbros tempos são um exemplo
  1. →POST /v1/messages202 queued+0.0s
  2. ·digitando…aparece para o destinatário+0.1s
  3. ←message.sentwebhook+1.9s
  4. ←message.deliveredwebhook+2.4s
  5. ←message.readwebhook+41s

Mande pros seus clientes um link para conectar o WhatsApp deles

Feito para quem constrói SaaS e agentes de IA

Eles abrem uma página com seu nome e logo, escaneiam ou digitam um código, e o WhatsApp deles entra no seu projeto. Você nunca vê um QR.

  1. 1

    Dê um projeto para cada cliente

  2. 2

    Mande um link com seu nome e logo

  3. 3

    O número cai no projeto dele

Como funcionam os convites
wuapi.dev/invite/7c1e…
a api inteira

Tudo o que um dispositivo vinculado faz, via REST

/

12tipos de mensagem em um só endpoint

  • Texto, imagem, vídeo, áudio, mensagens de voz, documentos, figurinhas
  • Localização, contatos, enquetes, eventos de agenda
  • Respostas, menções, reações, favoritas
  • Editar e apagar para todos
Envios na documentação
  • Crie grupos e comunidades
  • Adicione, remova, promova e rebaixe
  • Links de convite, entrar por convite
  • Aprove ou recuse pedidos para entrar
  • Confirmações de leitura, marcar como lida ou não lida
  • Digitando e gravando, presença online
  • Arquivar, fixar, silenciar, apagar, etiquetas
  • Duração das mensagens temporárias
canais11 ops
  • Criar, seguir, silenciar
  • Publique texto, imagens, vídeo e documentos
  • Ler, reagir, marcar como visto
  • Publique um status de qualquer número
  • Em fila e com ritmo, como um envio
  • Leia a privacidade dos seus status
  • Veja quais números estão no WhatsApp
  • Consulte nomes, fotos e perfis comerciais
  • Bloquear, desbloquear, seu link de contato
  • Nome, recado e foto
  • Todas as configurações de privacidade, leitura e escrita
  • call.received e call.ended no seu webhook
  • Recuse uma chamada, ou todas com uma resposta em texto
  • 34 tipos de evento por endpoint
  • Assinados com HMAC-SHA256
  • Retries: 30s · 2m · 10m · 1h · 6h
  • Importe as conversas recentes quando um número é vinculado
  • Desligado por padrão, por conta
  • Um webhook por lote, com contagens
  • Um projeto por cliente, com keys e webhooks próprios
  • Links de convite com a sua marca
  • Uso por projeto, para repassar a cobrança
  • SDK TypeScript tipado
  • Spec OpenAPI 3.1
  • MCP server para Claude, Cursor e VS Code
  • A documentação num arquivo só, pra agentes

118 operações · OpenAPI 3.1 · REST, SDK TypeScript e MCP

Ver as 118 operações

05/Quando não usar o wuapi

Quando a API oficial é a melhor ferramenta

O wuapi é um número vinculado como dispositivo, feito para conversas. Para algumas coisas a Cloud API oficial do WhatsApp é melhor, e preferimos avisar logo.

Use a Cloud API oficial quando

  • Você inicia a maioria das conversas e precisa de templates aprovados em volume.
  • Você envia campanhas de marketing para quem nunca falou com você.
  • Você precisa do selo verde ao lado do nome da empresa.
  • Você é um grande remetente num setor regulado e precisa de um contrato com a plataforma.

Ou use os dois

Um número, dois lados. Coloque o número do seu app WhatsApp Business na API oficial pela coexistência e envie os templates por lá. Vincule o wuapi ao mesmo número como dispositivo acompanhante e responda por ele: respostas enviadas pelo lado do app não pagam taxa por mensagem.

Só oficial
$220
Coexistência + wuapi
$132

Brasil · um número · 2.000 templates + 15.000 respostas por mês · tarifas válidas a partir de 1 de outubro de 2026

Como usar os dois, passo a passo

06/Perguntas

Antes de começar

Respostas diretas. Mais sobre cobrança nas perguntas sobre preços.

Comece grátis
Preciso de verificação da empresa ou de templates aprovados?

Não. Você vincula um número que já tem, com QR code ou pairing code, e envia via REST. Verificação, templates e a janela de 24 horas são coisa da Cloud API oficial do WhatsApp. Se a maioria das suas conversas começa com templates em volume, ela é a ferramenta certa, e as duas podem rodar lado a lado.

Use a API oficial e o wuapi juntos
Tem plano grátis?

Tem, e não pede cartão: 1 número, 2.000 mensagens e 0,5 GB de tráfego de proxy por mês, com envio, webhooks e a Caixa de entrada funcionando. Mensagens enviadas e recebidas contam juntas. Quando um limite é atingido, o número pausa, continua vinculado e volta sozinho quando o mês acaba (UTC). Faça upgrade quando quiser para conectar mais números e tirar os limites; seu primeiro pagamento tem garantia de reembolso de 14 dias.

Meus clientes podem conectar os próprios números?

Podem. Dê um projeto para cada cliente e mande um link de convite: uma página com seu nome, logo e cor onde ele escaneia um QR code ou digita um pairing code. O número cai no projeto dele, com keys e webhooks próprios, e você recebe invitation.status_changed quando ele conecta. O add-on White label (US$ 100 por mês) tira a marca do wuapi da página e do e-mail.

O que acontece se um celular ficar offline?

O número continua vinculado e o wuapi segue reconectando, pela mesma saída de proxy. Mensagens enviadas durante uma queda curta ficam esperando e saem assim que ele volta. Se a queda continuar, você recebe account.disconnected no seu webhook e account.connected quando ele voltar, além de notificações no dashboard.

Seu primeiro número está a um QR de distância.

Cadastre-se e conecte um número sem cartão. O Free inclui 1 número, 2.000 mensagens e 0,5 GB de tráfego de proxy por mês. Quando fizer upgrade, seu primeiro pagamento tem garantia de reembolso de 14 dias.

Comece grátis
npm install @wuapidev/sdk

Fale com vendas

Planos maiores? Vamos conversar.

Conte o que você está construindo. Uma pessoa lê cada mensagem e responde por e-mail.

  • Colocar centenas de números no ar
  • Suporte Enterprise a partir de US$ 4.900 por mês
  • Uma plataforma com um projeto por cliente
  • Revisão de segurança ou termos sob medida
Números de WhatsApp que você pretende conectar

Respondemos por e-mail.