evolution-api/README.md
2024-06-09 14:18:19 -03:00

5.8 KiB

Evolution Api

Whatsapp Group Discord Community Postman Collection Documentation License Support Support

Evolution API - Whatsapp API Node JS

This project is based on the CodeChat. The original project is an implementation of Baileys, serving as a Restful API service that controls WhatsApp functions.
The code allows the creation of multiservice chats, service bots, or any other system that utilizes WhatsApp. The documentation provides instructions on how to set up and use the project, as well as additional information about its features and configuration options.

The Evolution API has direct integration with Typebot and Chatwoot

Evolution Pro Community

Join our Evolution Pro community for expert support and a weekly call to answer questions. Visit the link below to learn more and subscribe:

Click here to learn more
Subscribe

Instalation

Installing NVM (Node Version Manager)

NVM allows you to install and manage multiple versions of Node.js. This is particularly useful for maintaining compatibility across different projects.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

source ~/.bashrc

export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

Installing Node.js

nvm install v20.10.0 && nvm use v20.10.0

Initializing the Application

Clone the repository:

git clone https://github.com/EvolutionAPI/evolution-api.git

Configure the environment variables in the .env file.

Installing Application Dependencies

cd evolution-api

npm install

npm run build

Env

OBS: Rename the .env.example file to .env

cp .env.example .env

Database Setup

The application supports PostgreSQL, MySQL, MariaDB.

Run one of the commands below for the non-existence of a database.

  • MySQL or MariaDB:

    npm run db:migrate:mysql
    
  • PostgreSQL:

    npm run db:migrate:postgres
    

Deploying

For production environments.

For existing relational databases such as PostgreSQL, MySQL, or MariaDB, the setup involves two essential steps:

  1. Setting the Environment Variable: Initially, it's imperative to define the DATABASE_PROVIDER environment variable in alignment with your relational database type. Use postgresql for PostgreSQL, and mysql for MySQL or MariaDB. This configuration is crucial as it directs the Prisma ORM regarding the specific relational database in use.

  2. Deploying Schema Changes: Following this, execute the npm run db:migrate:postgres command. This command serves as a shortcut for the prisma deploy command, whose main role is to examine the current schema of the relational database and implement necessary modifications. A key feature of this command is its ability to update the database schema without affecting the existing data. This ensures that your current data remains intact while the database schema is updated to meet the latest requirements of the application.

Prisma Studio

  • View your data
    npm run db:studio:mysql
    # or
    npm run db:studio:postgres
    

This will sync your data models to your database, creating tables as needed.

Running the Application

  • Development Mode:

    npm run dev:server
    
  • Production Mode:

    npm run build
    npm run start:prod
    

Note

This code is in no way affiliated with WhatsApp. Use at your own discretion. Don't spam this.

This code was produced based on the baileys library and it is still under development.

Donate to the project.

PicPay

Buy me coffe - PIX

CHAVE PIX (Telefone): (74)99987-9409


Content Creator Partners

We are proud to collaborate with the following content creators who have contributed valuable insights and tutorials about Evolution API: