{"_id":"@apilium/mayros-zalouser","name":"@apilium/mayros-zalouser","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.1":{"name":"@apilium/mayros-zalouser","version":"0.1.1","description":"Mayros Zalo Personal Account plugin via zca-cli","license":"MIT","type":"module","publishConfig":{"access":"public"},"dependencies":{"@sinclair/typebox":"0.34.48"},"peerDependencies":{"@apilium/mayros":">=0.1.0"},"mayros":{"extensions":["./index.ts"],"channel":{"id":"zalouser","label":"Zalo Personal","selectionLabel":"Zalo (Personal Account)","docsPath":"/channels/zalouser","docsLabel":"zalouser","blurb":"Zalo personal account via QR code login.","aliases":["zlu"],"order":85,"quickstartAllowFrom":true},"install":{"npmSpec":"@apilium/mayros-zalouser","localPath":"extensions/zalouser","defaultChoice":"npm"}},"_id":"@apilium/mayros-zalouser@0.1.1","_integrity":"sha512-K0iX9zRFsmbCvR4dJNMGxXmAOoApW9MrjaYGsZkInN2xjJSFLVV2457hLyta8JLMzhPQUwmD4oWgyXs7CsuLXA==","_resolved":"/private/var/folders/_y/k11qcrj94k32_yl6486p9bsc0000gn/T/e5f9c5443087c76b448a906ecd9ed865/apilium-mayros-zalouser-0.1.1.tgz","_from":"file:apilium-mayros-zalouser-0.1.1.tgz","_nodeVersion":"24.8.0","_npmVersion":"11.6.0","dist":{"integrity":"sha512-K0iX9zRFsmbCvR4dJNMGxXmAOoApW9MrjaYGsZkInN2xjJSFLVV2457hLyta8JLMzhPQUwmD4oWgyXs7CsuLXA==","shasum":"15efebc20965a4648babb33ab9dc0bc706743ae0","tarball":"https://registry.npmjs.org/@apilium/mayros-zalouser/-/mayros-zalouser-0.1.1.tgz","fileCount":20,"unpackedSize":91558,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDCvX/r8zq2A8/ud9nqH97EeIy2v1VsBttEW0+RcU6RxQIgYosvVadrGwhakBqKoHChMpA5FdoJ5waq9qL5pjk5sjE="}]},"_npmUser":{"name":"apilium-ai","email":"it@apilium.com"},"directories":{},"maintainers":[{"name":"apilium-ai","email":"it@apilium.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mayros-zalouser_0.1.1_1772217464269_0.4891102732088324"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-27T18:37:44.194Z","0.1.1":"2026-02-27T18:37:44.407Z","modified":"2026-02-27T18:37:44.593Z"},"maintainers":[{"name":"apilium-ai","email":"it@apilium.com"}],"description":"Mayros Zalo Personal Account plugin via zca-cli","license":"MIT","readme":"# @apilium/mayros-zalouser\n\nMayros extension for Zalo Personal Account messaging via [zca-cli](https://zca-cli.dev).\n\n> **Warning:** Using Zalo automation may result in account suspension or ban. Use at your own risk. This is an unofficial integration.\n\n## Features\n\n- **Channel Plugin Integration**: Appears in onboarding wizard with QR login\n- **Gateway Integration**: Real-time message listening via the gateway\n- **Multi-Account Support**: Manage multiple Zalo personal accounts\n- **CLI Commands**: Full command-line interface for messaging\n- **Agent Tool**: AI agent integration for automated messaging\n\n## Prerequisites\n\nInstall `zca` CLI and ensure it's in your PATH:\n\n**macOS / Linux:**\n\n```bash\ncurl -fsSL https://get.zca-cli.dev/install.sh | bash\n\n# Or with custom install directory\nZCA_INSTALL_DIR=~/.local/bin curl -fsSL https://get.zca-cli.dev/install.sh | bash\n\n# Install specific version\ncurl -fsSL https://get.zca-cli.dev/install.sh | bash -s v1.0.0\n\n# Uninstall\ncurl -fsSL https://get.zca-cli.dev/install.sh | bash -s uninstall\n```\n\n**Windows (PowerShell):**\n\n```powershell\nirm https://get.zca-cli.dev/install.ps1 | iex\n\n# Or with custom install directory\n$env:ZCA_INSTALL_DIR = \"C:\\Tools\\zca\"; irm https://get.zca-cli.dev/install.ps1 | iex\n\n# Install specific version\niex \"& { $(irm https://get.zca-cli.dev/install.ps1) } -Version v1.0.0\"\n\n# Uninstall\niex \"& { $(irm https://get.zca-cli.dev/install.ps1) } -Uninstall\"\n```\n\n### Manual Download\n\nDownload binary directly:\n\n**macOS / Linux:**\n\n```bash\ncurl -fsSL https://get.zca-cli.dev/latest/zca-darwin-arm64 -o zca && chmod +x zca\n```\n\n**Windows (PowerShell):**\n\n```powershell\nInvoke-WebRequest -Uri https://get.zca-cli.dev/latest/zca-windows-x64.exe -OutFile zca.exe\n```\n\nAvailable binaries:\n\n- `zca-darwin-arm64` - macOS Apple Silicon\n- `zca-darwin-x64` - macOS Intel\n- `zca-linux-arm64` - Linux ARM64\n- `zca-linux-x64` - Linux x86_64\n- `zca-windows-x64.exe` - Windows\n\nSee [zca-cli](https://zca-cli.dev) for manual download (binaries for macOS/Linux/Windows) or building from source.\n\n## Quick Start\n\n### Option 1: Onboarding Wizard (Recommended)\n\n```bash\nmayros onboard\n# Select \"Zalo Personal\" from channel list\n# Follow QR code login flow\n```\n\n### Option 2: Login (QR, on the Gateway machine)\n\n```bash\nmayros channels login --channel zalouser\n# Scan QR code with Zalo app\n```\n\n### Send a Message\n\n```bash\nmayros message send --channel zalouser --target <threadId> --message \"Hello from Mayros!\"\n```\n\n## Configuration\n\nAfter onboarding, your config will include:\n\n```yaml\nchannels:\n  zalouser:\n    enabled: true\n    dmPolicy: pairing # pairing | allowlist | open | disabled\n```\n\nFor multi-account:\n\n```yaml\nchannels:\n  zalouser:\n    enabled: true\n    defaultAccount: default\n    accounts:\n      default:\n        enabled: true\n        profile: default\n      work:\n        enabled: true\n        profile: work\n```\n\n## Commands\n\n### Authentication\n\n```bash\nmayros channels login --channel zalouser              # Login via QR\nmayros channels login --channel zalouser --account work\nmayros channels status --probe\nmayros channels logout --channel zalouser\n```\n\n### Directory (IDs, contacts, groups)\n\n```bash\nmayros directory self --channel zalouser\nmayros directory peers list --channel zalouser --query \"name\"\nmayros directory groups list --channel zalouser --query \"work\"\nmayros directory groups members --channel zalouser --group-id <id>\n```\n\n### Account Management\n\n```bash\nzca account list      # List all profiles\nzca account current   # Show active profile\nzca account switch <profile>\nzca account remove <profile>\nzca account label <profile> \"Work Account\"\n```\n\n### Messaging\n\n```bash\n# Text\nmayros message send --channel zalouser --target <threadId> --message \"message\"\n\n# Media (URL)\nmayros message send --channel zalouser --target <threadId> --message \"caption\" --media-url \"https://example.com/img.jpg\"\n```\n\n### Listener\n\nThe listener runs inside the Gateway when the channel is enabled. For debugging,\nuse `mayros channels logs --channel zalouser` or run `zca listen` directly.\n\n### Data Access\n\n```bash\n# Friends\nzca friend list\nzca friend list -j    # JSON output\nzca friend find \"name\"\nzca friend online\n\n# Groups\nzca group list\nzca group info <groupId>\nzca group members <groupId>\n\n# Profile\nzca me info\nzca me id\n```\n\n## Multi-Account Support\n\nUse `--profile` or `-p` to work with multiple accounts:\n\n```bash\nmayros channels login --channel zalouser --account work\nmayros message send --channel zalouser --account work --target <id> --message \"Hello\"\nZCA_PROFILE=work zca listen\n```\n\nProfile resolution order: `--profile` flag > `ZCA_PROFILE` env > default\n\n## Agent Tool\n\nThe extension registers a `zalouser` tool for AI agents:\n\n```json\n{\n  \"action\": \"send\",\n  \"threadId\": \"123456\",\n  \"message\": \"Hello from AI!\",\n  \"isGroup\": false,\n  \"profile\": \"default\"\n}\n```\n\nAvailable actions: `send`, `image`, `link`, `friends`, `groups`, `me`, `status`\n\n## Troubleshooting\n\n- **Login Issues:** Run `zca auth logout` then `zca auth login`\n- **API Errors:** Try `zca auth cache-refresh` or re-login\n- **File Uploads:** Check size (max 100MB) and path accessibility\n\n## Credits\n\nBuilt on [zca-cli](https://zca-cli.dev) which uses [zca-js](https://github.com/RFS-ADRENO/zca-js).\n","readmeFilename":"README.md","_rev":"1-ff1d09cc9917b6dd9d9e852aff7d2529"}