Agent skill

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.

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-api

Metadata

Additional technical details for this skill

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

SKILL.md

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.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

EvolutionAPI/evo-nexus

data-create-viz

Cria visualizações de dados de qualidade profissional com Python no tema Evolution (fundo escuro, acento

211 54
Explore
EvolutionAPI/evo-nexus

cs-customer-escalation

Empacota uma escalação para Devs, Produto ou Davidson com contexto completo. Use quando um bug precisa de atenção além do suporte normal, vários clientes reportam o mesmo problema, um cliente está ameaçando cancelar, ou um problema ficou sem resolução além do SLA. / Package an escalation for engineering, product, or leadership with full context. Use when a bug needs engineering attention beyond normal support, multiple customers report the same issue, a customer is threatening to churn, or an issue has sat unresolved past its SLA.

211 54
Explore
EvolutionAPI/evo-nexus

mkt-draft-content

Draft blog posts, social media, email newsletters, landing pages, press releases, and case studies with channel-specific formatting and SEO recommendations. Use when writing any marketing content, when you need headline or subject line options, or when adapting a message for a specific platform, audience, and brand voice.

211 54
Explore
EvolutionAPI/evo-nexus

gog-tasks

Create, manage, and prioritize tasks and todo items. Convert emails to tasks, set priorities (P0-P3) and categories (Work/Personal/Errands/Admin), review daily priorities, track blocked and overdue tasks. Use when user mentions tasks, todos, action items, or wants to convert emails to tasks. Requires confirmation before creating or deleting tasks.

211 54
Explore
EvolutionAPI/evo-nexus

discord-get-messages

Retrieve messages from Discord channels via the Discord API. Use this skill when the user wants to read, search, or analyze messages from a Discord channel.

211 54
Explore
EvolutionAPI/evo-nexus

cs-customer-research

Pesquisa multi-fonte sobre pergunta ou tópico de cliente com atribuição de fontes. Use quando um cliente pergunta algo que precisa ser verificado, investigando se um bug foi reportado antes, verificando o que foi dito anteriormente a uma conta específica, ou coletando contexto antes de redigir uma resposta. / Multi-source research on a customer question or topic with source attribution. Use when a customer asks something you need to look up, investigating whether a bug has been reported before, checking what was previously told to a specific account, or gathering background before drafting a response.

211 54
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results