A API não oficial de WhatsApp da UAZAPI
A UAZAPI oferece uma integração não oficial por uma sessão pareada do WhatsApp. O seu app envia mensagens por essa sessão e recebe eventos, sujeito à conexão e às condições do WhatsApp.
Ficha e sumário da página
- Referência técnica
- UAZAPI 2.6.9
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
A integração usa a sessão pareada
A documentação da UAZAPI descreve a instância como uma sessão do WhatsApp hospedada no servidor da API. O pareamento acontece por QR Code ou código de conexão. Depois dessa associação, você chama os endpoints da UAZAPI com o token da instância. O servidor recebe a solicitação e usa a sessão conectada para trabalhar com mensagens, chats e outros recursos descritos no contrato público.
Essa arquitetura determina o sentido de API não oficial usado neste portal: a integração documentada passa pela sessão mantida pela UAZAPI, fora do contrato da WhatsApp Business Platform da Meta. A existência de endpoints, documentação e planos comerciais do fornecedor não representa uma declaração de aprovação da Meta. As fontes da UAZAPI descrevem como a sessão funciona, enquanto as fontes do WhatsApp definem as condições de uso da plataforma.
A plataforma oficial tem outro contrato
A WhatsApp Business Platform é a plataforma da Meta para comunicação de empresas pelo WhatsApp. O seu app ou provedor integra esse contrato com os recursos e as permissões correspondentes. A UAZAPI apresenta seu próprio servidor, suas credenciais e seus endpoints. Você precisa conhecer os recursos do serviço que está integrando antes de prometer a um cliente uma característica da plataforma oficial que não aparece no serviço escolhido.
Seu app
Solicita uma mensagem por HTTP.
Servidor UAZAPI
Autentica o token da instância.
Sessão pareada
Mantém a conexão com o WhatsApp.
WhatsApp
Aplica suas condições ao uso do número.
A comparação exige mais que observar uma tela de conexão. Um QR Code, isoladamente, não prova todas as características comerciais ou técnicas de uma solução. O ponto verificável aqui é o contrato consultado: instância, sessão, token e chamadas ao servidor da UAZAPI. Você avalia a integração por essa documentação, sem deduzir certificações, parcerias ou garantias que o fornecedor não declara nas fontes usadas.
O número pode perder acesso ao serviço
O WhatsApp informa que práticas como spam e automação não autorizada podem resultar no banimento de um número. Sua orientação também abrange mensagens indesejadas e uso de listas sem consentimento. Esses avisos são gerais sobre o uso do WhatsApp e não constituem uma avaliação individual da UAZAPI. Eles impedem, porém, tratar uma sessão conectada como garantia de continuidade para qualquer volume ou finalidade de envio.
Para o seu atendimento, a consequência concreta é a possibilidade de interrupção do canal. O app pode continuar funcionando enquanto o número deixa de enviar ou receber mensagens pela integração. Você separa a disponibilidade da automação da disponibilidade da sessão e mantém visível o estado das conversas pendentes. Uma execução concluída no n8n não comprova que a resposta chegou à pessoa que aguarda atendimento.
Consentimento e finalidade acompanham a mensagem
Um telefone recebido numa conversa não autoriza qualquer uso posterior. Na integração, você mantém a finalidade do contato associada à mensagem que o sistema pretende enviar. Isso permite distinguir uma resposta de atendimento de uma campanha direcionada à mesma pessoa. A orientação pública do WhatsApp determina que mensagens indesejadas sejam interrompidas quando o contato solicita que a empresa pare de enviá-las.
O fluxo também precisa evitar que uma falha técnica aumente a quantidade de mensagens. Eventos repetidos, respostas aos próprios envios e repetição de chamadas após timeout podem produzir contatos duplicados sem que você tenha iniciado uma nova campanha. O tratamento desses casos faz parte da integração. Ele reduz erros do seu sistema, mas não altera as condições da plataforma nem oferece uma promessa de imunidade a restrições do WhatsApp.
A credencial permite agir pela sessão
O token da instância autoriza ações sobre o número conectado. Um terceiro com esse valor pode agir pela sessão autorizada. Por isso, você separa o acesso ao painel da posse da credencial. Num sistema com várias empresas, o backend confere a autorização antes de recuperar o token e chamar a API. O identificador selecionado na interface não deve permitir acesso a uma sessão que pertence a outra empresa.
O admintoken tem alcance administrativo sobre o servidor.
Ele não precisa acompanhar cada automação que envia uma resposta.
A documentação da UAZAPI recomenda proteger credenciais, retirar
segredos dos logs e rotacionar tokens expostos. Essas medidas
preservam o acesso técnico à sessão. Elas não substituem a
avaliação da finalidade das mensagens ou a definição de quais
atendentes podem consultar o conteúdo das conversas no seu sistema.
O serviço proprietário tem condições próprias
A uazapi mantém a API como serviço proprietário. As fontes consultadas não apresentam licença aberta do servidor. A versão de referência 2.6.9 descreve o comportamento disponível na data de consulta, sem garantir disponibilidade futura, preços ou compatibilidade. Uma integração que depende de um campo ou estado específico precisa conferir esse contrato quando o fornecedor altera a versão usada pelo seu ambiente.
O acompanhamento da conexão pelo seu app está em instâncias e sessões. A diferença entre aceite, envio e entrega está em mensagens e mídias. Essas distinções ajudam você a apresentar o estado real do atendimento e a avaliar o serviço sem prometer estabilidade, aprovação da Meta ou continuidade do número que as fontes oficiais não garantem.