# Int Evolution Go

> Int Evolution Go is an Agent Skill for apps & automation published in the evolution-foundation/evo-nexus repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

- Skill name: `int-evolution-go`
- Category: [Apps & Automation](https://www.openparable.com/skill/apps-automation/1)
- Source: https://github.com/evolution-foundation/evo-nexus/blob/HEAD/.claude/skills/int-evolution-go/SKILL.md
- Repository: evolution-foundation/evo-nexus (498 GitHub stars when collected)

## 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`.

---

Source: https://www.openparable.com/skill/apps-automation/int-evolution-go (OpenParable). Cite the canonical URL above.
