Navigate:
All Reposevolution-api
~$EVOLUT0.4%

Evolution API: WhatsApp integration API with multi-platform support

Node.js REST API for programmatic WhatsApp control.

LIVE RANKINGS • 06:51 AM • STEADY
TOP 100TOP 100TOP 100TOP 100TOP 100TOP 100TOP 100TOP 100TOP 100TOP 100TOP 100TOP 100
OVERALL
#60
2
BACKEND & APIS
#2
30 DAY RANKING TREND
ovr#60
·Backe#2
STARS
6.8K
FORKS
5.2K
DOWNLOADS
7D STARS
+24
7D FORKS
+15
See Repo:
Share:

Learn more about evolution-api

Evolution API is a Node.js-based REST API that provides programmatic control over WhatsApp messaging through two connection methods: Baileys (which interfaces with WhatsApp Web) and Meta's official Cloud API. The system is built to handle multiple concurrent connections and supports event streaming through RabbitMQ, Apache Kafka, Amazon SQS, and WebSocket connections. It integrates with third-party services including Typebot for conversational flows, Chatwoot for customer service, Dify for AI orchestration, and OpenAI for language processing capabilities.

evolution-api

1

Dual connection methods

Supports both Baileys-based WhatsApp Web integration (free, no official approval required) and Meta's official WhatsApp Cloud API (production-grade, requires business verification). Users can choose based on their requirements for scale, reliability, and compliance.

2

Event streaming architecture

Implements multiple message queue backends (RabbitMQ, Kafka, SQS) and WebSocket support for real-time event delivery, allowing applications to consume WhatsApp events through their preferred infrastructure rather than polling.

3

Third-party platform integrations

Includes native integrations with chatbot builders (Typebot), customer service platforms (Chatwoot), AI services (Dify, OpenAI), and cloud storage (S3, Minio), reducing the need for custom middleware development.


import axios from 'axios';

const response = await axios.post('http://localhost:8080/message/sendText/my-instance', {
  number: '5511999999999',
  text: 'Hello from Evolution API!'
}, {
  headers: { 'apikey': 'your-api-key' }
});

console.log(response.data);

v2.3.6

Patches Chatwoot integration bugs (audio/document sending, lead handling) and fixes Baileys buffer storage; bumps Baileys to 7.0.0-rc.6.

  • Update Baileys dependency to 7.0.0-rc.6 to resolve Uint8Array database serialization and logging errors.
  • Verify Chatwoot audio/document uploads and lead message routing work correctly after cache fixes for PN/LID/g.us numbers.
v2.3.5

Fixes critical PostgreSQL migration error blocking Kafka integration and updates Baileys to v7.0.0-rc.5 with compatibility patches.

  • Run migrations to fix Kafka table reference error that caused 'relation public.Instance does not exist' failures.
  • Update Chatwoot integrations for improved message handling, conversation reopening logic, and webhook timeout fixes.
v2.3.4

Adds Apache Kafka event streaming, open-sources Evolution Manager v2, and fixes MySQL schema errors for createdAt fields.

  • Configure Kafka integration with new KAFKA_* environment variables for real-time event streaming and consumer groups.
  • Apply Prisma schema migration to fix MySQL CURRENT_TIMESTAMP defaults in Evoai and EvoaiSetting models.


[ EXPLORE MORE ]

Related Repositories

Discover similar tools and frameworks used by developers