O banco de dados é uma parte fundamental da Evolution API v2, responsável por armazenar todas as informações críticas da aplicação. A API suporta tanto PostgreSQL quanto MySQL, utilizando o Prisma como ORM (Object-Relational Mapping) para facilitar a interação com esses bancos de dados.

​
Escolha do Banco de Dados

A Evolution API v2 permite a flexibilidade de escolher entre PostgreSQL e MySQL como provedor de banco de dados. A escolha pode ser configurada através da variável de ambiente DATABASE_PROVIDER e as conexões são gerenciadas pelo Prisma.

​
Instalação e Configuração

​
Utilizando Docker

A maneira mais fácil e rápida de configurar um banco de dados para a Evolution API v2 é através do Docker. Abaixo estão as instruções para configurar tanto o PostgreSQL quanto o MySQL usando Docker Compose.

​
PostgreSQL

Para configurar o PostgreSQL via Docker, siga os passos abaixo:
  1. Baixe o arquivo docker-compose.yaml para o PostgreSQL disponível aqui.
  2. Navegue até o diretório onde o arquivo foi baixado e execute o comando:
docker-compose up -d
  1. A instância do PostgreSQL estará disponível no endereço localhost na porta 5432.

​
MySQL

Para configurar o MySQL via Docker, siga os passos abaixo:
  1. Baixe o arquivo docker-compose.yaml para o MySQL disponível aqui.
  2. Navegue até o diretório onde o arquivo foi baixado e execute o comando:
docker-compose up -d
  1. A instância do MySQL estará disponível no endereço localhost na porta 3306.

​
Configuração das Variáveis de Ambiente

Após configurar o banco de dados, defina as seguintes variáveis de ambiente no seu arquivo .env: 
# Habilitar o uso do banco de dados
DATABASE_ENABLED=true

# Escolher o provedor do banco de dados: postgresql ou mysql
DATABASE_PROVIDER=postgresql

# URI de conexão com o banco de dados
DATABASE_CONNECTION_URI='postgresql://user:pass@localhost:5432/evolution?schema=public'

# Nome do cliente para a conexão do banco de dados
DATABASE_CONNECTION_CLIENT_NAME=evolution_exchange

# Escolha os dados que você deseja salvar no banco de dados da aplicação
DATABASE_SAVE_DATA_INSTANCE=true
DATABASE_SAVE_DATA_NEW_MESSAGE=true
DATABASE_SAVE_MESSAGE_UPDATE=true
DATABASE_SAVE_DATA_CONTACTS=true
DATABASE_SAVE_DATA_CHATS=true
DATABASE_SAVE_DATA_LABELS=true
DATABASE_SAVE_DATA_HISTORIC=true

​
Instalação Local

Caso prefira configurar o banco de dados localmente sem utilizar Docker, siga as instruções abaixo:

​
PostgreSQL

  1. Instale o PostgreSQL na sua máquina. Em sistemas baseados em Ubuntu, por exemplo, você pode usar:
sudo apt-get update
sudo apt-get install postgresql postgresql-contrib
  1. Inicie o serviço do PostgreSQL:
sudo service postgresql start
  1. Crie um banco de dados para a Evolution API v2:
sudo -u postgres createdb evolution

​
MySQL

  1. Instale o MySQL na sua máquina. Em sistemas baseados em Ubuntu, você pode usar:
sudo apt-get update
sudo apt-get install mysql-server
  1. Inicie o serviço do MySQL:
sudo service mysql start
  1. Crie um banco de dados para a Evolution API v2:
mysql -u root -p -e "CREATE DATABASE evolution;"