Ir para o conteúdo
Promovaweb

O que é a UAZAPI e para que serve

Copiar conversas do celular para o sistema não acompanha o volume de um atendimento ou de uma automação. A UAZAPI é uma API HTTP não oficial que liga uma sessão pareada do WhatsApp aos seus sistemas: o envio sai por requisição e cada mensagem recebida chega ao seu app por webhook.

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 sessão que liga o número ao seu app
  2. Uma chamada sai e um evento volta
  3. O endereço do servidor e a credencial
  4. O lugar do n8n e do Chatwoot
  5. O retorno de envio tem um significado específico
  6. A continuidade depende da sessão e do destino

A sessão que liga o número ao seu app

O servidor da UAZAPI hospeda instâncias. Cada instância representa uma sessão do WhatsApp, com credencial e configuração próprias. Você associa essa sessão a um número por pareamento. A partir dessa conexão, o seu sistema consegue solicitar o envio de uma mensagem e receber notificações sobre mensagens que chegam ao número. A instância continua sendo um recurso separado do fluxo que você constrói no n8n ou da caixa de entrada usada no Chatwoot.

A uazapi mantém o serviço proprietário e a documentação da API. O contrato público descreve os recursos disponíveis, mas não oferece o código do servidor sob uma licença aberta. A referência deste conteúdo é a versão 2.6.9, consultada em 13 de novembro de 2026. O portal da Promovaweb é independente do fornecedor e explica a integração não oficial com o WhatsApp, sem atribuir à Meta suporte ou aprovação para esse caminho.

Uma chamada sai e um evento volta

A comunicação percorre dois sentidos. Para enviar um texto, o seu app faz uma requisição HTTP ao endereço do servidor da UAZAPI. Para receber uma mensagem nova, o servidor da API faz uma requisição ao endereço do seu app. Esse segundo endereço é o webhook. Essa diferença permite localizar uma falha: conseguir consultar a API não comprova que ela também consegue chegar ao receptor dos seus eventos.

  1. WhatsApp

    Uma mensagem chega ao número conectado.

  2. Instância

    A sessão da UAZAPI recebe a mensagem.

  3. Webhook

    A API envia o evento em JSON.

  4. Seu sistema

    O n8n processa ou o atendimento recebe a conversa.

Caminho de uma mensagem recebida pela sessão e entregue ao sistema integrado.

O evento transporta identificadores e o conteúdo previsto para aquele tipo de ocorrência. Uma mudança de conexão tem campos diferentes de uma mensagem recebida. Você usa o tipo do evento para escolher o tratamento correspondente. O fluxo que responde a uma mensagem precisa distinguir a fala recebida da resposta enviada pelo próprio sistema, pois ambas podem produzir eventos. Sem essa distinção, uma resposta automática pode provocar outra resposta.

O endereço do servidor e a credencial

A Server URL indica o servidor que hospeda a instância. O site da documentação serve para consultar o contrato e não substitui esse endereço. O token da instância acompanha as chamadas autorizadas para aquela sessão. Ao combinar o endereço de um servidor com uma credencial de outro, a requisição não encontra a sessão correta apenas por informar o número de telefone. Endereço e credencial precisam corresponder ao mesmo ambiente contratado.

Existe também uma credencial administrativa, chamada admintoken. Ela tem alcance sobre o servidor e permite administrar instâncias. Esse alcance é maior que o necessário para enviar uma mensagem por uma sessão específica. Num app que atende várias empresas, você mantém a associação entre cada cliente e suas instâncias no backend. O identificador recebido do navegador não basta para autorizar acesso à conversa de outra empresa.

O lugar do n8n e do Chatwoot

O n8n executa o processamento que você define para cada evento. Uma mensagem pode iniciar uma consulta no seu sistema e produzir uma resposta com o resultado. O Node Webhook recebe o evento e o HTTP Request faz chamadas à API. A UAZAPI oferece o transporte entre a sessão e a automação. O conteúdo da resposta, as condições de encaminhamento e a gravação do histórico pertencem ao fluxo que você mantém.

O Chatwoot reúne o atendimento em conversas que os atendentes acompanham. A UAZAPI descreve uma integração nativa com esse sistema no endpoint /chatwoot/config. Na versão consultada, ela está em beta e sincroniza mensagens novas. O histórico anterior não é importado por essa integração. Essa limitação importa quando você conecta um número que já tem conversas em andamento: a caixa de entrada não recebe automaticamente tudo que ficou no aplicativo antes da conexão.

O retorno de envio tem um significado específico

Uma chamada aceita pela API ainda não comprova que o destinatário recebeu a mensagem. O processamento pode passar por fila, envio e confirmação de entrega. Você acompanha esses estados pelos identificadores retornados e pelos eventos posteriores. A confirmação de leitura também pode faltar por características da conversa ou configurações de privacidade. Tratar qualquer resposta HTTP bem-sucedida como leitura cria um histórico que afirma mais do que o transporte confirmou.

O mesmo cuidado vale quando a requisição demora e termina em timeout. O servidor pode ter processado o envio antes de a conexão cair. Se o seu fluxo repete a chamada imediatamente, duas mensagens podem chegar ao destinatário. A documentação orienta consultar o estado existente antes de repetir uma alteração. O campo track_id relaciona a mensagem ao seu sistema, mas aceita valores repetidos e não elimina envios duplicados.

A continuidade depende da sessão e do destino

Você acompanha tanto a conexão com o WhatsApp quanto o recebimento dos webhooks. Uma sessão desconectada interrompe o caminho das mensagens, enquanto um receptor indisponível impede que o seu fluxo conheça eventos enviados pela API. O monitoramento precisa distinguir essas situações para que uma conversa não pareça resolvida apenas porque a automação terminou sem erro.

Os estados da sessão estão em instâncias e sessões. O retorno dos eventos ao seu sistema está em webhooks e eventos. Para avaliar a continuidade do número, a comparação com a API oficial apresenta os limites desse tipo de conexão e os cuidados indicados pelo próprio WhatsApp.

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.