mirror of
https://github.com/EvolutionAPI/evolution-api.git
synced 2025-07-14 01:41:24 -06:00
285 lines
9.0 KiB
Markdown
285 lines
9.0 KiB
Markdown
<h1 align="center">Evolution Api</h1>
|
||
|
||
<div align="center">
|
||
|
||
<!-- [](#)-->
|
||
<!-- [](#) -->
|
||
[](./LICENSE)
|
||
[](https://app.picpay.com/user/davidsongomes1998)
|
||
|
||
</div>
|
||
|
||
<div align="center"><img src="./public/images/cover.png"></div>
|
||
|
||
## WhatsApp-Api-NodeJs
|
||
|
||
This project is based on the [CodeChat](https://github.com/code-chat-br/whatsapp-api). The original project is an implementation of [Baileys](https://github.com/adiwajshing/Baileys), serving as a Restful API service that controls WhatsApp functions.</br>
|
||
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.
|
||
|
||
## Infrastructure
|
||
|
||
### Nvm installation
|
||
|
||
```sh
|
||
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
|
||
# or
|
||
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
|
||
```
|
||
>
|
||
> After finishing, restart the terminal to load the new information.
|
||
>
|
||
|
||
### Docker installation \[optional\]
|
||
|
||
```sh
|
||
curl -fsSL https://get.docker.com -o get-docker.sh
|
||
|
||
sudo sh get-docker.sh
|
||
|
||
sudo usermod -aG docker ${USER}
|
||
```
|
||
### Nodejs installation
|
||
|
||
```sh
|
||
nvm install 16.18.1
|
||
```
|
||
|
||
### pm2 installation
|
||
```sh
|
||
npm i -g pm2
|
||
```
|
||
|
||
```sh
|
||
docker --version
|
||
|
||
node --version
|
||
```
|
||
## MongoDb [optional]
|
||
|
||
After installing docker and docker-compose, up the container.
|
||
- [compose from mongodb](./mongodb/docker-compose.yaml)
|
||
|
||
In the same directory where the file is located, run the following command:
|
||
```sh
|
||
bash docker.sh
|
||
```
|
||
Using the database is optional.
|
||
|
||
## Application startup
|
||
|
||
Cloning the Repository
|
||
```
|
||
git clone https://github.com/EvolutionAPI/evolution-api.git
|
||
```
|
||
|
||
Go to the project directory and install all dependencies.</br>
|
||
```sh
|
||
cd whatsapp-api
|
||
|
||
npm i
|
||
```
|
||
|
||
Finally, run the command below to start the application:
|
||
```sh
|
||
# Under development
|
||
npm run start
|
||
|
||
# In production
|
||
npm run start:prod
|
||
|
||
# pm2
|
||
pm2 start 'npm run start:prod' --name ApiEvolution
|
||
```
|
||
## Authentication
|
||
|
||
You can define two authentication **types** for the routes in the **[env file](./src/dev-env.yml)**.
|
||
Authentications must be inserted in the request header.
|
||
|
||
1. **apikey**
|
||
|
||
2. **jwt:** A JWT is a standard for authentication and information exchange defined with a signature.
|
||
|
||
> Authentications are generated at instance creation time.
|
||
|
||
**Note:** There is also the possibility to define a global api key, which can access and control all instances.
|
||
|
||
### Connection
|
||
|
||
#### Create an instance
|
||
|
||
##### HTTP
|
||
|
||
> *NOTE:* This key must be inserted in the request header to create an instance.
|
||
|
||
```http
|
||
POST /instance/create HTTP/1.1
|
||
Host: localhost:8080
|
||
Content-Type: application/json
|
||
apikey: t8OOEeISKzpmc3jjcMqBWYSaJH2PIxns
|
||
|
||
```
|
||
##### cURL
|
||
|
||
```bash
|
||
curl --location --request POST 'http://localhost:8080/instance/create' \
|
||
--header 'Content-Type: application/json' \
|
||
--header 'apikey: t8OOEeISKzpmc3jjcMqBWYSaJH2PIxns' \
|
||
--data-raw '{
|
||
"instanceName": "evolution"
|
||
}'
|
||
```
|
||
### Response
|
||
|
||
```ts
|
||
{
|
||
"instance": {
|
||
"instanceName": "evolution",
|
||
"status": "created"
|
||
},
|
||
"hash": {
|
||
"jwt": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9. [...]"
|
||
|
||
// or
|
||
// "apikey": "88513847-1B0E-4188-8D76-4A2750C9B6C3"
|
||
}
|
||
}
|
||
```
|
||
#### Connection with qrcode
|
||
|
||
##### HTTP
|
||
|
||
```http
|
||
GET /instance/connect/evolution HTTP/1.1
|
||
Host: localhost:8080
|
||
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9. [...]
|
||
```
|
||
```http
|
||
GET /instance/connect/evolution HTTP/1.1
|
||
Host: localhost:8080
|
||
apikey: 88513847-1B0E-4188-8D76-4A2750C9B6C3
|
||
```
|
||
##### cURL
|
||
|
||
```bash
|
||
curl --location --request GET 'http://localhost:8080/instance/connect/evolution' \
|
||
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9. [...]'
|
||
```
|
||
```bash
|
||
curl --location --request GET 'http://localhost:8080/instance/connect/evolution' \
|
||
--header 'apikey: 88513847-1B0E-4188-8D76-4A2750C9B6C3'
|
||
```
|
||
|
||
### Response
|
||
|
||
```ts
|
||
{
|
||
"code": "2@nXSUgRJSBY6T0XJmiFKZ0 [...] ,XsgJhJHYa+0MPpXANdPHHt6Ke/I7O2QyXT/Lsge0uSg=",
|
||
"base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhE [...] LkMtqAAAAABJRU5ErkJggg=="
|
||
}
|
||
```
|
||
|
||
### App in Docker
|
||
- [docker run](./docker.sh)
|
||
- [docker-compose](./docker-compose.yml)
|
||
- [env for docker](./Docker/.env)
|
||
- [DockerHub Evolution API](https://hub.docker.com/repository/docker/davidsongomes/evolution-api)
|
||
|
||
After building the application, in the same directory as the files above, run the following command:
|
||
```sh
|
||
docker-compose up
|
||
```
|
||
## Send Messages
|
||
| | |
|
||
|-----|---|
|
||
| Send Text | ✔ |
|
||
| Send Template | ❌ |
|
||
| Send Media: audio - video - image - document - gif <br></br>base64: ```true``` | ✔ |
|
||
| Send Media File | ❌ |
|
||
| Send Audio type WhatsApp | ✔ |
|
||
| Send Location | ✔ |
|
||
| Send Link Preview | ✔ |
|
||
| Send Contact | ✔ |
|
||
| Send Reaction - emoji | ✔ |
|
||
| Send Poll Message | ✔ |
|
||
| Send Buttons (Deprecated) | ❌ |
|
||
| Send List (Deprecated) | ❌ |
|
||
|
||
## Postman collections
|
||
- [Postman Json](./postman.json)
|
||
|
||
## Webhook Events
|
||
|
||
| Name | Event | TypeData | Description |
|
||
|------|-------|-----------|------------|
|
||
| APPLICATION_STARTUP | application.startup | json | Notifies you when a application startup |
|
||
| QRCODE_UPDATED | qrcode.updated | json | Sends the base64 of the qrcode for reading |
|
||
| CONNECTION_UPDATE | connection.update | json | Informs the status of the connection with whatsapp |
|
||
| MESSAGES_SET | message.set | json | Sends a list of all your messages uploaded on whatsapp</br>This event occurs only once |
|
||
| MESSAGES_UPSERT | message.upsert | json | Notifies you when a message is received |
|
||
| MESSAGES_UPDATE | message.update | json | Tells you when a message is updated |
|
||
| SEND_MESSAGE | send.message | json | Notifies when a message is sent |
|
||
| CONTACTS_SET | contacts.set | json | Performs initial loading of all contacts</br>This event occurs only once |
|
||
| CONTACTS_UPSERT | contacts.upsert | json | Reloads all contacts with additional information</br>This event occurs only once |
|
||
| CONTACTS_UPDATE | contacts.update | json | Informs you when the chat is updated |
|
||
| PRESENCE_UPDATE | presence.update | json | Informs if the user is online, if he is performing some action like writing or recording and his last seen</br>'unavailable' | 'available' | 'composing' | 'recording' | 'paused' |
|
||
| CHATS_SET | chats.set | json | Send a list of all loaded chats |
|
||
| CHATS_UPDATE | chats.update | json | Informs you when the chat is updated |
|
||
| CHATS_UPSERT | chats.upsert | json | Sends any new chat information |
|
||
| GROUPS_UPSERT | groups.upsert | JSON | Notifies when a group is created |
|
||
| GROUPS_UPDATE | groups.update | JSON | Notifies when a group has its information updated |
|
||
| GROUP_PARTICIPANTS_UPDATE | group-participants.update | JSON | Notifies when an action occurs involving a participant</br>'add' | 'remove' | 'promote' | 'demote' |
|
||
| NEW_TOKEN | new.jwt | JSON | Notifies when the token (jwt) is updated
|
||
|
||
## Webhook Routes
|
||
When enabling the WEBHOOK_BY_EVENTS options in the global and local webhooks, the following paths will be added at the end of the webhook.
|
||
|
||
| Name | Route |
|
||
|------|-------|
|
||
| APPLICATION_STARTUP | https://url_webhook/application-startup |
|
||
| QRCODE_UPDATED | https://url_webhook/qrcode-updated |
|
||
| CONNECTION_UPDATE | https://url_webhook/connection-update |
|
||
| MESSAGES_SET | https://url_webhook/messages-set |
|
||
| MESSAGES_UPSERT | https://url_webhook/messages-upsert |
|
||
| MESSAGES_UPDATE | https://url_webhook/messages-update |
|
||
| SEND_MESSAGE | https://url_webhook/send-message |
|
||
| CONTACTS_SET | https://url_webhook/contacts-set |
|
||
| CONTACTS_UPSERT | https://url_webhook/contacts-upsert |
|
||
| CONTACTS_UPDATE | https://url_webhook/contacts-update |
|
||
| PRESENCE_UPDATE | https://url_webhook/presence-update |
|
||
| CHATS_SET | https://url_webhook/chats-set |
|
||
| CHATS_UPDATE | https://url_webhook/chats-update |
|
||
| CHATS_UPSERT | https://url_webhook/chats-upsert |
|
||
| GROUPS_UPSERT | https://url_webhook/groups-upsert |
|
||
| GROUPS_UPDATE | https://url_webhook/groups-update |
|
||
| GROUP_PARTICIPANTS_UPDATE | https://url_webhook/groups-participants-update |
|
||
| NEW_TOKEN | https://url_webhook/new-token |
|
||
## Env File
|
||
|
||
See additional settings that can be applied through the **env** file by clicking **[here](./src/dev-env.yml)**.
|
||
|
||
> **⚠️Attention⚠️:** rename the **dev-env.yml** file to **env.yml**.
|
||
|
||
## SSL
|
||
|
||
To install the SSL certificate, follow the **[instructions](https://certbot.eff.org/instructions?ws=other&os=ubuntufocal)** below.
|
||
|
||
# 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
|
||
|
||
<div align="center">
|
||
<a href="https://app.picpay.com/user/davidsongomes1998" target="_blank" rel="noopener noreferrer">
|
||
<img src="./public/images/picpay-image.png" style="width: 50% !important;">
|
||
</a>
|
||
</div>
|
||
|
||
</br> |