# apiwpp > API de WhatsApp para enviar e receber mensagens com uma chamada HTTP. Preço fixo por número, webhooks assinados, fila anti-bloqueio e proxy brasileiro incluso. Summary (EN): apiwpp is a Brazilian WhatsApp API for developers. A number is connected as a linked device (WhatsApp Web protocol, unofficial) by QR code or pairing code; messages are sent with one HTTP call into a per-number queue that paces sends to protect the number (14-day warm-up, daily cap on new recipients); incoming messages, delivery statuses and connection changes reach the customer's webhook signed with HMAC-SHA256. Priced per connected number per month in BRL (LITE and PRO), unlimited messages within the pacing limits, billed through Asaas (PIX, boleto or card). Site: https://apiwpp.com · Documentação: https://apiwpp.com/docs · Cadastro: https://app.apiwpp.com/signup · Status: https://status.apiwpp.com · Contato: contato@apiwpp.com Atualizado em: 2026-09-28 · Texto completo para IA: https://apiwpp.com/llms-full.txt · Sitemap: https://apiwpp.com/sitemap.xml ## O que é apiwpp é uma API de WhatsApp para desenvolvedores, agências e empresas brasileiras. API de WhatsApp para enviar e receber mensagens com uma chamada HTTP. Preço fixo por número, webhooks assinados, fila anti-bloqueio e proxy brasileiro incluso. ## Como funciona 1. Conecte o número: Crie a conexão e escaneie o QR code em Aparelhos conectados, ou use o código de pareamento. A sessão fica salva e sobrevive a reinícios. 2. Envie pela API: Um POST com destinatário e mensagem. Texto, mídia, localização e templates entram numa fila que envia no ritmo certo para o número. 3. Receba no webhook: Mensagens recebidas, status de entrega e leitura e mudanças da conexão chegam assinadas no endereço do seu sistema. ## Recursos - Fila com ritmo anti-bloqueio: Envios em fila com limites por minuto, hora e dia, aquecimento automático e teto de novos destinatários. - Webhooks assinados: Cada evento chega com assinatura HMAC, entrega com novas tentativas automáticas e registro de cada entrega. - Sessões que não caem: A sessão do número fica salva e criptografada. Reinícios e atualizações não pedem um novo QR code. - Proxy brasileiro incluso: Cada número sai por um IP brasileiro. IP dedicado por número disponível como adicional no plano PRO. - Sem mensagens duplicadas: Envie com clientRef e repita a requisição sem medo: a mesma mensagem nunca entra duas vezes na fila. - Projetos separados: Separe sistemas ou clientes em projetos, cada um com chaves de API e webhook próprios, numa fatura só. ### Proteção do número Números novos que disparam em volume são os primeiros a cair. A apiwpp controla o envio para que o seu número se comporte como um número usado por pessoas. - 14 dias: de aquecimento a partir da conexão, com limites que crescem aos poucos. - Novos contatos: limite diário de destinatários que nunca falaram com o número. Contatos conhecidos seguem livres. - Fila: janelas por minuto, hora e dia. A API responde na hora com a posição e o horário previsto do envio. ## Preços - LITE: R$ 29 por número por mês. - PRO: R$ 49 por número por mês (edição e exclusão de mensagens, confirmação de leitura, presença e IP dedicado). - IP dedicado: + R$ 25 por número por mês, no plano PRO. - Mensagens ilimitadas dentro dos limites de envio. Teste grátis de 7 dias com 1 número e recursos PRO, sem cartão. Pagamento por PIX, boleto, cartão de crédito pela Asaas; 5 dias de carência numa fatura atrasada. ## Para quem é - Agências: Atenda vários clientes com números separados por projeto e cobrança centralizada. - SaaS e CRMs: Coloque o WhatsApp dentro do seu produto com webhooks para cada conversa. - E-commerce: Confirmação de pedido, rastreio e recuperação de carrinho no canal que o cliente lê. - Agendamentos: Lembretes e confirmações para clínicas, salões e barbearias, com resposta do cliente no seu sistema. ## Páginas - [Preços](https://apiwpp.com/precos) - [Recursos](https://apiwpp.com/recursos) - [Sobre](https://apiwpp.com/sobre) - [Contato](https://apiwpp.com/contato) - [Segurança](https://apiwpp.com/seguranca) - [Termos de uso](https://apiwpp.com/termos) - [Política de privacidade](https://apiwpp.com/privacidade) ## Recursos Todas em https://apiwpp.com/recursos. - [QR code e código de pareamento](https://apiwpp.com/recursos/conexao-qr-code-e-pareamento): Cada número entra na apiwpp como um aparelho conectado, igual ao WhatsApp Web: escaneie o QR code ou digite um código de 8 caracteres no celular e acompanhe o status pela API e pelo webhook connection.status. - [Sessão persistente](https://apiwpp.com/recursos/sessao-persistente): Depois do pareamento, a sessão do número fica salva e criptografada nos servidores da apiwpp. Reinícios, atualizações e quedas de rede não pedem um novo QR code, e o celular não precisa ficar ligado. - [Envio de mensagens](https://apiwpp.com/recursos/envio-de-mensagens): POST /connections/{id}/send coloca a mensagem na fila do número e responde 202 com jobId, scheduledAt e position. A API resolve o endereço do destinatário, mostra o "digitando…" e avisa o resultado pelo webhook message.delivery. - [Envio de mídia](https://apiwpp.com/recursos/envio-de-midia): Imagem, vídeo, áudio, documento e figurinha saem pela mesma rota de envio, a partir de uma URL https pública. Áudio pode ir como mensagem de voz, documento leva nome e legenda, e a mídia recebida chega no webhook. - [Templates com variáveis](https://apiwpp.com/recursos/templates-de-mensagem): Salve uma vez o texto de uma mensagem com variáveis como {{nome}} e {{pedido}} e envie pelo nome, preenchendo os valores em cada envio. Sem aprovação da Meta: o template vale assim que é criado. - [Verificação de números](https://apiwpp.com/recursos/verificacao-de-numeros): Consulte até 100 números por chamada e saiba quais estão no WhatsApp, com o endereço (JID) em que cada um está registrado. Útil no cadastro, na limpeza da base e antes de uma sequência de envios. - [Webhooks assinados](https://apiwpp.com/recursos/webhooks): Cada evento do número chega no seu servidor com um POST assinado com HMAC-SHA256. A entrega é feita pelo menos uma vez, com novas tentativas, registro de cada entrega e reenvio. - [Fila anti-bloqueio](https://apiwpp.com/recursos/fila-anti-bloqueio): Cada número conectado tem uma fila que envia no ritmo de uma pessoa: limites por minuto, hora e dia, intervalo aleatório entre envios e um teto de destinatários novos por dia. Mensagens ilimitadas dentro desses limites. - [Aquecimento de número](https://apiwpp.com/recursos/aquecimento-de-numero): Nos 14 dias depois de conectado, cada número segue limites menores de envio e de destinatários novos, que sobem em cinco etapas. A fila aplica tudo sozinha, e o estado do aquecimento aparece em GET /connections/{id}/queue. - [Proxy e IP dedicado](https://apiwpp.com/recursos/proxy-e-ip-dedicado): Cada número sai para o WhatsApp por um IP brasileiro de provedor de internet, compartilhado só com números do mesmo cliente. Você pode trocar pelo seu próprio proxy ou, no plano PRO, contratar um IP só para um número. - [Idempotência com clientRef](https://apiwpp.com/recursos/idempotencia-client-ref): O clientRef é o seu identificador de um envio. Repetir a requisição com o mesmo valor devolve o job original com duplicate: true, sem enfileirar outra mensagem, e o clientRef volta nos eventos de entrega e de falha. - [Reações, leitura e presença](https://apiwpp.com/recursos/reacoes-e-presenca): Reaja a mensagens com emoji e receba as reações dos clientes pelo evento message.reaction em qualquer plano. Todo texto enviado mostra "digitando…" antes. No PRO, marque mensagens como lidas e controle a presença do número. - [Editar e apagar mensagens](https://apiwpp.com/recursos/editar-e-apagar-mensagens): Errou o valor, o horário ou o link? Com o plano PRO, o seu sistema altera o texto de uma mensagem enviada pela API em até 15 minutos ou apaga a mensagem para todos, sempre pelo messageId. - [Projetos e chaves de API](https://apiwpp.com/recursos/projetos-e-chaves-de-api): Cada projeto é um sistema ou cliente seu, com os próprios números, webhook e chaves de API. As chaves têm escopo, validade e rotação com janela de sobreposição, e todos os projetos da conta entram numa fatura só. - [OpenAPI e clientes gerados](https://apiwpp.com/recursos/openapi-e-sdks): A API inteira está descrita numa especificação OpenAPI 3.1 pública, com referência interativa em português. Dela saem clientes TypeScript e PHP tipados, e você pode gerar os tipos no seu próprio projeto. ### Em breve (páginas sobre recursos ainda não disponíveis) - [Enquetes](https://apiwpp.com/recursos/enquetes): Enviar enquetes pela API e receber cada voto no seu webhook é um recurso em desenvolvimento, previsto para o plano PRO. Enquanto isso, respostas em texto e reações já confirmam agendamentos e coletam opiniões. - [Grupos](https://apiwpp.com/recursos/grupos): Hoje a API lista os grupos de que o número participa, entrega as mensagens de grupo no webhook e avisa quando o número entra, sai ou quando um grupo muda. Criar grupos e gerenciar participantes está em desenvolvimento para o PRO. - [Mensagens interativas](https://apiwpp.com/recursos/mensagens-interativas): Botões e listas pelo protocolo do WhatsApp Web não têm suporte estável, e a apiwpp ainda avalia se vai oferecê-los. Enquanto isso, menus numerados, templates e reações resolvem confirmações e atendimento nos planos LITE e PRO. ## Casos de uso Todas em https://apiwpp.com/casos-de-uso. - [Agências](https://apiwpp.com/casos-de-uso/agencias): Separe os números de cada cliente em projetos com chaves de API e webhook próprios, acompanhe tudo num painel só e pague uma fatura única, calculada por número conectado. - [SaaS e CRMs](https://apiwpp.com/casos-de-uso/saas-e-crms): Coloque o WhatsApp dentro do seu produto: cada cliente pareia o próprio número pela sua tela, as conversas chegam por webhook com o id do cliente e você paga por número conectado. - [E-commerce](https://apiwpp.com/casos-de-uso/e-commerce): Envie confirmação de pedido, boleto ou nota em PDF e código de rastreio no canal que o cliente lê, com templates, clientRef por pedido e status de entrega e leitura no webhook. - [Agendamentos](https://apiwpp.com/casos-de-uso/agendamentos): Lembretes de consulta, corte ou sessão enviados pelo seu sistema, com a resposta do cliente chegando por webhook para confirmar ou remarcar o horário direto na agenda. - [Cobrança e boletos](https://apiwpp.com/casos-de-uso/cobranca): Envie o aviso de vencimento, a segunda via do boleto e a confirmação de pagamento a quem já é seu cliente, a partir do seu sistema financeiro, sem risco de mandar a mesma cobrança duas vezes. - [Atendimento e suporte](https://apiwpp.com/casos-de-uso/atendimento-e-suporte): Cada mensagem que chega no número da empresa vira um evento no seu sistema: abra o ticket, distribua para a equipe e responda pela API, com texto, mídia, reações e o indicador de digitando. - [Notificações transacionais](https://apiwpp.com/casos-de-uso/notificacoes-transacionais): Mande pelo WhatsApp os avisos que o seu sistema já gera para quem é cliente (conta, serviço, pedido, alerta), com templates, envios sem duplicidade e a confirmação de entrega e leitura no seu webhook. ## Integrações Todas em https://apiwpp.com/integracoes. - [Node.js](https://apiwpp.com/integracoes/nodejs): Envie mensagens com o fetch nativo do Node.js, sem dependências, e receba os eventos num endpoint Express que verifica a assinatura HMAC-SHA256 de cada entrega. - [TypeScript](https://apiwpp.com/integracoes/typescript): Tipos gerados da especificação OpenAPI 3.1 com o openapi-typescript e chamadas pelo openapi-fetch: cada rota, corpo, resposta e evento de webhook tipado, sem código escrito à mão. - [PHP](https://apiwpp.com/integracoes/php): Envie mensagens com curl ou Guzzle, use o cliente PHP gerado da especificação OpenAPI 3.1 e receba os eventos num script que confere a assinatura HMAC-SHA256 com hash_hmac e hash_equals. - [Laravel](https://apiwpp.com/integracoes/laravel): Envie mensagens de WhatsApp a partir de Jobs do Laravel com o Http facade e clientRef, receba os eventos numa rota protegida por um middleware de assinatura HMAC e processe tudo na fila, sem duplicar. - [Python](https://apiwpp.com/integracoes/python): Envie mensagens com requests, trate 400 e 429 com Retry-After e receba os eventos num endpoint Flask ou FastAPI que verifica a assinatura HMAC-SHA256 com hmac.compare_digest. - [n8n](https://apiwpp.com/integracoes/n8n): Não há nó nativo da apiwpp no n8n: o envio usa o nó HTTP Request com uma credencial Header Auth, e os eventos chegam num nó Webhook, filtrados pelo campo type e com a assinatura conferida. - [Make (Integromat)](https://apiwpp.com/integracoes/make): Sem app nativo da apiwpp no Make: o envio usa o módulo HTTP "Make a request", os eventos chegam num Custom webhook, e o cenário de exemplo transforma cada nova linha da planilha numa mensagem. - [Zapier](https://apiwpp.com/integracoes/zapier): Sem app nativo da apiwpp no Zapier: a ação POST do Webhooks by Zapier envia a mensagem com o cabeçalho Authorization, o gatilho Catch Hook recebe os eventos, e a fila do número dita o ritmo. ## Comparativos Todas em https://apiwpp.com/comparativos. - [apiwpp ou API oficial](https://apiwpp.com/comparativos/apiwpp-vs-api-oficial-whatsapp): A Cloud API da Meta exige conta comercial e templates aprovados e cobra por mensagem; a apiwpp conecta o número como aparelho conectado, sem aprovação, e cobra por número. Cada uma vence em cenários diferentes. - [Alternativas à Z-API](https://apiwpp.com/comparativos/alternativas-z-api): Os critérios para comparar APIs de WhatsApp gerenciadas, como cobrança, fila anti-bloqueio, webhooks assinados, idempotência, proxy e documentação, com a posição da apiwpp em cada um e um roteiro de migração. - [Evolution API ou gerenciada](https://apiwpp.com/comparativos/evolution-api-self-hosted-vs-gerenciada): A Evolution API é um servidor open source que você hospeda e opera; a apiwpp é uma API gerenciada cobrada por número. Veja o custo total de cada modelo, o que a apiwpp opera por você e quando hospedar faz sentido. - [WPPConnect e Baileys](https://apiwpp.com/comparativos/wppconnect-e-baileys-self-hosted): Baileys e WPPConnect são projetos open source que falam o protocolo do WhatsApp Web. Montar uma API em produção sobre eles exige fila, webhooks confiáveis, separação por cliente, painel e cobrança. Veja o que falta construir e quando vale a pena. - [WhatsApp Business ou API](https://apiwpp.com/comparativos/whatsapp-business-app-vs-api): O app WhatsApp Business é feito para atender à mão, no celular. Uma API leva as mensagens para dentro do seu sistema, com envio automático e webhooks. Na apiwpp, o número continua no app e a API entra como um aparelho conectado. ## Glossário Todas em https://apiwpp.com/glossario. - [Aparelho conectado](https://apiwpp.com/glossario/aparelho-conectado): Aparelho conectado é um dispositivo extra ligado a uma conta de WhatsApp, como o WhatsApp Web, o aplicativo de desktop ou o servidor de uma API. Ele é pareado pelo celular uma vez e depois envia e recebe mensagens mesmo com o celular desligado. - [API não oficial](https://apiwpp.com/glossario/api-nao-oficial): API não oficial do WhatsApp é um serviço que conecta um número comum pelo protocolo do WhatsApp Web, como um aparelho conectado, e expõe envio e recebimento de mensagens por HTTP. Não passa pela Meta: não exige aprovação, mas o número pode ser restringido. - [Aquecimento de número](https://apiwpp.com/glossario/aquecimento-de-numero): Aquecimento de número (ou de chip) é o período depois de conectar um WhatsApp em que os limites de envio começam baixos e sobem aos poucos, para o número ganhar histórico antes de chegar ao volume normal. Na apiwpp, ele dura 14 dias e é aplicado pela fila. - [Baileys](https://apiwpp.com/glossario/baileys): Baileys é uma biblioteca open source em TypeScript que conecta um número ao WhatsApp pelo protocolo do WhatsApp Web, por WebSocket, sem abrir um navegador. É a base de várias APIs não oficiais, mas sozinha não traz API HTTP, fila nem webhooks. - [HMAC](https://apiwpp.com/glossario/hmac): HMAC é um código calculado a partir de uma mensagem e de um segredo compartilhado, com uma função de hash como SHA-256. Quem tem o segredo recalcula o código e confirma que a mensagem veio de quem diz e não foi alterada no caminho. - [Idempotência](https://apiwpp.com/glossario/idempotencia): Uma operação é idempotente quando repeti-la tem o mesmo efeito que fazê-la uma vez. Em APIs, isso se consegue com uma chave de idempotência: o cliente manda o mesmo identificador em cada tentativa e o servidor reconhece a repetição em vez de executar de novo. - [IP dedicado](https://apiwpp.com/glossario/ip-dedicado): IP dedicado é um endereço IP reservado para um único uso. No WhatsApp conectado por API, é o IP por onde só um número sai para a internet, sem dividir o endereço, e a reputação dele, com outros números. - [JID](https://apiwpp.com/glossario/jid): JID (Jabber ID) é o endereço interno que o WhatsApp usa para cada conversa: um contato é algo como 5511988887777@s.whatsapp.net, um grupo termina em @g.us e um contato identificado sem telefone termina em @lid. - [LID](https://apiwpp.com/glossario/lid): LID (linked identity) é um identificador do WhatsApp, como 11122233344455@lid, que representa um contato sem revelar o número de telefone. É estável para o contato, mas não tem relação com o telefone. - [Nono dígito](https://apiwpp.com/glossario/nono-digito): O nono dígito é o 9 que os celulares brasileiros ganharam na frente do número. Contas de WhatsApp antigas podem continuar registradas sem ele, e uma mensagem enviada ao endereço com o 9 não chega até elas. - [Proxy](https://apiwpp.com/glossario/proxy): Proxy é um servidor intermediário por onde uma conexão passa antes de chegar ao destino. Para o destino, a conexão parece vir do endereço IP do proxy. Num número de WhatsApp conectado por API, esse IP é um dos sinais que o WhatsApp observa. - [QR code de pareamento](https://apiwpp.com/glossario/qr-code-de-pareamento): QR code de pareamento é o código que o celular escaneia para ligar o número de WhatsApp a um aparelho conectado, como o WhatsApp Web ou uma API. Ele muda a cada poucos segundos e pode ser trocado por um código de 8 caracteres. - [Rate limit](https://apiwpp.com/glossario/rate-limit): Rate limit é o número máximo de requisições ou de ações que uma API aceita de um mesmo cliente num intervalo de tempo. Quando o teto é atingido, a API recusa as chamadas seguintes, em geral com o status 429 e o cabeçalho Retry-After. - [Template de mensagem](https://apiwpp.com/glossario/template-de-mensagem): Template de mensagem é um texto salvo com variáveis, como {{nome}} e {{pedido}}, que o sistema reutiliza em cada envio preenchendo os valores. Na Cloud API da Meta, o template precisa de aprovação; na apiwpp, é uma mensagem salva, sem aprovação. - [Webhook](https://apiwpp.com/glossario/webhook): Webhook é uma chamada HTTP que um serviço faz para um endereço do seu sistema quando um evento acontece, como uma mensagem recebida. Em vez de perguntar de tempos em tempos se há novidades, o seu sistema é avisado na hora. - [WhatsApp Cloud API](https://apiwpp.com/glossario/whatsapp-cloud-api): WhatsApp Cloud API é a API oficial do WhatsApp para empresas, hospedada pela Meta como parte da WhatsApp Business Platform. Exige conta comercial, usa modelos de mensagem aprovados para iniciar conversas e é cobrada pela Meta por mensagem. ## Blog Guias e tutoriais em https://apiwpp.com/blog (RSS: https://apiwpp.com/blog/feed.xml). - [API oficial ou não oficial do WhatsApp: qual escolher em 2026](https://apiwpp.com/blog/api-whatsapp-oficial-vs-nao-oficial): Custos, aprovação de templates, limites e o que cada modelo permite fazer: compare a Cloud API da Meta com uma API não oficial e escolha com segurança. - [Como evitar o bloqueio do número ao enviar mensagens pela API](https://apiwpp.com/blog/como-evitar-bloqueio-whatsapp-api): O que faz o WhatsApp restringir um número e as regras de envio que reduzem o risco: aquecimento, ritmo da fila e limite de contatos novos. - [Webhooks do WhatsApp: como receber e validar mensagens no seu sistema](https://apiwpp.com/blog/webhook-whatsapp): Configure o endereço do webhook, verifique a assinatura HMAC em Node.js e PHP e processe os eventos do WhatsApp sem duplicar nada. - [Enviar mensagem de WhatsApp com Node.js em 5 minutos](https://apiwpp.com/blog/enviar-mensagem-whatsapp-nodejs): Da chave de API ao primeiro envio pelo WhatsApp com Node.js: fetch nativo ou cliente TypeScript, resposta 202, clientRef contra duplicidade e erros 400 e 429. - [Integração do WhatsApp com PHP e Laravel](https://apiwpp.com/blog/whatsapp-php-laravel): Envie mensagens de WhatsApp pelo Laravel com o Http facade e Jobs, receba webhooks com assinatura HMAC e processe eventos em fila sem duplicar. - [Aquecimento de número: por que os primeiros 14 dias importam](https://apiwpp.com/blog/aquecimento-de-numero-whatsapp): Como o limite de envio do WhatsApp cresce nos 14 dias depois da conexão, o que recomeça o aquecimento e o que fazer com o número nesse período. - [Como agências gerenciam dezenas de números de WhatsApp](https://apiwpp.com/blog/agencias-varios-numeros-whatsapp): Projetos por cliente, chaves com escopo, webhooks separados e uma fatura só: como uma agência organiza dezenas de números de WhatsApp numa API. - [Como colocar o WhatsApp dentro do seu SaaS ou CRM](https://apiwpp.com/blog/whatsapp-dentro-do-seu-saas): Como integrar o WhatsApp no seu CRM ou SaaS: cada cliente conecta o próprio número pelo seu produto, as conversas chegam por webhook e o custo é por número. - [Notificações de pedido pelo WhatsApp para e-commerce](https://apiwpp.com/blog/notificacoes-de-pedido-whatsapp-ecommerce): Confirmação, pagamento, envio e rastreio pelo WhatsApp: templates com variáveis, id do pedido como clientRef, boleto em PDF e status de entrega no webhook. - [Lembretes de agendamento pelo WhatsApp com confirmação do cliente](https://apiwpp.com/blog/lembretes-de-agendamento-whatsapp): Envie lembretes de agendamento pelo WhatsApp na véspera e no dia, receba a confirmação do cliente por webhook e atualize a agenda sem ninguém digitar. - [Evolution API, Baileys e WPPConnect: hospedar a própria API ou usar uma gerenciada](https://apiwpp.com/blog/evolution-api-baileys-wppconnect-self-hosted): Evolution API, Baileys e WPPConnect são grátis, mas a operação não é. Veja o que hospedar a própria API do WhatsApp exige e quando uma gerenciada compensa. - [O nono dígito no WhatsApp: por que alguns números não recebem a mensagem](https://apiwpp.com/blog/nono-digito-whatsapp-api): Contas antigas do WhatsApp podem estar registradas sem o nono dígito. Veja por que o envio falha em silêncio e como a apiwpp descobre o endereço certo. - [Como evitar mensagens duplicadas no WhatsApp com idempotência](https://apiwpp.com/blog/mensagens-duplicadas-whatsapp-idempotencia): Por que a API manda a mesma mensagem duas vezes e como o clientRef, o evento message.send_failed e webhooks idempotentes acabam com a duplicidade. - [Como enviar PDF, imagem, áudio e vídeo pelo WhatsApp via API](https://apiwpp.com/blog/enviar-arquivo-pdf-imagem-whatsapp-api): Envie PDF, imagem, vídeo, áudio, mensagem de voz e figurinha pelo WhatsApp com a API: payload de cada tipo, mimetype, legenda e mídia recebida no webhook. - [Como conectar um número de WhatsApp à API por QR code ou código de pareamento](https://apiwpp.com/blog/conectar-whatsapp-qr-code-api): Passo a passo para parear um número de WhatsApp na API: buscar o QR code, usar o código de 8 caracteres, acompanhar o status e o que muda depois de conectar. - [WhatsApp no n8n: enviar e receber mensagens com HTTP Request e webhook](https://apiwpp.com/blog/whatsapp-n8n): Use a API de WhatsApp no n8n: envie mensagens com o nó HTTP Request, receba eventos no nó Webhook e valide a assinatura HMAC num nó Code. - [Enviar mensagem de WhatsApp com Python: requests, webhook e Flask](https://apiwpp.com/blog/enviar-mensagem-whatsapp-python): Envie mensagens de WhatsApp com Python e requests, trate 202, 400 e 429 com Retry-After e receba webhooks no Flask ou FastAPI com HMAC verificado. - [Disparo em massa no WhatsApp: por que números são bloqueados e o que fazer](https://apiwpp.com/blog/disparo-em-massa-whatsapp): Por que disparo em massa para listas frias derruba números no WhatsApp, o que usar no lugar e como enviar avisos recorrentes com opt-in, LGPD e opt-out. - [Quanto custa uma API de WhatsApp: os modelos de cobrança comparados](https://apiwpp.com/blog/api-whatsapp-preco): Por mensagem, por número ou self-hosted: veja como cada API de WhatsApp cobra, os custos escondidos de cada modelo e como calcular o seu gasto mensal. - [API de WhatsApp: o que é, como funciona e quando usar](https://apiwpp.com/blog/o-que-e-api-whatsapp): O que é uma API de WhatsApp, os dois caminhos (Cloud API oficial e WhatsApp Web), como enviar e receber mensagens por HTTP e quando vale a pena usar. ## Documentação para desenvolvedores Guias, a referência de cada operação da API e os eventos de webhook, em português, em https://apiwpp.com/docs. Índice para IA: https://apiwpp.com/docs/llms.txt · Texto completo: https://apiwpp.com/docs/llms-full.txt · Especificação OpenAPI: https://apiwpp.com/docs/openapi.json. ### Começando - [Documentação da apiwpp](https://apiwpp.com/docs/index.md): Guias e referência da API de WhatsApp da apiwpp: pareamento, envio de mensagens, webhooks assinados e cada operação HTTP, em português. - [Início rápido](https://apiwpp.com/docs/inicio-rapido.md): Da conta criada até a primeira mensagem enviada e o primeiro evento recebido no seu servidor, em cinco passos. - [Autenticação](https://apiwpp.com/docs/autenticacao.md): Como a chave de API é enviada, o que os escopos permitem, o que cada erro de autenticação quer dizer e como criar, rotacionar e revogar chaves. ### Guias - [Parear um número](https://apiwpp.com/docs/guias/parear-um-numero.md): Conecte um número de WhatsApp por QR code ou por código de pareamento, acompanhe o status da conexão e saiba o que fazer quando o WhatsApp pede uma passkey. - [Enviar mensagens](https://apiwpp.com/docs/guias/enviar-mensagens.md): Texto, mídia, localização e templates pela fila de cada número, com reações, verificação de contatos e os eventos que contam o que houve com cada envio. - [Webhooks e assinatura](https://apiwpp.com/docs/guias/webhooks-e-assinatura.md): Como receber os eventos, verificar a assinatura X-Sales-Signature, testar o endpoint, e como funcionam as novas tentativas e o reenvio de entregas. - [Idempotência](https://apiwpp.com/docs/guias/idempotencia.md): Repita um envio com segurança depois de um timeout usando o clientRef e ligue cada webhook da mensagem ao registro certo do seu sistema. - [Limites de envio](https://apiwpp.com/docs/guias/limites-de-envio.md): O limite de requisições da API, a cota do plano e o ritmo de envio que protege cada número do banimento, com os 429 de cada um. - [Erros](https://apiwpp.com/docs/guias/erros.md): O corpo de erro da API, o que cada status HTTP significa, qual limite gerou um 429 e como repetir uma requisição sem duplicar nada. - [LID e contact.resolved](https://apiwpp.com/docs/guias/lid-e-contact-resolved.md): Por que alguns remetentes chegam sem telefone, o que fazer com eles e como reatribuir os eventos quando o telefone aparece. - [Operações de mensagem](https://apiwpp.com/docs/guias/operacoes-de-mensagem.md): Edite e apague para todos as mensagens enviadas pela API, marque as recebidas como lidas e mostre digitando ou gravando. Recursos do plano PRO. - [Projetos e conexões](https://apiwpp.com/docs/guias/projetos-e-conexoes.md): Como organização, projeto e conexão se relacionam, o que você configura no projeto pela API e o ciclo de vida de um número: criar, desconectar, sair e excluir. - [Proxy e IP dedicado](https://apiwpp.com/docs/guias/proxy-e-ip-dedicado.md): Por onde cada número sai para o WhatsApp: o IP brasileiro compartilhado, um proxy seu por conexão ou um IP dedicado (PRO), e como verificar cada um. - [Uso e registros](https://apiwpp.com/docs/guias/uso-e-registros.md): Quanto os seus projetos enviaram frente ao plano, o registro de mensagens e de entregas de webhook, o reenvio de webhooks e por quanto tempo tudo fica guardado. ### Referência - [Visão geral da API](https://apiwpp.com/docs/api.md): A API HTTP da apiwpp: endereço base, autenticação por chave, formato dos erros e a lista de todas as operações e eventos de webhook. - [Escopos](https://apiwpp.com/docs/referencia/escopos.md): Os nove escopos que uma chave de API pode ter, o que cada um libera e todas as operações que exigem cada um deles. - [Códigos de erro](https://apiwpp.com/docs/referencia/codigos-de-erro.md): Cada identificador de erro da API, por status HTTP: onde aparece, o corpo que chega e o que fazer. Mais os motivos de falha que chegam pelos webhooks. - [Cabeçalhos](https://apiwpp.com/docs/referencia/cabecalhos.md): Os cabeçalhos HTTP da API: os que você envia (a chave e o Content-Type), os que as respostas trazem e os que chegam em cada entrega de webhook. - [Limites](https://apiwpp.com/docs/referencia/limites.md): Todos os números da apiwpp numa página: requisições, cota, ritmo de envio por número, pareamento, chaves, webhooks, mídia e registros. ### Conexões - [Criar conexão](https://apiwpp.com/docs/api/conexoes/criar-conexao.md): Criar uma conexão de WhatsApp - [QR code e status](https://apiwpp.com/docs/api/conexoes/qr-code-e-status.md): Obter o QR code e o status da conexão - [Código de pareamento](https://apiwpp.com/docs/api/conexoes/codigo-de-pareamento.md): Obter um código de pareamento para conectar um número sem o QR code - [Desconectar](https://apiwpp.com/docs/api/conexoes/desconectar.md): Desconectar uma conexão do WhatsApp - [Listar conexões](https://apiwpp.com/docs/api/conexoes/listar-conexoes.md): Listar conexões - [Sair do WhatsApp](https://apiwpp.com/docs/api/conexoes/sair-do-whatsapp.md): Sair do WhatsApp (logout) - [Listar grupos](https://apiwpp.com/docs/api/conexoes/listar-grupos.md): Listar grupos - [Consultar proxy](https://apiwpp.com/docs/api/conexoes/consultar-proxy.md): Obter o proxy de uma conexão - [Definir proxy](https://apiwpp.com/docs/api/conexoes/definir-proxy.md): Definir o proxy de uma conexão - [Remover proxy](https://apiwpp.com/docs/api/conexoes/remover-proxy.md): Remover o proxy de uma conexão - [IP dedicado](https://apiwpp.com/docs/api/conexoes/ip-dedicado.md): Obter o IP dedicado de uma conexão ### Mensagens - [Enviar mensagem](https://apiwpp.com/docs/api/mensagens/enviar-mensagem.md): Enfileirar uma mensagem para envio - [Fila do número](https://apiwpp.com/docs/api/mensagens/fila-do-numero.md): Consultar a fila de uma conexão - [Reagir](https://apiwpp.com/docs/api/mensagens/reagir.md): Reagir a uma mensagem - [Editar mensagem](https://apiwpp.com/docs/api/mensagens/editar-mensagem.md): Editar uma mensagem enviada - [Cancelar da fila](https://apiwpp.com/docs/api/mensagens/cancelar-mensagem-na-fila.md): Cancelar uma mensagem na fila - [Apagar mensagem](https://apiwpp.com/docs/api/mensagens/apagar-mensagem.md): Apagar uma mensagem enviada para todos - [Marcar como lidas](https://apiwpp.com/docs/api/mensagens/marcar-como-lidas.md): Marcar mensagens recebidas como lidas - [Mostrar presença](https://apiwpp.com/docs/api/mensagens/mostrar-presenca.md): Mostrar uma presença em uma conversa ### Projetos - [Atualizar projeto](https://apiwpp.com/docs/api/projetos/atualizar-projeto.md): Atualizar um projeto - [Listar projetos](https://apiwpp.com/docs/api/projetos/listar-projetos.md): Listar projetos - [Consultar projeto](https://apiwpp.com/docs/api/projetos/consultar-projeto.md): Consultar um projeto - [Desativar projeto](https://apiwpp.com/docs/api/projetos/desativar-projeto.md): Desativar um projeto - [Testar webhook](https://apiwpp.com/docs/api/projetos/testar-webhook.md): Testar um endpoint de webhook - [Conexões do projeto](https://apiwpp.com/docs/api/projetos/listar-conexoes-do-projeto.md): Listar as conexões de um projeto - [Criar conexão no projeto](https://apiwpp.com/docs/api/projetos/criar-conexao-no-projeto.md): Criar uma conexão no projeto - [Consultar conexão](https://apiwpp.com/docs/api/projetos/consultar-conexao.md): Consultar uma conexão - [Excluir conexão](https://apiwpp.com/docs/api/projetos/excluir-conexao.md): Excluir uma conexão - [Histórico de heartbeats](https://apiwpp.com/docs/api/projetos/historico-de-heartbeats.md): Histórico de heartbeats da conexão - [QR code como imagem](https://apiwpp.com/docs/api/projetos/qr-code-como-imagem.md): Obter o QR code como imagem - [Desconectar conexão](https://apiwpp.com/docs/api/projetos/desconectar-conexao-do-projeto.md): Desconectar uma conexão - [Reconectar conexão](https://apiwpp.com/docs/api/projetos/reconectar-conexao.md): Conectar de novo uma conexão ### Contatos - [Verificar números](https://apiwpp.com/docs/api/contatos/verificar-numeros.md): Verificar se números estão no WhatsApp - [Perfil do contato](https://apiwpp.com/docs/api/contatos/perfil-do-contato.md): Consultar o perfil de um contato ### Templates - [Criar template](https://apiwpp.com/docs/api/templates/criar-template.md): Criar um template de mensagem - [Listar templates](https://apiwpp.com/docs/api/templates/listar-templates.md): Listar os templates - [Consultar template](https://apiwpp.com/docs/api/templates/consultar-template.md): Consultar um template pelo nome - [Atualizar template](https://apiwpp.com/docs/api/templates/atualizar-template.md): Atualizar um template - [Excluir template](https://apiwpp.com/docs/api/templates/excluir-template.md): Excluir um template ### Chaves de API - [Listar chaves](https://apiwpp.com/docs/api/chaves-de-api/listar-chaves.md): Listar as chaves de API de um projeto - [Criar chave](https://apiwpp.com/docs/api/chaves-de-api/criar-chave.md): Criar uma chave de API - [Rotacionar chave](https://apiwpp.com/docs/api/chaves-de-api/rotacionar-chave.md): Rotacionar uma chave de API - [Revogar chave](https://apiwpp.com/docs/api/chaves-de-api/revogar-chave.md): Revogar uma chave de API ### Conta - [Quem está chamando](https://apiwpp.com/docs/api/conta/quem-esta-chamando.md): Quem está chamando ### Uso - [Uso do projeto](https://apiwpp.com/docs/api/uso/uso-do-projeto.md): Consultar o uso de um projeto - [Uso diário](https://apiwpp.com/docs/api/uso/uso-diario.md): Totais diários de mensagens dos projetos de quem chama (de todos, para a plataforma) ### Registros - [Listar mensagens](https://apiwpp.com/docs/api/registros/listar-mensagens.md): Listar as mensagens registradas - [Entregas de webhook](https://apiwpp.com/docs/api/registros/listar-entregas-de-webhook.md): Listar as entregas de webhook - [Reenviar entregas mortas](https://apiwpp.com/docs/api/registros/reenviar-entregas-mortas.md): Reenviar todas as entregas de webhook mortas - [Reenviar entrega](https://apiwpp.com/docs/api/registros/reenviar-entrega.md): Reenviar uma entrega de webhook ### Mídia - [Baixar mídia](https://apiwpp.com/docs/api/midia/baixar-midia.md): Baixar um arquivo de mídia ### Webhooks - [Webhooks: visão geral](https://apiwpp.com/docs/webhooks.md): O envelope comum a todos os eventos, os cabeçalhos de cada entrega, as regras de entrega e o catálogo dos 11 eventos que a apiwpp envia. - [connection.status](https://apiwpp.com/docs/webhooks/connection-status.md): A conexão abriu, fechou ou foi restringida - [message.incoming](https://apiwpp.com/docs/webhooks/message-incoming.md): Alguém escreveu para o número - [message.outgoing](https://apiwpp.com/docs/webhooks/message-outgoing.md): O número enviou uma mensagem (opcional: emitOutgoing) - [message.delivery](https://apiwpp.com/docs/webhooks/message-delivery.md): Uma mensagem enviada pelo número mudou de status - [message.send_failed](https://apiwpp.com/docs/webhooks/message-send-failed.md): Um envio na fila com clientRef não vai acontecer - [message.reaction](https://apiwpp.com/docs/webhooks/message-reaction.md): Alguém reagiu a uma mensagem - [contact.resolved](https://apiwpp.com/docs/webhooks/contact-resolved.md): Um remetente conhecido só pelo LID agora tem telefone - [group.joined](https://apiwpp.com/docs/webhooks/group-joined.md): O número entrou num grupo - [group.left](https://apiwpp.com/docs/webhooks/group-left.md): O número foi removido de um grupo - [group.updated](https://apiwpp.com/docs/webhooks/group-updated.md): Um grupo do número mudou - [ping](https://apiwpp.com/docs/webhooks/ping.md): O teste de um endpoint de webhook ### Clientes - [Cliente TypeScript](https://apiwpp.com/docs/clientes/typescript.md): Um cliente tipado da API, gerado da especificação OpenAPI com openapi-typescript e openapi-fetch: instalação, envio, erros e webhooks. - [Cliente PHP](https://apiwpp.com/docs/clientes/php.md): Um cliente PHP da API, gerado da especificação OpenAPI com o OpenAPI Generator sobre Guzzle: instalação, envio, erros e webhooks. ### Atualizações - [Novidades](https://apiwpp.com/docs/novidades.md): As mudanças da API que afetam quem a integra, da mais recente para a mais antiga, e a promessa de compatibilidade. ## Em breve (ainda não disponível) - Enquetes e votos de enquete, resposta citando uma mensagem, contatos (vCard) e vídeo redondo. - Administração de grupos (criar, editar, participantes, convites). Hoje: listar grupos e eventos de entrada e saída do próprio número. - Configurações do número: recusar chamadas, leitura automática, ignorar grupos, perfil e bloqueio. - Mensagens interativas (botões e listas): em avaliação, sem data. - Pacotes dos clientes TypeScript e PHP publicados em registros (hoje são gerados da especificação). ## O que a apiwpp não faz - Não é a API oficial do WhatsApp Business (Cloud API): sem selo verificado, sem aprovação da Meta, sem templates oficiais. O número é conectado pelo protocolo do WhatsApp Web, como aparelho conectado. - Não é ferramenta de disparo em massa: o ritmo de envio e o limite diário de destinatários novos existem para impedir isso. - Não garante que um número nunca será restringido pelo WhatsApp; reduz o risco. - Não sincroniza lista de conversas ou contatos, não envia webhooks de presença e não aceita upload de mídia no corpo da requisição (a mídia vai por URL). - A apiwpp não é afiliada, associada ou endossada pelo WhatsApp ou pela Meta. ## Perguntas frequentes ### A apiwpp é a API oficial do WhatsApp? Não. A apiwpp conecta o seu número pelo protocolo do WhatsApp Web, como um aparelho conectado. Você não precisa de aprovação da Meta nem de templates aprovados, e paga por número em vez de por mensagem. Se o seu caso exige o selo verificado ou envio em altíssimo volume, a API oficial (Cloud API) é a escolha certa. ### Meu número pode ser bloqueado? Qualquer número que envia spam pode ser restringido pelo WhatsApp. A apiwpp reduz esse risco com aquecimento de 14 dias, teto diário de novos destinatários e fila com ritmo de envio. Usar a API para conversar com quem já é seu cliente é o uso mais seguro. ### Preciso deixar o celular ligado? Não. O número funciona como um aparelho conectado: depois de escanear o QR code, a sessão fica salva nos nossos servidores e continua ativa com o celular desligado. ### Quantas mensagens posso enviar? Não há cobrança nem cota por mensagem. O limite é o ritmo que protege o número: poucas mensagens por hora nos primeiros dias, subindo durante o aquecimento. ### Como funciona o pagamento? Uma assinatura mensal por conta, com o valor de todos os números. Você paga por PIX, boleto ou cartão, pela Asaas. Adicionar números no meio do mês gera uma cobrança proporcional. ### Posso testar antes de pagar? Sim. Ao criar a conta você tem 7 dias com 1 número e os recursos do plano PRO (exceto o IP dedicado), sem cartão de crédito.