{ "schemaVersion": "1.0", "item": { "slug": "evogo", "name": "Evolution Api Go - Evo Go", "source": "tencent", "type": "skill", "category": "ๅผ€ๅ‘ๅทฅๅ…ท", "sourceUrl": "https://clawhub.ai/impa365/evogo", "canonicalUrl": "https://clawhub.ai/impa365/evogo", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/evogo", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=evogo", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/evogo" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/evogo", "agentPageUrl": "https://openagent3.xyz/skills/evogo/agent", "manifestUrl": "https://openagent3.xyz/skills/evogo/agent.json", "briefUrl": "https://openagent3.xyz/skills/evogo/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "evoGo - Evolution API Go v3", "body": "Complete WhatsApp automation via Evolution API Go v3. Send messages, manage groups, automate conversations, and integrate webhooks." }, { "title": "1. Set Environment Variables", "body": "{\n env: {\n EVOGO_API_URL: \"http://localhost:8080\", // Your API URL\n EVOGO_GLOBAL_KEY: \"your-global-admin-key\", // Admin key (instance mgmt)\n EVOGO_INSTANCE: \"my-bot\", // Instance name\n EVOGO_API_KEY: \"your-instance-token\" // Instance token (messaging)\n }\n}" }, { "title": "2. Create Instance & Connect", "body": "# Create instance\ncurl -X POST \"$EVOGO_API_URL/instance/create\" \\\n -H \"apikey: $EVOGO_GLOBAL_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"my-bot\",\n \"token\": \"my-secret-token\",\n \"qrcode\": true\n }'\n\n# Connect & get QR code\ncurl -X POST \"$EVOGO_API_URL/instance/connect\" \\\n -H \"apikey: $EVOGO_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"number\": \"\"}'\n\nScan the QR code returned in qrcode.base64." }, { "title": "3. Send First Message", "body": "curl -X POST \"$EVOGO_API_URL/send/text\" \\\n -H \"apikey: $EVOGO_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"number\": \"5511999999999\",\n \"text\": \"Hello from evoGo! ๐Ÿš€\"\n }'" }, { "title": "๐Ÿ” Authentication", "body": "Two authentication levels:\n\nTypeHeaderUsageGlobal API Keyapikey: xxxAdmin: create/delete instances, logsInstance Tokenapikey: xxxMessaging: send messages, groups, contacts\n\nSet via environment or pass directly in headers." }, { "title": "Phone Number Formats", "body": "ContextFormatExampleSending messagesInternational (no +)5511999999999Group participantsJID format5511999999999@s.whatsapp.netGroupsGroup JID120363123456789012@g.usNewslettersNewsletter JID120363123456789012@newsletter" }, { "title": "Message Delay", "body": "Add delay (milliseconds) to avoid rate limits:\n\n{\n \"number\": \"5511999999999\",\n \"text\": \"Message with delay\",\n \"delay\": 2000\n}" }, { "title": "๐Ÿ“ฑ Instance Management", "body": "Create Instance\n\nPOST /instance/create\nHeader: apikey: $EVOGO_GLOBAL_KEY\n\n{\n \"name\": \"bot-name\",\n \"token\": \"secret-token\",\n \"qrcode\": true,\n \"advancedSettings\": {\n \"rejectCalls\": false,\n \"groupsIgnore\": false,\n \"alwaysOnline\": true,\n \"readMessages\": true,\n \"readStatus\": true,\n \"syncFullHistory\": true\n }\n}\n\nAdvanced Settings:\n\nrejectCalls - Auto-reject calls\ngroupsIgnore - Ignore group messages\nalwaysOnline - Stay online always\nreadMessages - Auto-mark messages as read\nreadStatus - Auto-mark status as viewed\nsyncFullHistory - Sync full chat history\n\nConnect / Get QR Code\n\nPOST /instance/connect\nGET /instance/qr\nHeader: apikey: $EVOGO_API_KEY\n\n{\"number\": \"\"} # Leave empty for QR, or phone number for pairing\n\nConnection Status\n\nGET /instance/status\nHeader: apikey: $EVOGO_API_KEY\n\nReturns: connected, connecting, disconnected\n\nList All Instances\n\nGET /instance/all\nHeader: apikey: $EVOGO_GLOBAL_KEY\n\nDelete Instance\n\nDELETE /instance/delete/{instance}\nHeader: apikey: $EVOGO_GLOBAL_KEY\n\nForce Reconnect\n\nPOST /instance/forcereconnect/{instance}\nHeader: apikey: $EVOGO_GLOBAL_KEY\n\n{\"number\": \"5511999999999\"}\n\nLogs\n\nGET /instance/logs/{instance}?start_date=2026-01-01&end_date=2026-02-10&level=info&limit=100\nHeader: apikey: $EVOGO_GLOBAL_KEY\n\nLog levels: info, warn, error, debug" }, { "title": "๐Ÿ’ฌ Send Messages", "body": "Text Message\n\nPOST /send/text\n\n{\n \"number\": \"5511999999999\",\n \"text\": \"Hello World!\",\n \"delay\": 1000,\n \"mentionsEveryOne\": false,\n \"mentioned\": [\"5511888888888@s.whatsapp.net\"]\n}\n\nMedia (URL)\n\nPOST /send/media\n\n{\n \"number\": \"5511999999999\",\n \"url\": \"https://example.com/photo.jpg\",\n \"type\": \"image\",\n \"caption\": \"Check this out!\",\n \"filename\": \"photo.jpg\"\n}\n\nMedia types:\n\nimage - JPG, PNG, GIF, WEBP\nvideo - MP4, AVI, MOV, MKV\naudio - MP3, OGG, WAV (sent as voice note/PTT)\ndocument - PDF, DOC, DOCX, XLS, XLSX, PPT, TXT, ZIP\nptv - Round video (Instagram-style)\n\nMedia (File Upload)\n\nPOST /send/media\nContent-Type: multipart/form-data\n\nnumber=5511999999999\ntype=image\nfile=@/path/to/file.jpg\ncaption=Photo caption\nfilename=custom-name.jpg\n\nPoll\n\nPOST /send/poll\n\n{\n \"number\": \"5511999999999\",\n \"question\": \"Best language?\",\n \"options\": [\"JavaScript\", \"Python\", \"Go\", \"Rust\"],\n \"selectableCount\": 1\n}\n\nGet poll results:\n\nGET /polls/{messageId}/results\n\nSticker\n\nPOST /send/sticker\n\n{\n \"number\": \"5511999999999\",\n \"sticker\": \"https://example.com/sticker.webp\"\n}\n\nAuto-converts images to WebP format.\n\nLocation\n\nPOST /send/location\n\n{\n \"number\": \"5511999999999\",\n \"latitude\": -23.550520,\n \"longitude\": -46.633308,\n \"name\": \"Avenida Paulista\",\n \"address\": \"Av. Paulista, Sรฃo Paulo - SP\"\n}\n\nContact\n\nPOST /send/contact\n\n{\n \"number\": \"5511999999999\",\n \"vcard\": {\n \"fullName\": \"Joรฃo Silva\",\n \"phone\": \"5511988888888\",\n \"organization\": \"Company XYZ\",\n \"email\": \"joao@example.com\"\n }\n}\n\nCarousel\n\nPOST /send/carousel\n\n{\n \"number\": \"5511999999999\",\n \"body\": \"Main carousel text\",\n \"footer\": \"Footer text\",\n \"cards\": [\n {\n \"header\": {\n \"title\": \"Card 1\",\n \"subtitle\": \"Subtitle\",\n \"imageUrl\": \"https://example.com/img1.jpg\"\n },\n \"body\": {\"text\": \"Card description\"},\n \"footer\": \"Card footer\",\n \"buttons\": [\n {\n \"displayText\": \"Click Me\",\n \"id\": \"btn1\",\n \"type\": \"REPLY\"\n }\n ]\n }\n ]\n}\n\nButton types:\n\nREPLY - Simple reply\nURL - Opens link\nCALL - Initiates call\nCOPY - Copies text" }, { "title": "๐Ÿ“จ Message Operations", "body": "React to Message\n\nPOST /message/react\n\n{\n \"number\": \"5511999999999\",\n \"reaction\": \"๐Ÿ‘\",\n \"id\": \"MESSAGE_ID\",\n \"fromMe\": false,\n \"participant\": \"5511888888888@s.whatsapp.net\" # Required in groups\n}\n\nReactions: ๐Ÿ‘, โค๏ธ, ๐Ÿ˜‚, ๐Ÿ˜ฎ, ๐Ÿ˜ข, ๐Ÿ™, or \"remove\"\n\nTyping/Recording Indicator\n\nPOST /message/presence\n\n{\n \"number\": \"5511999999999\",\n \"state\": \"composing\",\n \"isAudio\": false\n}\n\nStates:\n\ncomposing + isAudio: false โ†’ \"typing...\"\ncomposing + isAudio: true โ†’ \"recording audio...\"\npaused โ†’ Stops indicator\n\nMark as Read\n\nPOST /message/markread\n\n{\n \"number\": \"5511999999999\",\n \"id\": [\"MESSAGE_ID_1\", \"MESSAGE_ID_2\"]\n}\n\nDownload Media\n\nPOST /message/downloadmedia\n\n{\n \"message\": {} # Full message object from webhook\n}\n\nReturns base64-encoded media.\n\nEdit Message\n\nPOST /message/edit\n\n{\n \"chat\": \"5511999999999@s.whatsapp.net\",\n \"messageId\": \"MESSAGE_ID\",\n \"message\": \"Edited text\"\n}\n\nLimitations:\n\nText messages only\nYour messages only\n~15 minute time limit\n\nDelete Message\n\nPOST /message/delete\n\n{\n \"chat\": \"5511999999999@s.whatsapp.net\",\n \"messageId\": \"MESSAGE_ID\"\n}\n\nLimitations:\n\nYour messages only\n~48 hour time limit\n\nGet Message Status\n\nPOST /message/status\n\n{\n \"id\": \"MESSAGE_ID\"\n}\n\nReturns delivery/read status." }, { "title": "๐Ÿ‘ฅ Group Management", "body": "List Groups\n\nGET /group/list # Basic info (JID + name)\nGET /group/myall # Full info (participants, settings, etc)\n\nGet Group Info\n\nPOST /group/info\n\n{\n \"groupJid\": \"120363123456789012@g.us\"\n}\n\nCreate Group\n\nPOST /group/create\n\n{\n \"groupName\": \"My Team\",\n \"participants\": [\n \"5511999999999@s.whatsapp.net\",\n \"5511888888888@s.whatsapp.net\"\n ]\n}\n\nRequirements:\n\nName: max 25 characters\nParticipants: minimum 1\n\nManage Participants\n\nPOST /group/participant\n\n{\n \"groupJid\": \"120363123456789012@g.us\",\n \"action\": \"add\",\n \"participants\": [\"5511999999999@s.whatsapp.net\"]\n}\n\nActions:\n\nadd - Add members\nremove - Remove members\npromote - Make admin\ndemote - Remove admin\n\nUpdate Group Settings\n\nPOST /group/settings\n\n{\n \"groupJid\": \"120363123456789012@g.us\",\n \"action\": \"announcement\"\n}\n\nSettings:\n\nannouncement / not_announcement - Only admins send messages\nlocked / unlocked - Only admins edit group info\napproval_on / approval_off - Require approval to join\nadmin_add / all_member_add - Who can add members\n\nGet Invite Link\n\nPOST /group/invitelink\n\n{\n \"groupJid\": \"120363123456789012@g.us\",\n \"reset\": false\n}\n\nSet reset: true to revoke old link and generate new one.\n\nJoin Group\n\nPOST /group/join\n\n{\n \"code\": \"https://chat.whatsapp.com/XXXXXX\"\n}\n\nAccepts full link or just the code.\n\nLeave Group\n\nPOST /group/leave\n\n{\n \"groupJid\": \"120363123456789012@g.us\"\n}\n\nManage Join Requests\n\n# Get pending requests\nPOST /group/requests\n{\n \"groupJid\": \"120363123456789012@g.us\"\n}\n\n# Approve/Reject\nPOST /group/requests/action\n{\n \"groupJid\": \"120363123456789012@g.us\",\n \"action\": \"approve\",\n \"participants\": [\"5511999999999@s.whatsapp.net\"]\n}\n\nActions: approve, reject\n\nUpdate Group Metadata\n\n# Set photo\nPOST /group/photo\n{\n \"groupJid\": \"120363123456789012@g.us\",\n \"image\": \"https://example.com/photo.jpg\"\n}\n\n# Set name\nPOST /group/name\n{\n \"groupJid\": \"120363123456789012@g.us\",\n \"name\": \"New Group Name\"\n}\n\n# Set description\nPOST /group/description\n{\n \"groupJid\": \"120363123456789012@g.us\",\n \"description\": \"New description\"\n}" }, { "title": "๐Ÿ’ฌ Chat Management", "body": "Pin/Unpin Chat\n\nPOST /chat/pin\nPOST /chat/unpin\n\n{\n \"chat\": \"5511999999999@s.whatsapp.net\"\n}\n\nArchive/Unarchive Chat\n\nPOST /chat/archive\nPOST /chat/unarchive\n\n{\n \"chat\": \"5511999999999@s.whatsapp.net\"\n}\n\nMute/Unmute Chat\n\nPOST /chat/mute\nPOST /chat/unmute\n\n{\n \"chat\": \"5511999999999@s.whatsapp.net\"\n}\n\nSync History\n\nPOST /chat/history-sync-request\n\nRequests full chat history sync (may take time)." }, { "title": "๐Ÿ‘ค User & Profile", "body": "Get User Info\n\nPOST /user/info\n\n{\n \"number\": [\"5511999999999\", \"5511888888888\"],\n \"formatJid\": true\n}\n\nReturns: status, profile photo, verified badge, linked devices, etc.\n\nCheck WhatsApp Registration\n\nPOST /user/check\n\n{\n \"number\": [\"5511999999999\", \"5511888888888\"]\n}\n\nReturns: isInWhatsapp (true/false) for each number.\n\nGet Profile Picture\n\nPOST /user/avatar\n\n{\n \"number\": \"5511999999999\",\n \"preview\": false\n}\n\nPreview options:\n\nfalse - Full resolution\ntrue - Low resolution preview\n\nGet Contacts\n\nGET /user/contacts\n\nLists all saved contacts.\n\nPrivacy Settings\n\n# Get privacy settings\nGET /user/privacy\n\n# Set privacy settings\nPOST /user/privacy\n{\n \"groupAdd\": \"all\",\n \"lastSeen\": \"contacts\",\n \"status\": \"all\",\n \"profile\": \"all\",\n \"readReceipts\": \"all\",\n \"callAdd\": \"all\",\n \"online\": \"match_last_seen\"\n}\n\nOptions: all, contacts, contact_blacklist, none, match_last_seen (online only)\n\nBlock/Unblock Contact\n\nPOST /user/block\nPOST /user/unblock\n\n{\n \"number\": \"5511999999999\"\n}\n\n# Get block list\nGET /user/blocklist\n\nUpdate Profile\n\n# Set profile picture\nPOST /user/profilePicture\n{\n \"image\": \"https://example.com/photo.jpg\"\n}\n\n# Set profile name\nPOST /user/profileName\n{\n \"name\": \"My Name\"\n}\n\n# Set status/about\nPOST /user/profileStatus\n{\n \"status\": \"My custom status\"\n}\n\nLimits:\n\nName: 25 characters max\nStatus: 139 characters max" }, { "title": "๐Ÿท๏ธ Labels (Tags)", "body": "Add Label\n\n# To chat\nPOST /label/chat\n{\n \"jid\": \"5511999999999@s.whatsapp.net\",\n \"labelId\": \"1\"\n}\n\n# To message\nPOST /label/message\n{\n \"jid\": \"5511999999999@s.whatsapp.net\",\n \"labelId\": \"1\",\n \"messageId\": \"MESSAGE_ID\"\n}\n\nRemove Label\n\nPOST /unlabel/chat\nPOST /unlabel/message\n\n{\n \"jid\": \"5511999999999@s.whatsapp.net\",\n \"labelId\": \"1\",\n \"messageId\": \"MESSAGE_ID\" # Only for /unlabel/message\n}\n\nEdit Label\n\nPOST /label/edit\n\n{\n \"labelId\": \"1\",\n \"name\": \"New Label Name\"\n}\n\nList Labels\n\nGET /label" }, { "title": "๐Ÿ˜๏ธ Communities", "body": "Create Community\n\nPOST /community/create\n\n{\n \"communityName\": \"My Community\",\n \"description\": \"Optional description\"\n}\n\nAdd/Remove Groups\n\nPOST /community/add\n{\n \"communityJID\": \"120363123456789012@g.us\",\n \"groupJID\": [\"120363111111111111@g.us\"]\n}\n\nPOST /community/remove\n{\n \"communityJID\": \"120363123456789012@g.us\",\n \"groupJID\": [\"120363111111111111@g.us\"]\n}" }, { "title": "๐Ÿ“ข Newsletters (Channels)", "body": "Create Newsletter\n\nPOST /newsletter/create\n\n{\n \"name\": \"My Channel\",\n \"description\": \"Optional description\"\n}\n\nList Newsletters\n\nGET /newsletter/list\n\nGet Newsletter Info\n\nPOST /newsletter/info\n\n{\n \"jid\": \"120363123456789012@newsletter\"\n}\n\nSubscribe\n\nPOST /newsletter/subscribe\n\n{\n \"jid\": \"120363123456789012@newsletter\"\n}\n\nGet Newsletter Messages\n\nPOST /newsletter/messages\n\n{\n \"jid\": \"120363123456789012@newsletter\",\n \"limit\": 50\n}\n\nGet Invite Link Info\n\nPOST /newsletter/link\n\n{\n \"key\": \"INVITE_KEY\"\n}" }, { "title": "๐Ÿ“ž Call Management", "body": "Reject Call\n\nPOST /call/reject\n\n# Webhook payload from call event\n\nUse with webhook automation to auto-reject calls." }, { "title": "Broadcast Message to Multiple Contacts", "body": "for number in 5511999999999 5511888888888 5511777777777; do\n curl -X POST \"$EVOGO_API_URL/send/text\" \\\n -H \"apikey: $EVOGO_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"{\n \\\"number\\\": \\\"$number\\\",\n \\\"text\\\": \\\"Broadcast message\\\",\n \\\"delay\\\": 2000\n }\"\ndone" }, { "title": "Send Image with Mentions (Groups)", "body": "curl -X POST \"$EVOGO_API_URL/send/media\" \\\n -H \"apikey: $EVOGO_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"number\": \"120363123456789012@g.us\",\n \"url\": \"https://example.com/report.jpg\",\n \"type\": \"image\",\n \"caption\": \"Report ready! @5511999999999 please review\",\n \"mentionedJid\": [\"5511999999999@s.whatsapp.net\"]\n }'" }, { "title": "Auto-Create Group + Welcome Message", "body": "# 1. Create group\nGROUP_JID=$(curl -s -X POST \"$EVOGO_API_URL/group/create\" \\\n -H \"apikey: $EVOGO_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"groupName\": \"Team Alpha\",\n \"participants\": [\"5511999999999@s.whatsapp.net\"]\n }' | jq -r '.groupJid')\n\n# 2. Send welcome message\ncurl -X POST \"$EVOGO_API_URL/send/text\" \\\n -H \"apikey: $EVOGO_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"{\n \\\"number\\\": \\\"$GROUP_JID\\\",\n \\\"text\\\": \\\"Welcome to Team Alpha! ๐ŸŽ‰\\\"\n }\"" }, { "title": "Check Multiple Numbers", "body": "curl -X POST \"$EVOGO_API_URL/user/check\" \\\n -H \"apikey: $EVOGO_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"number\": [\n \"5511999999999\",\n \"5511888888888\",\n \"5511777777777\"\n ]\n }'" }, { "title": "Delays", "body": "Always add delays between messages:\n\n{\"delay\": 2000} // 2 seconds\n\nRecommended:\n\n1-2 seconds between individual messages\n3-5 seconds between mass sends\nExponential backoff on errors" }, { "title": "Error Handling", "body": "HTTP Status Codes:\n\n200 - Success\n400 - Bad request (check parameters)\n401 - Unauthorized (check API key)\n404 - Not found (instance/resource doesn't exist)\n500 - Server error\n\nCommon Issues:\n\nErrorSolutionInstance not connectedRun POST /instance/connectInvalid phone formatUse international without +: 5511999999999Message not sentCheck GET /instance/statusGroup operation failedVerify you're admin (for admin operations)" }, { "title": "๐Ÿ”— Webhooks", "body": "Configure webhooks to receive real-time events:\n\nMessage received\nMessage sent\nConnection status\nGroup updates\nCalls received\nAnd more...\n\nUse POST /webhook/set endpoint to configure webhook URL (see Postman collection for details)." }, { "title": "Instance Won't Connect", "body": "# 1. Check if instance exists\nGET /instance/all\n\n# 2. Force reconnect\nPOST /instance/forcereconnect/{instance}\n\n# 3. Check logs\nGET /instance/logs/{instance}?level=error" }, { "title": "Messages Not Sending", "body": "Verify connection: GET /instance/status\nCheck phone format (no + or spaces)\nEnsure recipient has WhatsApp\nVerify API key is correct" }, { "title": "Group Operations Failing", "body": "Check you're admin (for admin operations)\nVerify group JID format: xxxxx@g.us\nEnsure participants use format: number@s.whatsapp.net" }, { "title": "๐Ÿ“š Resources", "body": "Evolution API Go: https://github.com/EvolutionAPI/evolution-api\nWhatsApp Business API: https://developers.facebook.com/docs/whatsapp\nJID Format Guide: number@s.whatsapp.net for users, xxxxx@g.us for groups" }, { "title": "๐Ÿ†• Known Limitations", "body": "Not Working (v3.0):\n\n/send/button - Interactive buttons (deprecated by WhatsApp)\n/send/list - Interactive lists (deprecated by WhatsApp)\n\nThese endpoints exist but are non-functional due to WhatsApp API changes." }, { "title": "๐Ÿ’ก Tips", "body": "Always check status before operations\nUse delays to avoid rate limits (1-2s minimum)\nStore tokens securely in environment variables\nHandle disconnects with automatic reconnection\nValidate numbers before sending\nUse webhooks for real-time event handling\nMonitor logs for troubleshooting\nTest with small groups before mass operations\n\nevoGo simplifies WhatsApp automation with Evolution API Go v3. For advanced features, check the full Postman collection or API documentation." } ], "body": "evoGo - Evolution API Go v3\n\nComplete WhatsApp automation via Evolution API Go v3. Send messages, manage groups, automate conversations, and integrate webhooks.\n\n๐Ÿš€ Quick Start\n1. Set Environment Variables\n{\n env: {\n EVOGO_API_URL: \"http://localhost:8080\", // Your API URL\n EVOGO_GLOBAL_KEY: \"your-global-admin-key\", // Admin key (instance mgmt)\n EVOGO_INSTANCE: \"my-bot\", // Instance name\n EVOGO_API_KEY: \"your-instance-token\" // Instance token (messaging)\n }\n}\n\n2. Create Instance & Connect\n# Create instance\ncurl -X POST \"$EVOGO_API_URL/instance/create\" \\\n -H \"apikey: $EVOGO_GLOBAL_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"my-bot\",\n \"token\": \"my-secret-token\",\n \"qrcode\": true\n }'\n\n# Connect & get QR code\ncurl -X POST \"$EVOGO_API_URL/instance/connect\" \\\n -H \"apikey: $EVOGO_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"number\": \"\"}'\n\n\nScan the QR code returned in qrcode.base64.\n\n3. Send First Message\ncurl -X POST \"$EVOGO_API_URL/send/text\" \\\n -H \"apikey: $EVOGO_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"number\": \"5511999999999\",\n \"text\": \"Hello from evoGo! ๐Ÿš€\"\n }'\n\n๐Ÿ” Authentication\n\nTwo authentication levels:\n\nType\tHeader\tUsage\nGlobal API Key\tapikey: xxx\tAdmin: create/delete instances, logs\nInstance Token\tapikey: xxx\tMessaging: send messages, groups, contacts\n\nSet via environment or pass directly in headers.\n\n๐Ÿ“ฆ Core Concepts\nPhone Number Formats\nContext\tFormat\tExample\nSending messages\tInternational (no +)\t5511999999999\nGroup participants\tJID format\t5511999999999@s.whatsapp.net\nGroups\tGroup JID\t120363123456789012@g.us\nNewsletters\tNewsletter JID\t120363123456789012@newsletter\nMessage Delay\n\nAdd delay (milliseconds) to avoid rate limits:\n\n{\n \"number\": \"5511999999999\",\n \"text\": \"Message with delay\",\n \"delay\": 2000\n}\n\n๐ŸŽฏ Feature Reference\n๐Ÿ“ฑ Instance Management\nCreate Instance\nPOST /instance/create\nHeader: apikey: $EVOGO_GLOBAL_KEY\n\n{\n \"name\": \"bot-name\",\n \"token\": \"secret-token\",\n \"qrcode\": true,\n \"advancedSettings\": {\n \"rejectCalls\": false,\n \"groupsIgnore\": false,\n \"alwaysOnline\": true,\n \"readMessages\": true,\n \"readStatus\": true,\n \"syncFullHistory\": true\n }\n}\n\n\nAdvanced Settings:\n\nrejectCalls - Auto-reject calls\ngroupsIgnore - Ignore group messages\nalwaysOnline - Stay online always\nreadMessages - Auto-mark messages as read\nreadStatus - Auto-mark status as viewed\nsyncFullHistory - Sync full chat history\nConnect / Get QR Code\nPOST /instance/connect\nGET /instance/qr\nHeader: apikey: $EVOGO_API_KEY\n\n{\"number\": \"\"} # Leave empty for QR, or phone number for pairing\n\nConnection Status\nGET /instance/status\nHeader: apikey: $EVOGO_API_KEY\n\n\nReturns: connected, connecting, disconnected\n\nList All Instances\nGET /instance/all\nHeader: apikey: $EVOGO_GLOBAL_KEY\n\nDelete Instance\nDELETE /instance/delete/{instance}\nHeader: apikey: $EVOGO_GLOBAL_KEY\n\nForce Reconnect\nPOST /instance/forcereconnect/{instance}\nHeader: apikey: $EVOGO_GLOBAL_KEY\n\n{\"number\": \"5511999999999\"}\n\nLogs\nGET /instance/logs/{instance}?start_date=2026-01-01&end_date=2026-02-10&level=info&limit=100\nHeader: apikey: $EVOGO_GLOBAL_KEY\n\n\nLog levels: info, warn, error, debug\n\n๐Ÿ’ฌ Send Messages\nText Message\nPOST /send/text\n\n{\n \"number\": \"5511999999999\",\n \"text\": \"Hello World!\",\n \"delay\": 1000,\n \"mentionsEveryOne\": false,\n \"mentioned\": [\"5511888888888@s.whatsapp.net\"]\n}\n\nMedia (URL)\nPOST /send/media\n\n{\n \"number\": \"5511999999999\",\n \"url\": \"https://example.com/photo.jpg\",\n \"type\": \"image\",\n \"caption\": \"Check this out!\",\n \"filename\": \"photo.jpg\"\n}\n\n\nMedia types:\n\nimage - JPG, PNG, GIF, WEBP\nvideo - MP4, AVI, MOV, MKV\naudio - MP3, OGG, WAV (sent as voice note/PTT)\ndocument - PDF, DOC, DOCX, XLS, XLSX, PPT, TXT, ZIP\nptv - Round video (Instagram-style)\nMedia (File Upload)\nPOST /send/media\nContent-Type: multipart/form-data\n\nnumber=5511999999999\ntype=image\nfile=@/path/to/file.jpg\ncaption=Photo caption\nfilename=custom-name.jpg\n\nPoll\nPOST /send/poll\n\n{\n \"number\": \"5511999999999\",\n \"question\": \"Best language?\",\n \"options\": [\"JavaScript\", \"Python\", \"Go\", \"Rust\"],\n \"selectableCount\": 1\n}\n\n\nGet poll results:\n\nGET /polls/{messageId}/results\n\nSticker\nPOST /send/sticker\n\n{\n \"number\": \"5511999999999\",\n \"sticker\": \"https://example.com/sticker.webp\"\n}\n\n\nAuto-converts images to WebP format.\n\nLocation\nPOST /send/location\n\n{\n \"number\": \"5511999999999\",\n \"latitude\": -23.550520,\n \"longitude\": -46.633308,\n \"name\": \"Avenida Paulista\",\n \"address\": \"Av. Paulista, Sรฃo Paulo - SP\"\n}\n\nContact\nPOST /send/contact\n\n{\n \"number\": \"5511999999999\",\n \"vcard\": {\n \"fullName\": \"Joรฃo Silva\",\n \"phone\": \"5511988888888\",\n \"organization\": \"Company XYZ\",\n \"email\": \"joao@example.com\"\n }\n}\n\nCarousel\nPOST /send/carousel\n\n{\n \"number\": \"5511999999999\",\n \"body\": \"Main carousel text\",\n \"footer\": \"Footer text\",\n \"cards\": [\n {\n \"header\": {\n \"title\": \"Card 1\",\n \"subtitle\": \"Subtitle\",\n \"imageUrl\": \"https://example.com/img1.jpg\"\n },\n \"body\": {\"text\": \"Card description\"},\n \"footer\": \"Card footer\",\n \"buttons\": [\n {\n \"displayText\": \"Click Me\",\n \"id\": \"btn1\",\n \"type\": \"REPLY\"\n }\n ]\n }\n ]\n}\n\n\nButton types:\n\nREPLY - Simple reply\nURL - Opens link\nCALL - Initiates call\nCOPY - Copies text\n๐Ÿ“จ Message Operations\nReact to Message\nPOST /message/react\n\n{\n \"number\": \"5511999999999\",\n \"reaction\": \"๐Ÿ‘\",\n \"id\": \"MESSAGE_ID\",\n \"fromMe\": false,\n \"participant\": \"5511888888888@s.whatsapp.net\" # Required in groups\n}\n\n\nReactions: ๐Ÿ‘, โค๏ธ, ๐Ÿ˜‚, ๐Ÿ˜ฎ, ๐Ÿ˜ข, ๐Ÿ™, or \"remove\"\n\nTyping/Recording Indicator\nPOST /message/presence\n\n{\n \"number\": \"5511999999999\",\n \"state\": \"composing\",\n \"isAudio\": false\n}\n\n\nStates:\n\ncomposing + isAudio: false โ†’ \"typing...\"\ncomposing + isAudio: true โ†’ \"recording audio...\"\npaused โ†’ Stops indicator\nMark as Read\nPOST /message/markread\n\n{\n \"number\": \"5511999999999\",\n \"id\": [\"MESSAGE_ID_1\", \"MESSAGE_ID_2\"]\n}\n\nDownload Media\nPOST /message/downloadmedia\n\n{\n \"message\": {} # Full message object from webhook\n}\n\n\nReturns base64-encoded media.\n\nEdit Message\nPOST /message/edit\n\n{\n \"chat\": \"5511999999999@s.whatsapp.net\",\n \"messageId\": \"MESSAGE_ID\",\n \"message\": \"Edited text\"\n}\n\n\nLimitations:\n\nText messages only\nYour messages only\n~15 minute time limit\nDelete Message\nPOST /message/delete\n\n{\n \"chat\": \"5511999999999@s.whatsapp.net\",\n \"messageId\": \"MESSAGE_ID\"\n}\n\n\nLimitations:\n\nYour messages only\n~48 hour time limit\nGet Message Status\nPOST /message/status\n\n{\n \"id\": \"MESSAGE_ID\"\n}\n\n\nReturns delivery/read status.\n\n๐Ÿ‘ฅ Group Management\nList Groups\nGET /group/list # Basic info (JID + name)\nGET /group/myall # Full info (participants, settings, etc)\n\nGet Group Info\nPOST /group/info\n\n{\n \"groupJid\": \"120363123456789012@g.us\"\n}\n\nCreate Group\nPOST /group/create\n\n{\n \"groupName\": \"My Team\",\n \"participants\": [\n \"5511999999999@s.whatsapp.net\",\n \"5511888888888@s.whatsapp.net\"\n ]\n}\n\n\nRequirements:\n\nName: max 25 characters\nParticipants: minimum 1\nManage Participants\nPOST /group/participant\n\n{\n \"groupJid\": \"120363123456789012@g.us\",\n \"action\": \"add\",\n \"participants\": [\"5511999999999@s.whatsapp.net\"]\n}\n\n\nActions:\n\nadd - Add members\nremove - Remove members\npromote - Make admin\ndemote - Remove admin\nUpdate Group Settings\nPOST /group/settings\n\n{\n \"groupJid\": \"120363123456789012@g.us\",\n \"action\": \"announcement\"\n}\n\n\nSettings:\n\nannouncement / not_announcement - Only admins send messages\nlocked / unlocked - Only admins edit group info\napproval_on / approval_off - Require approval to join\nadmin_add / all_member_add - Who can add members\nGet Invite Link\nPOST /group/invitelink\n\n{\n \"groupJid\": \"120363123456789012@g.us\",\n \"reset\": false\n}\n\n\nSet reset: true to revoke old link and generate new one.\n\nJoin Group\nPOST /group/join\n\n{\n \"code\": \"https://chat.whatsapp.com/XXXXXX\"\n}\n\n\nAccepts full link or just the code.\n\nLeave Group\nPOST /group/leave\n\n{\n \"groupJid\": \"120363123456789012@g.us\"\n}\n\nManage Join Requests\n# Get pending requests\nPOST /group/requests\n{\n \"groupJid\": \"120363123456789012@g.us\"\n}\n\n# Approve/Reject\nPOST /group/requests/action\n{\n \"groupJid\": \"120363123456789012@g.us\",\n \"action\": \"approve\",\n \"participants\": [\"5511999999999@s.whatsapp.net\"]\n}\n\n\nActions: approve, reject\n\nUpdate Group Metadata\n# Set photo\nPOST /group/photo\n{\n \"groupJid\": \"120363123456789012@g.us\",\n \"image\": \"https://example.com/photo.jpg\"\n}\n\n# Set name\nPOST /group/name\n{\n \"groupJid\": \"120363123456789012@g.us\",\n \"name\": \"New Group Name\"\n}\n\n# Set description\nPOST /group/description\n{\n \"groupJid\": \"120363123456789012@g.us\",\n \"description\": \"New description\"\n}\n\n๐Ÿ’ฌ Chat Management\nPin/Unpin Chat\nPOST /chat/pin\nPOST /chat/unpin\n\n{\n \"chat\": \"5511999999999@s.whatsapp.net\"\n}\n\nArchive/Unarchive Chat\nPOST /chat/archive\nPOST /chat/unarchive\n\n{\n \"chat\": \"5511999999999@s.whatsapp.net\"\n}\n\nMute/Unmute Chat\nPOST /chat/mute\nPOST /chat/unmute\n\n{\n \"chat\": \"5511999999999@s.whatsapp.net\"\n}\n\nSync History\nPOST /chat/history-sync-request\n\n\nRequests full chat history sync (may take time).\n\n๐Ÿ‘ค User & Profile\nGet User Info\nPOST /user/info\n\n{\n \"number\": [\"5511999999999\", \"5511888888888\"],\n \"formatJid\": true\n}\n\n\nReturns: status, profile photo, verified badge, linked devices, etc.\n\nCheck WhatsApp Registration\nPOST /user/check\n\n{\n \"number\": [\"5511999999999\", \"5511888888888\"]\n}\n\n\nReturns: isInWhatsapp (true/false) for each number.\n\nGet Profile Picture\nPOST /user/avatar\n\n{\n \"number\": \"5511999999999\",\n \"preview\": false\n}\n\n\nPreview options:\n\nfalse - Full resolution\ntrue - Low resolution preview\nGet Contacts\nGET /user/contacts\n\n\nLists all saved contacts.\n\nPrivacy Settings\n# Get privacy settings\nGET /user/privacy\n\n# Set privacy settings\nPOST /user/privacy\n{\n \"groupAdd\": \"all\",\n \"lastSeen\": \"contacts\",\n \"status\": \"all\",\n \"profile\": \"all\",\n \"readReceipts\": \"all\",\n \"callAdd\": \"all\",\n \"online\": \"match_last_seen\"\n}\n\n\nOptions: all, contacts, contact_blacklist, none, match_last_seen (online only)\n\nBlock/Unblock Contact\nPOST /user/block\nPOST /user/unblock\n\n{\n \"number\": \"5511999999999\"\n}\n\n# Get block list\nGET /user/blocklist\n\nUpdate Profile\n# Set profile picture\nPOST /user/profilePicture\n{\n \"image\": \"https://example.com/photo.jpg\"\n}\n\n# Set profile name\nPOST /user/profileName\n{\n \"name\": \"My Name\"\n}\n\n# Set status/about\nPOST /user/profileStatus\n{\n \"status\": \"My custom status\"\n}\n\n\nLimits:\n\nName: 25 characters max\nStatus: 139 characters max\n๐Ÿท๏ธ Labels (Tags)\nAdd Label\n# To chat\nPOST /label/chat\n{\n \"jid\": \"5511999999999@s.whatsapp.net\",\n \"labelId\": \"1\"\n}\n\n# To message\nPOST /label/message\n{\n \"jid\": \"5511999999999@s.whatsapp.net\",\n \"labelId\": \"1\",\n \"messageId\": \"MESSAGE_ID\"\n}\n\nRemove Label\nPOST /unlabel/chat\nPOST /unlabel/message\n\n{\n \"jid\": \"5511999999999@s.whatsapp.net\",\n \"labelId\": \"1\",\n \"messageId\": \"MESSAGE_ID\" # Only for /unlabel/message\n}\n\nEdit Label\nPOST /label/edit\n\n{\n \"labelId\": \"1\",\n \"name\": \"New Label Name\"\n}\n\nList Labels\nGET /label\n\n๐Ÿ˜๏ธ Communities\nCreate Community\nPOST /community/create\n\n{\n \"communityName\": \"My Community\",\n \"description\": \"Optional description\"\n}\n\nAdd/Remove Groups\nPOST /community/add\n{\n \"communityJID\": \"120363123456789012@g.us\",\n \"groupJID\": [\"120363111111111111@g.us\"]\n}\n\nPOST /community/remove\n{\n \"communityJID\": \"120363123456789012@g.us\",\n \"groupJID\": [\"120363111111111111@g.us\"]\n}\n\n๐Ÿ“ข Newsletters (Channels)\nCreate Newsletter\nPOST /newsletter/create\n\n{\n \"name\": \"My Channel\",\n \"description\": \"Optional description\"\n}\n\nList Newsletters\nGET /newsletter/list\n\nGet Newsletter Info\nPOST /newsletter/info\n\n{\n \"jid\": \"120363123456789012@newsletter\"\n}\n\nSubscribe\nPOST /newsletter/subscribe\n\n{\n \"jid\": \"120363123456789012@newsletter\"\n}\n\nGet Newsletter Messages\nPOST /newsletter/messages\n\n{\n \"jid\": \"120363123456789012@newsletter\",\n \"limit\": 50\n}\n\nGet Invite Link Info\nPOST /newsletter/link\n\n{\n \"key\": \"INVITE_KEY\"\n}\n\n๐Ÿ“ž Call Management\nReject Call\nPOST /call/reject\n\n# Webhook payload from call event\n\n\nUse with webhook automation to auto-reject calls.\n\n๐ŸŽฌ Common Workflows\nBroadcast Message to Multiple Contacts\nfor number in 5511999999999 5511888888888 5511777777777; do\n curl -X POST \"$EVOGO_API_URL/send/text\" \\\n -H \"apikey: $EVOGO_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"{\n \\\"number\\\": \\\"$number\\\",\n \\\"text\\\": \\\"Broadcast message\\\",\n \\\"delay\\\": 2000\n }\"\ndone\n\nSend Image with Mentions (Groups)\ncurl -X POST \"$EVOGO_API_URL/send/media\" \\\n -H \"apikey: $EVOGO_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"number\": \"120363123456789012@g.us\",\n \"url\": \"https://example.com/report.jpg\",\n \"type\": \"image\",\n \"caption\": \"Report ready! @5511999999999 please review\",\n \"mentionedJid\": [\"5511999999999@s.whatsapp.net\"]\n }'\n\nAuto-Create Group + Welcome Message\n# 1. Create group\nGROUP_JID=$(curl -s -X POST \"$EVOGO_API_URL/group/create\" \\\n -H \"apikey: $EVOGO_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"groupName\": \"Team Alpha\",\n \"participants\": [\"5511999999999@s.whatsapp.net\"]\n }' | jq -r '.groupJid')\n\n# 2. Send welcome message\ncurl -X POST \"$EVOGO_API_URL/send/text\" \\\n -H \"apikey: $EVOGO_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"{\n \\\"number\\\": \\\"$GROUP_JID\\\",\n \\\"text\\\": \\\"Welcome to Team Alpha! ๐ŸŽ‰\\\"\n }\"\n\nCheck Multiple Numbers\ncurl -X POST \"$EVOGO_API_URL/user/check\" \\\n -H \"apikey: $EVOGO_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"number\": [\n \"5511999999999\",\n \"5511888888888\",\n \"5511777777777\"\n ]\n }'\n\nโš ๏ธ Rate Limits & Best Practices\nDelays\n\nAlways add delays between messages:\n\n{\"delay\": 2000} // 2 seconds\n\n\nRecommended:\n\n1-2 seconds between individual messages\n3-5 seconds between mass sends\nExponential backoff on errors\nError Handling\n\nHTTP Status Codes:\n\n200 - Success\n400 - Bad request (check parameters)\n401 - Unauthorized (check API key)\n404 - Not found (instance/resource doesn't exist)\n500 - Server error\n\nCommon Issues:\n\nError\tSolution\nInstance not connected\tRun POST /instance/connect\nInvalid phone format\tUse international without +: 5511999999999\nMessage not sent\tCheck GET /instance/status\nGroup operation failed\tVerify you're admin (for admin operations)\n๐Ÿ”— Webhooks\n\nConfigure webhooks to receive real-time events:\n\nMessage received\nMessage sent\nConnection status\nGroup updates\nCalls received\nAnd more...\n\nUse POST /webhook/set endpoint to configure webhook URL (see Postman collection for details).\n\n๐Ÿงช Troubleshooting\nInstance Won't Connect\n# 1. Check if instance exists\nGET /instance/all\n\n# 2. Force reconnect\nPOST /instance/forcereconnect/{instance}\n\n# 3. Check logs\nGET /instance/logs/{instance}?level=error\n\nMessages Not Sending\nVerify connection: GET /instance/status\nCheck phone format (no + or spaces)\nEnsure recipient has WhatsApp\nVerify API key is correct\nGroup Operations Failing\nCheck you're admin (for admin operations)\nVerify group JID format: xxxxx@g.us\nEnsure participants use format: number@s.whatsapp.net\n๐Ÿ“š Resources\nEvolution API Go: https://github.com/EvolutionAPI/evolution-api\nWhatsApp Business API: https://developers.facebook.com/docs/whatsapp\nJID Format Guide: number@s.whatsapp.net for users, xxxxx@g.us for groups\n๐Ÿ†• Known Limitations\n\nNot Working (v3.0):\n\n/send/button - Interactive buttons (deprecated by WhatsApp)\n/send/list - Interactive lists (deprecated by WhatsApp)\n\nThese endpoints exist but are non-functional due to WhatsApp API changes.\n\n๐Ÿ’ก Tips\nAlways check status before operations\nUse delays to avoid rate limits (1-2s minimum)\nStore tokens securely in environment variables\nHandle disconnects with automatic reconnection\nValidate numbers before sending\nUse webhooks for real-time event handling\nMonitor logs for troubleshooting\nTest with small groups before mass operations\n\nevoGo simplifies WhatsApp automation with Evolution API Go v3. For advanced features, check the full Postman collection or API documentation." }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/impa365/evogo", "publisherUrl": "https://clawhub.ai/impa365/evogo", "owner": "impa365", "version": "1.0.1", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/evogo", "downloadUrl": "https://openagent3.xyz/downloads/evogo", "agentUrl": "https://openagent3.xyz/skills/evogo/agent", "manifestUrl": "https://openagent3.xyz/skills/evogo/agent.json", "briefUrl": "https://openagent3.xyz/skills/evogo/agent.md" } }