int-evolution-api
/int-evolution-api
Manage WhatsApp instances and send messages via the Evolution API. Use when you need to list/create/connect instances, send messages (text, media, location, contact, buttons, lists, polls), query chats/contacts, manage groups, or configure webhooks. Calls the Evolution API REST endpoints directly.
- Author
- evolution-foundation ↗
- Repository
- evo-nexus ↗
- Licence
- Apache-2.0
- Last repository change
- 12.05.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 3
No signals detected. Repository changed on 12.05.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/evolution_api_client.py
What it does and when to use it
Manage WhatsApp instances and send messages via the Evolution API. Use when you need to list/create/connect instances, send messages (text, media, location, contact, buttons, lists, polls), query chats/contacts, manage groups, or configure webhooks. Calls the Evolution API REST endpoints directly.
Original author description
Manage WhatsApp instances and send messages via the Evolution API. Use when you need to list/create/connect instances, send messages (text, media, location, contact, buttons, lists, polls), query chats/contacts, manage groups, or configure webhooks. Calls the Evolution API REST endpoints directly.
How it works
- Setup (one-time)
- Instance Management
- Send Messages
- Chat Operations
- Contacts
- Group Operations
- Webhook Management
- Output
- Notes
SKILL.md preview
---
name: int-evolution-api
description: "Manage WhatsApp instances and send messages via the Evolution API. Use when you need to list/create/connect instances, send messages (text, media, location, contact, buttons, lists, polls), query chats/contacts, manage groups, or configure webhooks. Calls the Evolution API REST endpoints directly."
metadata:
openclaw:
requires:
env:
- EVOLUTION_API_URL
- EVOLUTION_API_KEY
bins:
- python3
primaryEnv: EVOLUTION_API_KEY
files:
- "scripts/*"
---
# Evolution API
Interact with your Evolution API instance to manage WhatsApp connections, send messages, query chats, manage groups, and configure webhooks.
## Setup (one-time)
1. Get your API URL and global API key from your Evolution API instance.
2. Set environment variables:
```
EVOLUTION_API_URL=https://api.evolution-api.com
EVOLUTION_API_KEY=your-global-api-key
```
## Instance Management
### List all instances
```bash
python3 scripts/evolution_api_client.py instances
```
### Create a new instance
```bash
python3 scripts/evolution_api_client.py create_instance my-instance
python3 scripts/evolution_api_client.py create_instance my-instance --qrcode
```
### Connect instance (returns QR code)
```bash
python3 scripts/evolution_api_client.py connect my-instance
```
### Get connection state
```bash
python3 scripts/evolution_api_client.py connection_state my-instance
```
### Restart an instance
```bash
python3 scripts/evolution_api_client.py restart my-instance
```
### Logout and disconnect
```bash
python3 scripts/evolution_api_client.py logout my-instance
```
### Delete an instance
```bash
python3 scripts/evolution_api_client.py delete_instance my-instance
```
### Set presence
```bash
python3 scripts/evolution_api_client.py set_presence my-instance --presence available
```
### Summary of all instances
```bash
python3 scripts/evolution_api_client.py summary
```
## Send Messages
### Send text
```bash
python3 scripts/evolution_api_client.py send_text my-instance 5511999999999 "Hello, world!"
```
### Send media (image, video, audio, document)
```bash
python3 scripts/evolution_api_client.py send_media my-instance 5511999999999 --type image --url https://example.com/photo.jpg --caption "Check this out"
```
### Send location
```bash
python3 scripts/evolution_api_client.py send_location my-instance 5511999999999 --lat -23.5505 --lng -46.6333 --name "Sao Paulo"
```
### Send contact card
```bash
python3 scripts/evolution_api_client.py send_contact my-instance 5511999999999 --name "John Doe" --phone 5511888888888
```
### Send buttons
```bash
python3 scripts/evolution_api_client.py send_buttons my-instance 5511999999999 --text "Choose an option" --buttons '[{"buttonId":"1","buttonText":{"displayText":"Option 1"}}]'
```
### Send list
```bash
python3 scripts/evolution_api_client.py send_list my-instance 5511999999999 --title "Menu" --sections '[{"title":"Section 1","rows":[{"title":"Item 1","rowId":"1"}]}]'
```
### Send poll
```bash
python3 scripts/evolution_api_client.py send_poll my-instance 5511999999999 --name "Favorite color?" --values "Red,Blue,Green"
```
### React to a message
```bash
python3 scripts/evolution_api_client.py send_reaction my-instance --key '{"remoteJid":"5511999999999@s.whatsapp.net","fromMe":false,"id":"MSG_ID"}' --reaction "👍"
```
### Send template message
```bash
python3 scripts/evolution_api_client.py send_template my-instance 5511999999999 "Template text here"
```
## Chat Operations
### Find chats
```bash
python3 scripts/evolution_api_client.py find_chats my-instance
python3 scripts/evolution_api_client.py find_chats my-instance --where '{"id":"5511999999999@s.whatsapp.net"}' --take 10
```
### Find messages
```bash
python3 scripts/evolution_api_client.py find_messages my-instance --where '{"key":{"remoteJid":"5511999999999@s.whatsapp.net"}}' --take 20
```
### Mark messages as read
```bash
python3 scripts/evolution_api_client.py mark_read my-instance --messages '[{"remoteJid":"5511999999999@s.whatsapp.net","fromMe":false,"id":"MSG_ID"}]'
```
### Archive/unarchive chat
```bash
python3 scripts/evolution_api_client.py archive_chat my-instance 5511999999999 --archive true
```
### Update profile name
```bash
python3 scripts/evolution_api_client.py update_profile_name my-instance "New Name"
```
### Update profile status
```bash
python3 scripts/evolution_api_client.py update_profile_status my-instance "Available for business"
```
## Contacts
### Find contacts
```bash
python3 scripts/evolution_api_client.py find_contacts my-instance --where '{"id":"5511999999999@s.whatsapp.net"}'
```
### Check numbers on WhatsApp
```bash
python3 scripts/evolution_api_client.py check_numbers my-instance --numbers 5511999999999,5511888888888
```
## Group Operations
### Create group
```bash
python3 scripts/evolution_api_client.py create_group my-instance --subject "My Group" --participants 5511999999999,5511888888888
```
### Get group info
```bash
python3 scripts/evolution_api_client.py group_info my-instance --jid 120363xxxxx@g.us
```
### List group participants
```bash
python3 scripts/evolution_api_client.py group_participants my-instance --jid 120363xxxxx@g.us
```
### Add/remove/promote/demote participants
```bash
python3 scripts/evolution_api_client.py update_participant my-instance --jid 120363xxxxx@g.us --action add --participants 5511999999999
```
## Webhook Management
### List webhooks
```bash
python3 scripts/evolution_api_client.py webhooks my-instance
```
### Set webhook
```bash
python3 scripts/evolution_api_client.py set_webhook my-instance --url https://example.com/hook --events messages.upsert,connection.update
```
### Delete webhook
```bash
python3 scripts/evolution_api_client.py delete_webhook my-instance
```
## Output
All output is JSON to stdout. Use `--json` flag for raw JSON on any command (default behavior).
## Notes
- Phone numbers use country code format without `+` (e.g. `5511999999999`).
- Group JIDs follow the pattern `120363...@g.us`.
- The `connect` endpoint returns a QR code as base64 PNG in the response.
- The `summary` command is composite: it calls `fetchInstances` then `connectionState` for each instance.
Files in this package (2)
- SKILL.md 6 KB
- scripts/evolution_api_client.py 21 KB
Versions
The database has no other skills named int-evolution-api.
Database snapshot: 13.11.2026 · package version 5ed94a14af3a (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100int-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.… - 100evolution-api
Operate the Evolution API (WhatsApp gateway) on a bento VPS — create WhatsApp instances, get the QR code to connect a phone, check connection state, send WhatsApp messages (text and media), configure webhooks, list or delete instances, and manage the full lifecycle of a WhatsApp… - 95whatsapp-business
WhatsApp Business API integration with managed OAuth. Send messages, manage templates, and handle conversations. Use this skill when users want to interact with WhatsApp Business. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). - 95moltflow
WhatsApp Business automation API for sessions, messaging, groups, labels, and webhooks. Use when: whatsapp, send message, create session, qr code, monitor group, label contacts, webhook. - 100int-evo-crm
Query and manage Evo AI CRM data via REST API. Use when you need to list/search contacts, conversations, messages, inboxes, pipelines (with stages and items), or labels. Supports filtering, pagination, creating/updating/deleting resources. Calls the CRM API directly with no third-party proxy. - 90whatsapp
Read and send messages in the connected WhatsApp number's chats and groups via the whatsapp CLI, and pair its linked device. Use when the user asks to send a WhatsApp message (to a person by name or number), reply or react in a chat or group, read a chat's history, fetch a file…