Pular para o conteúdo principal
A Evolution API é a API REST principal do ecossistema Evolution para integração com WhatsApp. Construída com Node.js e TypeScript, oferece uma solução completa e robusta para comunicação via WhatsApp, suportando tanto a conexão via Baileys (WhatsApp Web) quanto a API oficial do WhatsApp Business (Meta Cloud API).

Principais recursos

  • Multi-provedor — Suporte a Baileys (WhatsApp Web), Meta Business API e Evolution Provider
  • API RESTful — Endpoints REST completos para gerenciamento de instâncias, mensagens, grupos e contatos
  • Multi-tenant — Isolamento completo por instância com autenticação independente
  • Integrações nativas — Typebot, Chatwoot, OpenAI, Dify, N8N, Flowise e EvoAI
  • Sistema de eventos — WebSocket, RabbitMQ, Amazon SQS, Kafka, NATS e Pusher
  • Armazenamento de mídia — Suporte a Amazon S3 e MinIO para arquivos de mídia
  • Multi-banco — Compatível com PostgreSQL e MySQL via Prisma ORM
  • Cache Redis — Cache distribuído para alta performance
  • QR Code — Geração de QR Code para pareamento de dispositivos
  • Docker — Configuração Docker pronta para produção

Stack tecnológica

TecnologiaUso
Node.js 20+Runtime principal
TypeScript 5+Linguagem principal
Express.jsFramework HTTP
Prisma ORMAcesso a dados (PostgreSQL/MySQL)
RedisCache e filas
BaileysCliente WhatsApp Web
Meta Cloud APIWhatsApp Business API oficial
Socket.ioEventos em tempo real
DockerContainerização

Tipos de conexão

A Evolution API suporta dois tipos de conexão com o WhatsApp:
  • WhatsApp API - Baileys: API gratuita baseada no WhatsApp Web, ideal para automações e chatbots
  • WhatsApp Cloud API: API oficial da Meta para empresas, com suporte a mensagens em escala e templates

Seções

Instalação

Guia rápido de instalação e configuração

Docker

Deploy com Docker e Docker Swarm

NVM

Instalação local com Node Version Manager

Nginx e SSL

Proxy reverso com certificado SSL

Variáveis de Ambiente

Referência completa de variáveis de configuração

Webhooks

Configuração de webhooks e eventos

Integrações

Chatbots, eventos e canais

Evolution API

Documentação técnica completa dos endpoints

Atualização

Como manter sua instância atualizada