Angola
Brasil
Kenya
Moçambique
Nigeria
Portugal
South Africa
United Kingdom
United States
International
A Evolution API tem muitas configurações, mas só um punhado decide se o serviço é seguro, se guarda as sessões e se aceita conexões. Este artigo diz quais são e por quê. Os nomes exatos e os valores permitidos mudam de versão para versão, por isso confirme-os sempre no arquivo de exemplo e na documentação oficial do projeto, e não os copie de um guia antigo.
As que não pode deixar por decidir
| Configuração | Porque importa |
A chave da API (AUTHENTICATION_API_KEY) |
Protege todos os pedidos. Quem a tiver manda mensagens a partir do seu número. Gere-a aleatória e guarde-a num gerenciador de senhas. |
| O banco de dados (PostgreSQL ou MySQL) | Onde ficam as instâncias e as mensagens. Escolhe-se o fornecedor e dá-se o endereço, o usuário e a senha da conexão. Têm de coincidir com os do serviço do banco de dados no compose. |
| O Redis | Muitos guias usam-no. Se o arquivo de exemplo o inclui, o serviço precisa de lhe chegar; se o dispensa, desligue-o no mesmo lugar e não o deixe a meio. |
| A integração e as suas credenciais | Baileys (QR) ou Cloud API. Com a Cloud API entram também o token e o resto dos dados do seu app Meta, que são segredos como a chave. |
| A versão da imagem | Escolha uma versão concreta em vez de seguir sempre a mais recente. Assim sabe o que está rodando e pode voltar atrás. |
| Os volumes (no compose) | Não são uma configuração mas decidem tudo: sem volume persistente para as instâncias e para o banco de dados, um reinício apaga as sessões. |
Como lidar com o arquivo de configurações
|
|
|
|
| O arquivo de configurações tem segredos. Nunca o ponha num repositório público, numa captura de tela ou numa mensagem de suporte. Se a chave da API vazar, troque-a no arquivo, reinicie e atualize tudo o que a usa (o n8n, o seu site, os scripts). |
Erros típicos
| Erro | Consequência |
| Deixar a chave de exemplo | Qualquer pessoa que leia a documentação pública conhece-a. |
| Senha do banco de dados igual à chave da API | Um vazamento abre as duas portas. |
| Sem volume persistente | As sessões desaparecem no primeiro reinício. |
| Seguir sempre a imagem mais recente | Uma atualização automática pode trazer uma versão do Baileys que não liga. Fixe a versão e atualize quando decidir. |
| Para uma lista do que mexer depois de o serviço estar de pé, veja proteger a Evolution API e a Evolution API com PostgreSQL e Redis. Se precisar de variáveis de ambiente para a sua própria aplicação, veja variáveis de ambiente e segredos. |
|
Montou a Evolution API num VPS e quer mais folga para ela? Veja os planos. Ver servidores VPS |
|
VEJA TAMBÉM |
PRODUTO RECOMENDADO Servidor VPS com acesso root Recursos só seus, o sistema que escolher, reinstalação quando quiser. desde R$ 46,20/mês (plano de 3 anos, com cupom) Ver planos |
