A Evolution API é um programa de código aberto que põe uma interface web (uma API REST) à frente de um número de WhatsApp. Instala-se num servidor seu, e a partir daí as suas aplicações enviam e recebem mensagens por pedidos HTTP, sem passarem pelo telemóvel. Não é um produto da Interweb nem de nenhuma empresa que lhe venda a licença: é um projecto de terceiros que corre num VPS com acesso root.
A pergunta que quase todos fazem a seguir é «posso usar isto em vez da API oficial da Meta?». Pode, mas com os olhos abertos: a Evolution API suporta duas formas de ligar, e só uma delas é oficial.
As duas integrações
|
Baileys (código QR) |
Cloud API oficial da Meta |
| Como liga |
Imita o WhatsApp Web. Lê um código QR com o telemóvel, como quando liga um computador. |
Fala com a plataforma oficial da Meta, através de uma app da sua conta de programador. |
| É oficial? |
Não. A biblioteca não é da Meta e a Meta não a reconhece. |
Sim. É o caminho que a Meta prevê para empresas. |
| Risco |
O número pode ser limitado ou bloqueado. Não há recurso garantido. |
Segue as regras e os limites da Meta, o que é mais previsível. |
| Mensagens de iniciativa sua |
Não há modelos aprovados: manda o que quiser, e o risco é seu. |
Fora da janela de 24 horas só com modelos aprovados pela Meta. |
| Custo de arranque |
Sem conta de programador e sem aprovação de modelos. |
Exige conta de programador, número e configuração. Os valores são os da Meta. |
Quando faz sentido usar a Evolution API
| 1 |
Quer um só ponto de entrada. Uma API simples que o n8n, um site ou um sistema seu chamam, seja qual for a integração por baixo.
|
|
| 2 |
Quer experimentar antes de decidir. Ligar um número de teste por QR é rápido, e serve para perceber o que a sua automação precisa de facto.
|
|
| 3 |
Quer a Cloud API oficial mas com uma camada por cima. A Evolution API também sabe falar com ela, e fica com as mensagens num único sítio.
|
|
| 4 |
Tem um servidor e sabe geri-lo. Precisa de Docker, de uma base de dados e de manter tudo actualizado. Se isso não lhe interessa, a API oficial paga-se com menos trabalho técnico.
|
|
|
O Baileys não é oficial. Se o número é o da sua empresa, o que os clientes conhecem, não o ligue por QR a um serviço automático sem aceitar que o pode perder. A Meta tem regras sobre automação e mensagens não pedidas, e aplica-as. Para o contexto geral, veja os riscos do WhatsApp para empresas.
|
O que precisa para a pôr a funcionar
Segundo a documentação do projecto, a Evolution API corre em Docker e Docker Compose, com uma base de dados PostgreSQL ou MySQL. Muitos guias juntam um Redis. É preciso um volume persistente para as instâncias, senão as sessões perdem-se no primeiro reinício. Não serve para hospedagem partilhada, porque aí não há Docker nem root. Para o passo a passo, veja instalar a Evolution API com Docker Compose.
|
Antes de escolher o servidor, leia VPS gerido ou não gerido. Num VPS não gerido a instalação e a manutenção da Evolution API são suas, e o suporte da Interweb não instala nem repara software de terceiros. A fronteira está em Política de Suporte.
|
|
Precisa de um servidor com acesso root para a Evolution API? Veja os VPS.
Ver servidores VPS
|
PRODUTO RECOMENDADO Alojamento de sites com cPanel Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 5.940,00 Kz/mês (plano de 3 anos, com cupão) Ver planos |
Português
English
