Ir para o conteúdo
Promovaweb
Portal independente da Promovaweb

UAZAPI O seu sistema envia e recebe mensagens no WhatsApp.

A UAZAPI é uma API HTTP não oficial que conecta um número de WhatsApp ao seu sistema. Quando um cliente manda mensagem, o n8n recebe o evento por webhook e responde pelo mesmo número, sem ninguém copiar a conversa do celular.

Serviço proprietário mantido pela uazapi, fora da plataforma oficial da Meta. Assuntos conferidos na versão 2.6.9.

Você acompanha a conexão do número e distingue uma mensagem aceita de uma mensagem recebida pelo destinatário.
  1. SessõesO estado da conexão do número consultado pela API.
  2. EnviosTexto e arquivos enviados por HTTP, sem celular na mão.
  3. WebhooksCada mensagem recebida chega ao seu sistema em JSON.
  4. n8n e ChatwootRespostas automáticas e atendimento ligados ao mesmo número.

Um número de WhatsApp conectado ao seu sistema por HTTP

Uma API HTTP não oficial que liga uma sessão pareada do WhatsApp aos seus sistemas de automação e atendimento.

Cada número conectado vira uma instância com token próprio

O servidor da UAZAPI hospeda instâncias. Cada instância é uma sessão do WhatsApp com token e configuração próprios, associada a um número por QR Code ou código de conexão. A partir daí, o seu sistema solicita o envio de uma mensagem por HTTP e recebe as mensagens que chegam ao número.

A comunicação percorre dois sentidos. Para enviar, o seu app chama o servidor da UAZAPI. Para receber, o servidor chama o endereço do seu app, o webhook, com um JSON por evento. A integração passa pela sessão mantida pela UAZAPI, fora do contrato da WhatsApp Business Platform da Meta, por isso o uso do número continua sujeito às condições do WhatsApp.

Nenhuma mensagem precisa passar pelo celular dos atendentes

  • Conversa copiada do celular para o sistema. Cada mensagem recebida chega ao seu sistema como evento em JSON, com o tipo e os identificadores da ocorrência.
  • A mesma resposta digitada à mão. O n8n recebe o evento, consulta o seu sistema e devolve a resposta pela API, pelo mesmo número.
  • Automação respondendo a si mesma. O filtro excludeMessages com o valor wasSentByApi tira da entrega as mensagens enviadas pela API. Assim a resposta automática não dispara outra.
  • O envio que falha sem aviso. A instância informa o estado da conexão, enquanto os eventos posteriores mostram o envio e a entrega, quando o recibo existe.

O webhook entrega ao n8n cada mensagem que chega ao número

Uma mensagem que chega ao número percorre as mesmas peças até o fluxo que trata o evento.

  1. WhatsAppA mensagem chega ao número conectado.
  2. InstânciaA sessão da UAZAPI recebe a mensagem.
  3. WebhookA API envia o evento em JSON ao endereço configurado.
  4. Seu sistemaO n8n processa o evento ou o Chatwoot recebe a conversa.
O envio faz o caminho contrário: o seu app chama a API com o token da instância. Conseguir chamar a API não comprova que o webhook chega ao seu receptor.
Veja como os eventos chegam ao seu sistema

Para automatizar conversas no WhatsApp, a UAZAPI encaixa bem

  • Automação que conversa pelo WhatsApp. Uma mensagem inicia um workflow no n8n, que consulta o seu sistema e responde com o resultado.
  • Atendimento humano no Chatwoot. A integração nativa, em beta na versão consultada, leva as mensagens novas do número para a caixa de entrada.
  • Avisos que saem do seu sistema. Um aviso de pedido ou de agenda sai por uma requisição HTTP, com o identificador para acompanhar a entrega.

Contrato oficial da Meta exige a plataforma da própria Meta

  • Projeto que exige o contrato oficial da Meta. Recursos e permissões da WhatsApp Business Platform não aparecem num serviço não oficial. A documentação e os planos do fornecedor não representam aprovação da Meta.
  • Histórico antigo levado ao Chatwoot. A integração sincroniza só as mensagens novas. O que ficou no aplicativo antes da conexão não entra na caixa de entrada.

As regras do WhatsApp continuam valendo para o número conectado

  • As condições do WhatsApp. O uso do número segue as regras do WhatsApp. A UAZAPI oferece o transporte, sem garantia da Meta para esse caminho.
  • O conteúdo das respostas. O que responder, quando encaminhar e onde gravar o histórico pertencem ao fluxo que você mantém no n8n.
  • A garantia de mensagem única. Uma chamada que termina em timeout pode ter sido processada. O campo track_id aceita valores repetidos e não elimina envios duplicados.
Licença
Serviço proprietário, sem o código do servidor sob licença aberta.
Versão de referência
2.6.9, a mesma usada nos assuntos deste portal.

Onde a UAZAPI economiza o seu tempo

Você acompanha a conexão do número e o recebimento de cada mensagem pelo seu sistema. Os retornos de envio permitem conferir se a resposta chegou ao destinatário.

Portais relacionados

Sistemas ligados a este nas stacks e nos projetos, cada um com o próprio portal.

Continue na comunidade

Leve ao Discord da Promovaweb a sessão que desconecta ou o webhook que não chega ao n8n. Com o evento recebido na conversa, a comunidade compara o seu caso com integrações parecidas.

Uma VPS para suas automações

O webhook da UAZAPI precisa de um endereço público para entregar cada evento. A VPS da StayCloud em São Paulo vem com acesso root e disco NVMe para o n8n e o Chatwoot receberem as mensagens.

Ver a VPS da StayCloud

Link de parceiro da Promovaweb.