int-evolution-go

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