Agent skill

int-evolution-go

Manage Evolution Go instances and send WhatsApp messages via the Evolution Go REST API. Use when you need to list/create/connect instances, send messages (text, media, location, contact, link, sticker, poll), react/edit/delete messages, check connection status, or get QR codes. Calls the Evolution Go server directly with no third-party proxy.

View SKILL.md on GitHub Repository
Stars 211
Forks 54

Install this agent skill to your Project

npx add-skill https://github.com/EvolutionAPI/evo-nexus/tree/main/.claude/skills/int-evolution-go

Metadata

Additional technical details for this skill

openclaw 
{
    "files": [
        "scripts/*"
    ],
    "requires": {
        "env": [
            "EVOLUTION_GO_URL",
            "EVOLUTION_GO_KEY"
        ],
        "bins": [
            "python3"
        ]
    },
    "primaryEnv": "EVOLUTION_GO_KEY"
}

SKILL.md

Evolution Go

Interact with your Evolution Go (WhatsApp) server via the Evolution Go REST API.

Setup (one-time)

  1. Get your API key from your Evolution Go instance admin panel.
  2. Set environment variables: 
    EVOLUTION_GO_URL=https://go.evolution-api.com
EVOLUTION_GO_KEY=your-api-key-here

Instance Management

List all instances

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py instances

Create a new instance

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py create_instance my-instance --token optional-token

Connect to instance

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py connect --phone 5511999999999 --webhook https://example.com/webhook
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py connect --phone 5511999999999 --webhook https://example.com/webhook --immediate --subscribe message,message.update

Disconnect from instance

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py disconnect

Get instance status

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py status

Get QR code for pairing

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py qr

Request pairing code

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py pair --phone 5511999999999

Logout from instance

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py logout

Delete an instance

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py delete_instance <instanceId>

Remove proxy from instance

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py delete_proxy <instanceId>

Overview of all instances with status

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py summary

Send Messages

Send text message

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py send_text 5511999999999 "Hello world"
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py send_text 5511999999999 "Hello" --delay 1000 --quoted '{"messageId":"ABC","participant":"5511..."}'

Send media (image, video, audio, document)

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py send_media 5511999999999 --url https://example.com/photo.jpg --type image --caption "Check this out"
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py send_media 5511999999999 --url https://example.com/doc.pdf --type document --filename report.pdf

Send location

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py send_location 5511999999999 --lat -19.9167 --lng -43.9345 --name "Office" --address "Av. Afonso Pena, 1000"

Send contact (vCard)

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py send_contact 5511999999999 --fullName "John Doe" --phone 5511888888888 --org "Acme Corp"

Send link preview

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py send_link 5511999999999 --url https://example.com --text "Check this link" --title "Example" --description "A great site" --imgUrl https://example.com/og.jpg

Send sticker

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py send_sticker 5511999999999 --sticker https://example.com/sticker.webp

Send poll

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py send_poll 5511999999999 --question "Favorite color?" --options "Red,Blue,Green" --maxAnswer 1

Message Operations

React to a message

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py react 5511999999999 --id MSG_ID --reaction "👍"

Edit a sent message

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py edit_message --chat 5511999999999@s.whatsapp.net --id MSG_ID --message "Updated text"

Delete message for everyone

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py delete_message --chat 5511999999999@s.whatsapp.net --id MSG_ID

Mark messages as read

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py mark_read 5511999999999 --ids MSG_ID1,MSG_ID2

Get message delivery status

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py message_status --id MSG_ID

Set chat presence (composing/recording)

bash
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py set_presence 5511999999999 --state composing
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py set_presence 5511999999999 --state composing --isAudio

Output

JSON to stdout. Use --json flag for raw JSON on any command (default for single-object responses).

Notes

  • Evolution Go uses instance-scoped auth: the API key identifies a specific instance.
  • Phone numbers accept plain format (e.g. 5511999999999) — the client converts to JID internally.
  • The send_media endpoint accepts a URL (not file upload).
  • The send_link endpoint auto-generates link previews.
  • All send commands support --delay, --quoted, --mentionAll, and --mentionedJid.

Didn't find tool you were looking for?

Be as detailed as possible for better results