LaunchKit · 2026
Back to Skills

evolution-api

Complete WhatsApp automation via Evolution API v2.3 - instances, messages (text/media/polls/lists/buttons/status)

1
711 downloads
by @impa365

Setup & Installation

openclaw skills install @impa365/evolution-api

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install evolution-api

What This Skill Does

Evolution API v2.3 is a self-hosted REST API for WhatsApp automation. It manages instances, sends all message types (text, media, polls, buttons, lists, status updates, voice notes), handles group administration, and integrates with multiple chatbot platforms and CRM tools. Supports six event transports and S3-compatible media storage.

Provides a single REST API surface for the full WhatsApp feature set plus built-in chatbot orchestration, eliminating the need to wire together separate messaging SDKs and bot frameworks.

When to use it

  • Broadcasting promotional messages to a validated contact list
  • Routing inbound WhatsApp chats to human agents via Chatwoot
  • Triggering order status notifications from an e-commerce backend
  • Building a keyword-triggered support bot using Typebot or OpenAI
  • Syncing WhatsApp group activity to an N8N automation workflow

Example Workflow

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: Create a WhatsApp support instance with a Typebot chatbot and Chatwoot handoff

AGENT
  1. 1POST /instance/create with instanceName, qrcode: true, and inline webhook pointing to N8N
  2. 2GET /instance/connect/{instance} to retrieve the QR code base64 for scanning
  3. 3POST /typebot/create/{instance} with triggerType all and the Typebot flow URL and ID
  4. 4POST /chatwoot/set/{instance} with account credentials, importContacts: true, and autoCreate: true
  5. 5Verify connection with GET /instance/connectionState/{instance}
OUTPUT

A connected WhatsApp instance that auto-responds via Typebot and escalates to human agents in Chatwoot

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

EVO_API_URL environment variable (URL of your Evolution API server)EVO_GLOBAL_KEY environment variable (global admin API key from your Evolution API server)EVO_INSTANCE environment variable (name of the WhatsApp instance to use)EVO_API_KEY environment variable (instance-specific API key)WhatsApp account for QR code pairing