Agent skill

Evogo

by LeoYeAI in LeoYeAI/openclaw-master-skills

Complete WhatsApp automation via Evolution API Go v3 - instances, messages (text/media/polls/carousels), groups, contacts, chats, communities, newsletters, and real-time webhooks

MITAuto-check passedBackend & APIs

Install Evogo

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill evogo -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills evogo --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/evogo .claude/skills/evogo && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "evogo" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/evogo into .claude/skills/evogo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "evogo", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/evogo

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill evogo -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills evogo --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/evogo .agents/skills/evogo && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "evogo" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/evogo into .agents/skills/evogo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "evogo", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill evogo -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills evogo --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/evogo .cursor/skills/evogo && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "evogo" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/evogo into .cursor/skills/evogo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "evogo", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/LeoYeAI/openclaw-master-skills.git --path skills/evogo

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill evogo -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills evogo --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/evogo .gemini/skills/evogo && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "evogo" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/evogo into .gemini/skills/evogo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "evogo", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills evogo

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill evogo -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/evogo .github/skills/evogo && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "evogo" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/evogo into .github/skills/evogo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "evogo", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add LeoYeAI/openclaw-master-skills --skill evogo -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install LeoYeAI/openclaw-master-skills evogo --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/evogo .opencode/skills/evogo && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "evogo" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/evogo into .opencode/skills/evogo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "evogo", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: evogo
GitHub stars: 2.2k
Token cost: ~4.6k tokens
SKILL.md length: 824 words
Files: 2
Skills in repo: 1,235
Repo updated: Jul 20, 2026
First seen: Oct 9, 2026
Licence: MIT

At a glance

Complete WhatsApp automation via Evolution API Go v3 - instances, messages (text/media/polls/carousels), groups, contacts, chats, communities, newsletters, and real-time webhooks

Works in 3 steps: Set Environment Variables → Create Instance & Connect → Send First Message
Tasks that involve Newsletters
SKILL.md covers 🚀 Quick Start, 🔐 Authentication, 📦 Core Concepts and 🎯 Feature Reference, plus 4 more sections
Calls curl and jq; reaches chat.whatsapp.com; needs EVOGO_API_KEY and EVOGO_GLOBAL_KEY

What it does

Evogo is an agent skill from LeoYeAI/openclaw-master-skills. Complete WhatsApp automation via Evolution API Go v3 - instances, messages (text/media/polls/carousels), groups, contacts, chats, communities, newsletters, and real-time webhooks

Its SKILL.md is about 4.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `_meta.json`).

It sits in Backend & APIs, covering Newsletters, Webhooks and Messaging and chat bots. It works with WhatsApp. The repository describes itself as: 🧠 Curated collection of 1209+ best OpenClaw skills — weekly updated by MyClaw.ai. The licence is MIT.

When your agent uses it

Tasks that involve Newsletters
Tasks that involve Webhooks
Tasks that involve Messaging and chat bots

Example prompts

“/evogo”

Requirements

A credential in EVOGO_GLOBAL_KEY
A credential in EVOGO_API_KEY

Workflow steps

3 steps, taken from the step headings in SKILL.md.

Set Environment Variables
Create Instance & Connect
Send First Message

What it can do on your machine

Read from SKILL.md and the folder at commit e5199b5. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- curl
- jq
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- chat.whatsapp.com
Also links to:
- github.com
- developers.facebook.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- EVOGO_API_KEY
- EVOGO_GLOBAL_KEY
- INVITE_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Evogo loads about 4.6k tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 824 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~46
When it runs · the whole SKILL.md, loaded when a task matches: ~4.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from LeoYeAI/openclaw-master-skills at commit e5199b5, republished under its MIT licence (© LeoYeAI). 824 words, ~4,613 tokens.

Download SKILL.mdSave it as .claude/skills/evogo/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: evogo
description: Complete WhatsApp automation via Evolution API Go v3 - instances, messages (text/media/polls/carousels), groups, contacts, chats, communities, newsletters, and real-time webhooks

evoGo - Evolution API Go v3

Complete WhatsApp automation via Evolution API Go v3. Send messages, manage groups, automate conversations, and integrate webhooks.

🚀 Quick Start

1. Set Environment Variables

json5

{
  env: {
    EVOGO_API_URL: "http://localhost:8080",        // Your API URL
    EVOGO_GLOBAL_KEY: "your-global-admin-key",     // Admin key (instance mgmt)
    EVOGO_INSTANCE: "my-bot",                      // Instance name
    EVOGO_API_KEY: "your-instance-token"           // Instance token (messaging)
  }
}

2. Create Instance & Connect

bash

# Create instance
curl -X POST "$EVOGO_API_URL/instance/create" \
  -H "apikey: $EVOGO_GLOBAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-bot",
    "token": "my-secret-token",
    "qrcode": true
  }'

# Connect & get QR code
curl -X POST "$EVOGO_API_URL/instance/connect" \
  -H "apikey: $EVOGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number": ""}'

Scan the QR code returned in qrcode.base64.

3. Send First Message

bash

curl -X POST "$EVOGO_API_URL/send/text" \
  -H "apikey: $EVOGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "5511999999999",
    "text": "Hello from evoGo! 🚀"
  }'

🔐 Authentication

Two authentication levels:

Type	Header	Usage
Global API Key	`apikey: xxx`	Admin: create/delete instances, logs
Instance Token	`apikey: xxx`	Messaging: send messages, groups, contacts

Set via environment or pass directly in headers.

📦 Core Concepts

Phone Number Formats

Context	Format	Example
Sending messages	International (no +)	`5511999999999`
Group participants	JID format	`5511999999999@s.whatsapp.net`
Groups	Group JID	`120363123456789012@g.us`
Newsletters	Newsletter JID	`120363123456789012@newsletter`

Message Delay

Add delay (milliseconds) to avoid rate limits:

json

{
  "number": "5511999999999",
  "text": "Message with delay",
  "delay": 2000
}

🎯 Feature Reference

📱 Instance Management

Create Instance

bash

POST /instance/create
Header: apikey: $EVOGO_GLOBAL_KEY

{
  "name": "bot-name",
  "token": "secret-token",
  "qrcode": true,
  "advancedSettings": {
    "rejectCalls": false,
    "groupsIgnore": false,
    "alwaysOnline": true,
    "readMessages": true,
    "readStatus": true,
    "syncFullHistory": true
  }
}

Advanced Settings:

rejectCalls - Auto-reject calls
groupsIgnore - Ignore group messages
alwaysOnline - Stay online always
readMessages - Auto-mark messages as read
readStatus - Auto-mark status as viewed
syncFullHistory - Sync full chat history

Connect / Get QR Code

bash

POST /instance/connect
GET  /instance/qr
Header: apikey: $EVOGO_API_KEY

{"number": ""}  # Leave empty for QR, or phone number for pairing

Connection Status

bash

GET /instance/status
Header: apikey: $EVOGO_API_KEY

Returns: connected, connecting, disconnected

List All Instances

bash

GET /instance/all
Header: apikey: $EVOGO_GLOBAL_KEY

Delete Instance

bash

DELETE /instance/delete/{instance}
Header: apikey: $EVOGO_GLOBAL_KEY

Force Reconnect

bash

POST /instance/forcereconnect/{instance}
Header: apikey: $EVOGO_GLOBAL_KEY

{"number": "5511999999999"}

Logs

bash

GET /instance/logs/{instance}?start_date=2026-01-01&end_date=2026-02-10&level=info&limit=100
Header: apikey: $EVOGO_GLOBAL_KEY

Log levels: info, warn, error, debug

💬 Send Messages

Text Message

bash

POST /send/text

{
  "number": "5511999999999",
  "text": "Hello World!",
  "delay": 1000,
  "mentionsEveryOne": false,
  "mentioned": ["5511888888888@s.whatsapp.net"]
}

Media (URL)

bash

POST /send/media

{
  "number": "5511999999999",
  "url": "https://example.com/photo.jpg",
  "type": "image",
  "caption": "Check this out!",
  "filename": "photo.jpg"
}

Media types:

image - JPG, PNG, GIF, WEBP
video - MP4, AVI, MOV, MKV
audio - MP3, OGG, WAV (sent as voice note/PTT)
document - PDF, DOC, DOCX, XLS, XLSX, PPT, TXT, ZIP
ptv - Round video (Instagram-style)

Media (File Upload)

bash

POST /send/media
Content-Type: multipart/form-data

number=5511999999999
type=image
file=@/path/to/file.jpg
caption=Photo caption
filename=custom-name.jpg

Poll

bash

POST /send/poll

{
  "number": "5511999999999",
  "question": "Best language?",
  "options": ["JavaScript", "Python", "Go", "Rust"],
  "selectableCount": 1
}

Get poll results:

bash

GET /polls/{messageId}/results

Sticker

bash

POST /send/sticker

{
  "number": "5511999999999",
  "sticker": "https://example.com/sticker.webp"
}

Auto-converts images to WebP format.

Location

bash

POST /send/location

{
  "number": "5511999999999",
  "latitude": -23.550520,
  "longitude": -46.633308,
  "name": "Avenida Paulista",
  "address": "Av. Paulista, São Paulo - SP"
}

Contact

bash

POST /send/contact

{
  "number": "5511999999999",
  "vcard": {
    "fullName": "João Silva",
    "phone": "5511988888888",
    "organization": "Company XYZ",
    "email": "joao@example.com"
  }
}

Carousel

bash

POST /send/carousel

{
  "number": "5511999999999",
  "body": "Main carousel text",
  "footer": "Footer text",
  "cards": [
    {
      "header": {
        "title": "Card 1",
        "subtitle": "Subtitle",
        "imageUrl": "https://example.com/img1.jpg"
      },
      "body": {"text": "Card description"},
      "footer": "Card footer",
      "buttons": [
        {
          "displayText": "Click Me",
          "id": "btn1",
          "type": "REPLY"
        }
      ]
    }
  ]
}

Button types:

REPLY - Simple reply
URL - Opens link
CALL - Initiates call
COPY - Copies text

📨 Message Operations

React to Message

bash

POST /message/react

{
  "number": "5511999999999",
  "reaction": "👍",
  "id": "MESSAGE_ID",
  "fromMe": false,
  "participant": "5511888888888@s.whatsapp.net"  # Required in groups
}

Reactions: 👍, ❤️, 😂, 😮, 😢, 🙏, or "remove"

Typing/Recording Indicator

bash

POST /message/presence

{
  "number": "5511999999999",
  "state": "composing",
  "isAudio": false
}

States:

composing + isAudio: false → "typing..."
composing + isAudio: true → "recording audio..."
paused → Stops indicator

Mark as Read

bash

POST /message/markread

{
  "number": "5511999999999",
  "id": ["MESSAGE_ID_1", "MESSAGE_ID_2"]
}

Download Media

bash

POST /message/downloadmedia

{
  "message": {}  # Full message object from webhook
}

Returns base64-encoded media.

Edit Message

bash

POST /message/edit

{
  "chat": "5511999999999@s.whatsapp.net",
  "messageId": "MESSAGE_ID",
  "message": "Edited text"
}

Limitations:

Text messages only
Your messages only
~15 minute time limit

Delete Message

bash

POST /message/delete

{
  "chat": "5511999999999@s.whatsapp.net",
  "messageId": "MESSAGE_ID"
}

Limitations:

Your messages only
~48 hour time limit

Get Message Status

bash

POST /message/status

{
  "id": "MESSAGE_ID"
}

Returns delivery/read status.

👥 Group Management

List Groups

bash

GET /group/list        # Basic info (JID + name)
GET /group/myall       # Full info (participants, settings, etc)

Get Group Info

bash

POST /group/info

{
  "groupJid": "120363123456789012@g.us"
}

Create Group

bash

POST /group/create

{
  "groupName": "My Team",
  "participants": [
    "5511999999999@s.whatsapp.net",
    "5511888888888@s.whatsapp.net"
  ]
}

Requirements:

Name: max 25 characters
Participants: minimum 1

Manage Participants

bash

POST /group/participant

{
  "groupJid": "120363123456789012@g.us",
  "action": "add",
  "participants": ["5511999999999@s.whatsapp.net"]
}

Actions:

add - Add members
remove - Remove members
promote - Make admin
demote - Remove admin

Update Group Settings

bash

POST /group/settings

{
  "groupJid": "120363123456789012@g.us",
  "action": "announcement"
}

Settings:

announcement / not_announcement - Only admins send messages
locked / unlocked - Only admins edit group info
approval_on / approval_off - Require approval to join
admin_add / all_member_add - Who can add members

Get Invite Link

bash

POST /group/invitelink

{
  "groupJid": "120363123456789012@g.us",
  "reset": false
}

Set reset: true to revoke old link and generate new one.

Join Group

bash

POST /group/join

{
  "code": "https://chat.whatsapp.com/XXXXXX"
}

Accepts full link or just the code.

Leave Group

bash

POST /group/leave

{
  "groupJid": "120363123456789012@g.us"
}

Manage Join Requests

bash

# Get pending requests
POST /group/requests
{
  "groupJid": "120363123456789012@g.us"
}

# Approve/Reject
POST /group/requests/action
{
  "groupJid": "120363123456789012@g.us",
  "action": "approve",
  "participants": ["5511999999999@s.whatsapp.net"]
}

Actions: approve, reject

Update Group Metadata

bash

# Set photo
POST /group/photo
{
  "groupJid": "120363123456789012@g.us",
  "image": "https://example.com/photo.jpg"
}

# Set name
POST /group/name
{
  "groupJid": "120363123456789012@g.us",
  "name": "New Group Name"
}

# Set description
POST /group/description
{
  "groupJid": "120363123456789012@g.us",
  "description": "New description"
}

💬 Chat Management

Pin/Unpin Chat

bash

POST /chat/pin
POST /chat/unpin

{
  "chat": "5511999999999@s.whatsapp.net"
}

Archive/Unarchive Chat

bash

POST /chat/archive
POST /chat/unarchive

{
  "chat": "5511999999999@s.whatsapp.net"
}

Mute/Unmute Chat

bash

POST /chat/mute
POST /chat/unmute

{
  "chat": "5511999999999@s.whatsapp.net"
}

Sync History

bash

POST /chat/history-sync-request

Requests full chat history sync (may take time).

👤 User & Profile

Get User Info

bash

POST /user/info

{
  "number": ["5511999999999", "5511888888888"],
  "formatJid": true
}

Returns: status, profile photo, verified badge, linked devices, etc.

Check WhatsApp Registration

bash

POST /user/check

{
  "number": ["5511999999999", "5511888888888"]
}

Returns: isInWhatsapp (true/false) for each number.

Get Profile Picture

bash

POST /user/avatar

{
  "number": "5511999999999",
  "preview": false
}

Preview options:

false - Full resolution
true - Low resolution preview

Get Contacts

bash

GET /user/contacts

Lists all saved contacts.

Privacy Settings

bash

# Get privacy settings
GET /user/privacy

# Set privacy settings
POST /user/privacy
{
  "groupAdd": "all",
  "lastSeen": "contacts",
  "status": "all",
  "profile": "all",
  "readReceipts": "all",
  "callAdd": "all",
  "online": "match_last_seen"
}

Options: all, contacts, contact_blacklist, none, match_last_seen (online only)

Block/Unblock Contact

bash

POST /user/block
POST /user/unblock

{
  "number": "5511999999999"
}

# Get block list
GET /user/blocklist

Update Profile

bash

# Set profile picture
POST /user/profilePicture
{
  "image": "https://example.com/photo.jpg"
}

# Set profile name
POST /user/profileName
{
  "name": "My Name"
}

# Set status/about
POST /user/profileStatus
{
  "status": "My custom status"
}

Limits:

Name: 25 characters max
Status: 139 characters max

🏷️ Labels (Tags)

Add Label

bash

# To chat
POST /label/chat
{
  "jid": "5511999999999@s.whatsapp.net",
  "labelId": "1"
}

# To message
POST /label/message
{
  "jid": "5511999999999@s.whatsapp.net",
  "labelId": "1",
  "messageId": "MESSAGE_ID"
}

Remove Label

bash

POST /unlabel/chat
POST /unlabel/message

{
  "jid": "5511999999999@s.whatsapp.net",
  "labelId": "1",
  "messageId": "MESSAGE_ID"  # Only for /unlabel/message
}

Edit Label

bash

POST /label/edit

{
  "labelId": "1",
  "name": "New Label Name"
}

List Labels

bash

GET /label

🏘️ Communities

Create Community

bash

POST /community/create

{
  "communityName": "My Community",
  "description": "Optional description"
}

Add/Remove Groups

bash

POST /community/add
{
  "communityJID": "120363123456789012@g.us",
  "groupJID": ["120363111111111111@g.us"]
}

POST /community/remove
{
  "communityJID": "120363123456789012@g.us",
  "groupJID": ["120363111111111111@g.us"]
}

📢 Newsletters (Channels)

bash

POST /newsletter/create

{
  "name": "My Channel",
  "description": "Optional description"
}

Show full SKILL.md (330 more words)Show less

List Newsletters

bash

GET /newsletter/list

bash

POST /newsletter/info

{
  "jid": "120363123456789012@newsletter"
}

bash

POST /newsletter/subscribe

{
  "jid": "120363123456789012@newsletter"
}

bash

POST /newsletter/messages

{
  "jid": "120363123456789012@newsletter",
  "limit": 50
}

Get Invite Link Info

bash

POST /newsletter/link

{
  "key": "INVITE_KEY"
}

📞 Call Management

Reject Call

bash

POST /call/reject

# Webhook payload from call event

Use with webhook automation to auto-reject calls.

🎬 Common Workflows

Broadcast Message to Multiple Contacts

bash

for number in 5511999999999 5511888888888 5511777777777; do
  curl -X POST "$EVOGO_API_URL/send/text" \
    -H "apikey: $EVOGO_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{
      \"number\": \"$number\",
      \"text\": \"Broadcast message\",
      \"delay\": 2000
    }"
done

Send Image with Mentions (Groups)

bash

curl -X POST "$EVOGO_API_URL/send/media" \
  -H "apikey: $EVOGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "120363123456789012@g.us",
    "url": "https://example.com/report.jpg",
    "type": "image",
    "caption": "Report ready! @5511999999999 please review",
    "mentionedJid": ["5511999999999@s.whatsapp.net"]
  }'

Auto-Create Group + Welcome Message

bash

# 1. Create group
GROUP_JID=$(curl -s -X POST "$EVOGO_API_URL/group/create" \
  -H "apikey: $EVOGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "groupName": "Team Alpha",
    "participants": ["5511999999999@s.whatsapp.net"]
  }' | jq -r '.groupJid')

# 2. Send welcome message
curl -X POST "$EVOGO_API_URL/send/text" \
  -H "apikey: $EVOGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"number\": \"$GROUP_JID\",
    \"text\": \"Welcome to Team Alpha! 🎉\"
  }"

Check Multiple Numbers

bash

curl -X POST "$EVOGO_API_URL/user/check" \
  -H "apikey: $EVOGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": [
      "5511999999999",
      "5511888888888",
      "5511777777777"
    ]
  }'

⚠️ Rate Limits & Best Practices

Delays

Always add delays between messages:

json

{"delay": 2000}  // 2 seconds

Recommended:

1-2 seconds between individual messages
3-5 seconds between mass sends
Exponential backoff on errors

Error Handling

HTTP Status Codes:

200 - Success
400 - Bad request (check parameters)
401 - Unauthorized (check API key)
404 - Not found (instance/resource doesn't exist)
500 - Server error

Common Issues:

Error	Solution
Instance not connected	Run `POST /instance/connect`
Invalid phone format	Use international without `+`: `5511999999999`
Message not sent	Check `GET /instance/status`
Group operation failed	Verify you're admin (for admin operations)

🔗 Webhooks

Configure webhooks to receive real-time events:

Message received
Message sent
Connection status
Group updates
Calls received
And more...

Use POST /webhook/set endpoint to configure webhook URL (see Postman collection for details).

🧪 Troubleshooting

Instance Won't Connect

bash

# 1. Check if instance exists
GET /instance/all

# 2. Force reconnect
POST /instance/forcereconnect/{instance}

# 3. Check logs
GET /instance/logs/{instance}?level=error

Messages Not Sending

Verify connection: GET /instance/status
Check phone format (no + or spaces)
Ensure recipient has WhatsApp
Verify API key is correct

Group Operations Failing

Check you're admin (for admin operations)
Verify group JID format: xxxxx@g.us
Ensure participants use format: number@s.whatsapp.net

📚 Resources

Evolution API Go: https://github.com/EvolutionAPI/evolution-api
WhatsApp Business API: https://developers.facebook.com/docs/whatsapp
JID Format Guide: number@s.whatsapp.net for users, xxxxx@g.us for groups

🆕 Known Limitations

Not Working (v3.0):

/send/button - Interactive buttons (deprecated by WhatsApp)
/send/list - Interactive lists (deprecated by WhatsApp)

These endpoints exist but are non-functional due to WhatsApp API changes.

💡 Tips

Always check status before operations
Use delays to avoid rate limits (1-2s minimum)
Store tokens securely in environment variables
Handle disconnects with automatic reconnection
Validate numbers before sending
Use webhooks for real-time event handling
Monitor logs for troubleshooting
Test with small groups before mass operations

evoGo simplifies WhatsApp automation with Evolution API Go v3. For advanced features, check the full Postman collection or API documentation.

Files

SKILL.md and 1 other file in skills/evogo of LeoYeAI/openclaw-master-skills.

SKILL.md
_meta.json

Open the folder on GitHubat commit e5199b5

Compare with similar skills

Evogo next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Evogo compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Evogo this skillLeoYeAI/openclaw-master-skills	2.2k	—	~4.6k	Automated safety check: Pass	MIT	2 mo ago
Integrate Whatsappgokapso/agent-skills	177	—	~4.8k	Automated safety check: Pass	None	yesterday
Integration WebhooksBuilderIO/agent-native	7.1k	—	~5.3k	Automated safety check: Pass	None	today
Ak Dev New Messaging Integrationyaalalabs/agent-kernel	192	—	~4.6k	Automated safety check: Pass	Apache-2.0	today
WhatsApp Cloud API Channel for NanoClawnanocoai/nanoclaw	31k	—	~1.9k	Automated safety check: Notes	MIT	2 days ago
Ak Add Integrationyaalalabs/agent-kernel	192	—	~3.1k	Automated safety check: Pass	Apache-2.0	today

Similar skills

Integrate Whatsapp
gokapso/agent-skills
Connect WhatsApp to your product with Kapso: onboard customers with setup links, detect connections, receive events via webhooks, and send messages/templates/media.
177 GitHub stars~4.8k tokensUpdated yesterday
Backend & APIsAuto-check passed
Integration Webhooks
BuilderIO/agent-native
Cross-platform pattern for handling messaging integration webhooks (Slack, Telegram, WhatsApp, email, etc.) on serverless hosts.
7.1k GitHub stars~5.3k tokensUpdated today
Backend & APIsAuto-check passed
Ak Dev New Messaging Integration
yaalalabs/agent-kernel
Step-by-step guide for adding a new messaging platform integration to Agent Kernel.
192 GitHub stars~4.6k tokensUpdated today
Productivity & AutomationAuto-check passed
WhatsApp Cloud API Channel for NanoClaw
nanocoai/nanoclaw
Connects NanoClaw to WhatsApp through Meta's official Business Cloud API using the Chat SDK bridge, with notes for upgrading older installs.
31k GitHub stars~1.9k tokensUpdated 2 days ago
Productivity & AutomationAuto-check: notes
Ak Add Integration
yaalalabs/agent-kernel
Add a messaging platform integration to an existing Agent Kernel project.
192 GitHub stars~3.1k tokensUpdated today
Productivity & AutomationAuto-check passed
X Twitter Scraper
Xquik-dev/x-twitter-scraper
Use Xquik to fetch X (Twitter) data or act through a connected account: search, profiles, followers, replies, threads, timelines, media downloads, bulk exports, trends, monitors, signed webhooks…
210 GitHub starsUsed in 1 repo~2.6k tokens
Backend & APIsAuto-check passed

Questions about Evogo

What does Evogo do?

Complete WhatsApp automation via Evolution API Go v3 - instances, messages (text/media/polls/carousels), groups, contacts, chats, communities, newsletters, and real-time webhooks. Evogo is an agent skill from LeoYeAI/openclaw-master-skills.

When should I use Evogo?

Evogo fits situations like: tasks that involve Newsletters; tasks that involve Webhooks; tasks that involve Messaging and chat bots.

How do I install Evogo in Claude Code?

Run `npx skills add LeoYeAI/openclaw-master-skills --skill evogo -a claude-code`. Or copy the skill folder (skills/evogo in LeoYeAI/openclaw-master-skills) into .claude/skills/evogo in your project. Claude Code loads it when a task matches its description.

How do I install Evogo in Codex?

Run `npx skills add LeoYeAI/openclaw-master-skills --skill evogo -a codex`. Or copy the skill folder (skills/evogo in LeoYeAI/openclaw-master-skills) into .agents/skills/evogo in your project. Codex loads it when a task matches its description.

Can I use Evogo in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add LeoYeAI/openclaw-master-skills --skill evogo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/evogo, .gemini/skills/evogo, .github/skills/evogo and .opencode/skills/evogo in your project.

What does Evogo need to run?

Going by SKILL.md and its folder, Evogo needs the command-line tools its instructions call (curl and jq) and credentials named EVOGO_API_KEY, EVOGO_GLOBAL_KEY and INVITE_KEY. Our summary lists: A credential in EVOGO_GLOBAL_KEY; A credential in EVOGO_API_KEY.

Does Evogo access the network?

SKILL.md names 3 domains. In commands or code: chat.whatsapp.com; the agent is likely to contact it when it follows the instructions. As links in the text: github.com and developers.facebook.com. This is read from the text; nothing was executed.

Is Evogo safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Evogo use?

Evogo is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Evogo use?

About 4.6k tokens (SKILL.md is roughly 18k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Evogo?

Skills that share tags, products or a category with Evogo: Integrate Whatsapp (gokapso/agent-skills, 177 stars), Integration Webhooks (BuilderIO/agent-native, 7.1k stars), Ak Dev New Messaging Integration (yaalalabs/agent-kernel, 192 stars) and WhatsApp Cloud API Channel for NanoClaw (nanocoai/nanoclaw, 31k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Evogo?

LeoYeAI (a GitHub user) maintains it in LeoYeAI/openclaw-master-skills, which has 2,160 GitHub stars. The repository holds 1,235 skills in this directory. The repository was last updated on July 20, 2026.

Source: LeoYeAI/openclaw-master-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Evogo

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

evoGo - Evolution API Go v3

🚀 Quick Start

1. Set Environment Variables

2. Create Instance & Connect

3. Send First Message

🔐 Authentication

📦 Core Concepts

Phone Number Formats

Message Delay

🎯 Feature Reference

📱 Instance Management

Create Instance

Connect / Get QR Code

Connection Status

List All Instances

Delete Instance

Force Reconnect

Logs

💬 Send Messages

Text Message

Media (URL)

Media (File Upload)

Poll

Sticker

Location

Contact

Carousel

📨 Message Operations

React to Message

Typing/Recording Indicator

Mark as Read

Download Media

Edit Message

Delete Message

Get Message Status

👥 Group Management

List Groups

Get Group Info

Create Group

Manage Participants

Update Group Settings

Get Invite Link

Join Group

Leave Group

Manage Join Requests

Update Group Metadata

💬 Chat Management

Pin/Unpin Chat

Archive/Unarchive Chat

Mute/Unmute Chat

Sync History

👤 User & Profile

Get User Info

Check WhatsApp Registration

Get Profile Picture

Get Contacts

Privacy Settings

Block/Unblock Contact

Update Profile

🏷️ Labels (Tags)

Add Label

Remove Label

Edit Label

List Labels