APIs de WhatsApp

Evolution API

API REST brasileira de código aberto para WhatsApp, que conecta pelo WhatsApp Web ou pela API oficial da Meta

por Evolution Foundation

Em português
Nota dos leitores
Sem avaliaçõesAvaliar
Downloads pelo Flipters
0
Estrelas no GitHub
9.778

Última versão: 2.3.7, de 5 de dezembro de 2025

Sobre o Evolution API

Evolution API é uma API REST de código aberto para integrar o WhatsApp a sistemas, criada no Brasil e mantida pela Evolution Foundation. Roda em servidor próprio com Docker e conecta números de três formas: pelo Baileys, que usa o protocolo do WhatsApp Web, pela API oficial da Meta (Cloud API) ou pelo provedor próprio da Evolution. Tem integração nativa com Typebot, Chatwoot, n8n, OpenAI, Dify e Flowise e envia eventos por webhook, WebSocket e filas como RabbitMQ e Kafka.

O risco depende da conexão: pelo Baileys, que não é oficial, o número pode ser banido pelo WhatsApp; pela Cloud API, valem as regras e as tarifas da Meta. A licença é Apache 2.0 com condições de marca, e a partir da versão 2.4 cada instância precisa ser ativada, sem custo, no servidor de licenças da fundação.

Principais recursos

  • Conexão pelo Baileys, pela Cloud API oficial ou pelo provedor da Evolution
  • Integração nativa com Typebot, Chatwoot, n8n, OpenAI, Dify e Flowise
  • Eventos por webhook, WebSocket, RabbitMQ, Kafka e SQS
  • Várias instâncias no mesmo servidor
  • Painel Manager para administrar as conexões
  • Documentação em português

Novidades

Novidades da versão 2.3.7Publicada em 5 de dezembro de 2025. Notas do GitHub, em inglês.Mostrar

Features

  • WhatsApp Business Meta Templates: Add update and delete endpoints for Meta templates
  • New endpoints to edit and delete WhatsApp Business templates
  • Added DTOs and validation schemas for template management
  • Enhanced template lifecycle management capabilities
  • Events API: Add isLatest and progress to messages.set event
  • Allows consumers to know when history sync is complete (isLatest=true)
  • Track sync progress percentage through webhooks
  • Added extra field to EmitData type for additional payload properties
  • Updated all event controllers (webhook, rabbitmq, sqs, websocket, pusher, kafka, nats)
  • N8N Integration: Add quotedMessage to payload in sendMessageToBot
  • Support for quoted messages in N8N chatbot integration
  • Enhanced message context information
  • WebSocket: Add wildcard "*" to allow all hosts to connect via websocket
  • More flexible host configuration for WebSocket connections
  • Improved host validation logic in WebsocketController
  • Pix Support: Handle interactive button message for pix
  • Support for interactive Pix button messages
  • Enhanced payment flow integration

Fixed

  • Baileys Message Processor: Fix incoming message events not working after reconnection
  • Added cleanup logic in mount() to prevent memory leaks from multiple subscriptions
  • Recreate messageSubject if it was completed during logout
  • Remount messageProcessor in connectToWhatsapp() to ensure subscription is active
  • Fixed issue where onDestroy() calls complete() on RxJS Subject, making it permanently closed
  • Ensures old subscriptions are properly cleaned up before creating new ones
  • Baileys Authentication: Resolve "waiting for message" state after reconnection
  • Fixed Redis keys not being properly removed during instance logout
  • Prevented loading of old/invalid cryptographic keys on reconnection
  • Fixed blocking state where instances authenticate but cannot send messages
  • Ensures new credentials (creds) are properly used after reconnection
  • OnWhatsapp Cache: Prevent unique constraint errors and optimize database writes
  • Fixed Unique constraint failed on the fields: (remoteJid) error when sending to groups
  • Refactored query to use OR condition finding by jidOptions or remoteJid
  • Added deep comparison to skip unnecessary database updates
  • Replaced sequential processing with Promise.allSettled for parallel execution
  • Sorted JIDs alphabetically in jidOptions for accurate change detection
  • Added normalizeJid helper function for cleaner code
  • Proxy Integration: Fix "Media upload failed on all hosts" error when using proxy
  • Created makeProxyAgentUndici() for Undici-compatible proxy agents
  • Fixed compatibility with Node.js 18+ native fetch() implementation
  • Replaced traditional HttpsProxyAgent/SocksProxyAgent with Undici ProxyAgent
  • Maintained legacy makeProxyAgent() for Axios compatibility
  • Fixed protocol handling in makeProxyAgent to prevent undefined errors
  • WhatsApp Business API: Fix base64, filename and caption handling
  • Corrected base64 media conversion in Business API
  • Fixed filename handling for document messages
  • Improved caption processing for media messages
  • Enhanced remoteJid validation and processing
  • Chat Service: Fix fetchChats and message panel errors
  • Fixed cleanMessageData errors in Manager message panel
  • Improved chat fetching reliability
  • Enhanced message data sanitization
  • Contact Filtering: Apply where filters correctly in findContacts endpoint
  • Fixed endpoint to process all where clause fields (id, remoteJid, pushName)
  • Previously only processed remoteJid field, ignoring other filters
  • Added remoteJid field to contactValidateSchema for proper validation
  • Maintained multi-tenant isolation with instanceId filtering
  • Allows filtering contacts by any supported
Ver a versão no GitHub

Avaliações de quem usa

Ainda sem avaliações

Usou o Evolution API? Conte para quem está escolhendo.

Avalie o Evolution API

Sua nota (obrigatória)

De 20 a 3.000 caracteres.0/3.000

Alternativas ao Evolution API

  • WAHA

    devlike.pro · APIs de WhatsApp

    API HTTP de código aberto para WhatsApp que roda o WhatsApp Web em Docker no seu servidor

    • 7.558 no GitHub
  • WPPConnect

    WPPConnect Team · APIs de WhatsApp

    Projeto de código aberto que automatiza o WhatsApp Web, com biblioteca para Node.js e servidor REST pronto

    • 1.054 no GitHub
  • Baileys

    WhiskeySockets · APIs de WhatsApp

    Biblioteca de código aberto em TypeScript que fala com o WhatsApp Web por WebSocket, sem navegador

    • 11,3 mil no GitHub
  • Z-API

    Z-API · APIs de WhatsApp

    API de WhatsApp brasileira em nuvem, com preço fixo por número e mensagens ilimitadas, conectada por QR code

Ver todos em APIs de WhatsApp

Fontes

Ficha escrita pela redação do Flipters a partir das fontes acima, revisada em 6 de outubro de 2026. Preços e versões mudam: confira no site oficial antes de comprar. Como trabalhamos.