Ir para o conteúdo
Promovaweb

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
  1. A integração usa a sessão pareada
  2. A plataforma oficial tem outro contrato
  3. O número pode perder acesso ao serviço
  4. Consentimento e finalidade acompanham a mensagem
  5. A credencial permite agir pela sessão
  6. O serviço proprietário tem condições próprias

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.

  1. Seu app

    Solicita uma mensagem por HTTP.

  2. Servidor UAZAPI

    Autentica o token da instância.

  3. Sessão pareada

    Mantém a conexão com o WhatsApp.

  4. WhatsApp

    Aplica suas condições ao uso do número.

O envio descrito pela UAZAPI usa a sessão pareada e continua sujeito às condições do WhatsApp.

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.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.