# evolution-foundation/evolution-api

Evolution API is an open-source WhatsApp integration API

Repository: https://github.com/evolution-foundation/evolution-api
Canonical: https://ross.abutalabs.com/products/evolution-api
Homepage: https://evolutionfoundation.com.br
Language: TypeScript
License: NOASSERTION
License Family: other
Topics: chatbot, chatwoot, cloud-api, dify, evolution, n8n, openai, pusher, rabbitmq, whatsapp, whatsapp-api, whatsapp-bot, typebot
Last push: 2026-07-14T19:50:55+00:00

## Health v2 (maintenance only)
Score: 79/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 92, release rhythm 60, longevity 84
- inputs: {"age_days": 1181, "days_push": 50, "days_rel": 271, "gap_med": 21, "n_releases_24m": 12}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 9430, forks 7174 (observed 2026-08-28T04:10:31.122621+00:00)

## What it is
Evolution API is an open-source REST API for WhatsApp and multi-channel messaging, supporting both the Baileys-based WhatsApp Web API and the official WhatsApp Cloud API. It integrates with tools like Typebot, Chatwoot, Dify, OpenAI, RabbitMQ, Kafka, and n8n to build messaging bots and automation workflows.

## Use cases
- send and receive whatsapp messages via api
- build a whatsapp chatbot
- integrate whatsapp with chatwoot support desk
- connect whatsapp to n8n automation workflows
- self-host a whatsapp business api gateway
- bridge whatsapp with openai or dify ai agents

## When to choose
- you need a self-hosted whatsapp messaging gateway without per-message fees
- you want both unofficial (Baileys) and official Cloud API connections in one service
- you need integrations with chatbots, CRMs, and workflow tools like Typebot, Chatwoot, or n8n

## When to avoid
- you need a fully official, ToS-compliant WhatsApp solution only — the Baileys mode relies on WhatsApp Web and risks account bans
- you want a managed SaaS messaging provider with SLAs rather than self-hosted infrastructure
- your messaging needs are outside WhatsApp and its supported channels

## Facets
- artifact type: service
- maturity: active
- function: api-framework, http-server, chatbot, webhook, message-queue, chat-interface
- domain: messaging-platforms, chatbots, apis, self-hosted
- platform: self-hosted, cross-platform
- tags: whatsapp, baileys, whatsapp-cloud-api, chatwoot, typebot, dify, n8n, multi-channel-messaging, rest-api, automation, nodejs, docker

## Member repositories
- evolution-foundation/evolution-api (main) score 79

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:31.122621+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:22:08.415242+00:00, confidence not recorded.
  - readme: https://github.com/evolution-foundation/evolution-api (fetched 2026-08-28T04:10:31.122621+00:00, sha 876dae99155e)
  - homepage: https://evolutionfoundation.com.br (fetched 2026-08-29T08:22:21.449403+00:00, sha 1cead16b7317)
- Data as of 2026-08-30T08:39:29.467469+00:00.