evolution-api-v2

What This Skill Does

The evolution-api-v2 skill provides OpenClaw with a powerful bridge to the Evolution API v2.3, enabling enterprise-grade WhatsApp automation. It acts as an abstraction layer between the AI agent and the WhatsApp ecosystem, allowing the agent to send text, media, polls, lists, and buttons, as well as manage complex tasks like group administration, label management, and real-time status updates. Beyond basic messaging, the skill facilitates advanced chatbot workflows by enabling seamless integrations with platforms like Typebot, OpenAI, Dify, Flowise, N8N, and Chatwoot. It supports multiple integration types, including the feature-rich Baileys library and the official WhatsApp Business Cloud API, giving developers flexibility based on their infrastructure requirements.

Installation

To install this skill, use the ClawHub CLI inside your terminal: clawhub install openclaw/skills/skills/impa365/evolution-api

Once installed, you must configure your environment variables: EVO_API_URL, EVO_GLOBAL_KEY, EVO_INSTANCE, and EVO_API_KEY. These keys ensure secure communication between OpenClaw and your specific Evolution API instance. Ensure your API URL is accessible from your OpenClaw environment, especially if using a local containerized deployment.

Use Cases

• Automated Customer Support: Integrate with Chatwoot or OpenAI to resolve queries without human intervention.
• Marketing Campaigns: Send broadcast messages, personalized polls, and interactive buttons to segment and engage your user base.
• Workflow Automation: Connect with N8N or Flowise to trigger downstream business logic whenever a message is received.
• Lead Management: Automatically sync contact labels and status updates to your internal CRM.

Example Prompts

1. "Send a welcome message with a button menu to 5511999999999 using my default instance."
2. "Check the current connection status of my instance 'my-bot' and restart it if it is disconnected."
3. "Broadcast a poll to the group 'Sales Team' with options for 'Morning' and 'Afternoon' availability."

Tips & Limitations

• Rate Limiting: Always use the delay parameter (e.g., 1200ms) to mimic human behavior and avoid being flagged by WhatsApp for spam.
• Authentication: Keep your EVO_GLOBAL_KEY strictly protected as it grants administrative control over all your instances.
• JID Formats: Be careful with JIDs; remember that individual numbers require the suffix @s.whatsapp.net and group IDs require @g.us for successful message delivery.
• Integration: Test your integration type (WHATSAPP-BAILEYS vs WHATSAPP-BUSINESS) in a development environment before moving to production to ensure all desired features are supported by the channel.