{"id":50032804,"url":"https://github.com/splashifypro/cli","last_synced_at":"2026-05-28T11:00:57.609Z","repository":{"id":359076944,"uuid":"1244325442","full_name":"splashifypro/cli","owner":"splashifypro","description":"Official command-line interface for Splashify Pro — control your WhatsApp Business account from any terminal.","archived":false,"fork":false,"pushed_at":"2026-05-28T09:41:28.000Z","size":240,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-28T10:24:55.337Z","etag":null,"topics":["cli","golang","messaging-api","splashify","terminal","whatsapp","whatsapp-business-api"],"latest_commit_sha":null,"homepage":"https://docs.splashifypro.com/cli/install","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/splashifypro.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-20T06:58:06.000Z","updated_at":"2026-05-28T09:41:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/splashifypro/cli","commit_stats":null,"previous_names":["splashifypro/cli"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/splashifypro/cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/splashifypro%2Fcli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/splashifypro%2Fcli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/splashifypro%2Fcli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/splashifypro%2Fcli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/splashifypro","download_url":"https://codeload.github.com/splashifypro/cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/splashifypro%2Fcli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33605379,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-28T02:00:06.440Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","golang","messaging-api","splashify","terminal","whatsapp","whatsapp-business-api"],"created_at":"2026-05-20T22:00:59.391Z","updated_at":"2026-05-28T11:00:57.601Z","avatar_url":"https://github.com/splashifypro.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# splashify CLI\n\nConnect a Splashify messaging account to **OpenClaw** (the local-first AI\nassistant — https://github.com/openclaw/openclaw) so the assistant can perform\nevery app action — send WhatsApp/RCS messages, manage contacts, run broadcasts,\nedit templates, read analytics — on the user's behalf.\n\n## How it fits together\n\n```\nOpenClaw ──MCP/stdio──► splashify-mcp ──HTTPS, Bearer oc_live_──► backend /api/v1/app/*\n```\n\nThe CLI does three things: hold an `oc_live_` access token, manage tokens, and\nregister the `splashify-mcp` server with OpenClaw.\n\n## Build\n\n```bash\n# the CLI\ncd cli \u0026\u0026 go build -o splashify ./...\n\n# the MCP server it links into OpenClaw (separate Go module)\ncd ../mcp \u0026\u0026 go build -o splashify-mcp ./cmd\n```\n\nPut `splashify` and `splashify-mcp` on your `PATH` (same directory works too —\nthe CLI looks for `splashify-mcp` next to itself).\n\n## Connect\n\n```bash\n# Connect this machine. Paste an oc_live_ token from the app\n# (Settings → Developer → Access Tokens), or create one here:\nsplashify connect\n\nsplashify token create --name \"OpenClaw on laptop\"   # mint a token\nsplashify token list                                 # see your tokens\nsplashify token revoke \u003cid\u003e                           # kill a token\n\nsplashify whoami        # show the connected account\nsplashify doctor        # diagnose config / token / openclaw / mcp binary\n```\n\nConfig is stored at `~/.splashify/config.json` (mode 0600) — it holds the\nbackend URL and the `oc_live_` token, so treat it like a password file.\n\n## Do everything from the command line\n\nOnce connected, the CLI can perform every app task directly — no OpenClaw\nrequired. Every command prints the backend's JSON response.\n\n### Messaging\n\n```bash\nsplashify message send --to +919876543210 --text \"Your order has shipped\"\nsplashify message template --to +919876543210 --name order_update \\\n  --lang en --vars '[\"John\",\"ORD-1024\"]'\nsplashify message media --to +919876543210 --type image \\\n  --url https://example.com/receipt.png --caption \"Receipt\"\n\nsplashify conversations --status open          # list chats\nsplashify conversation \u003cid\u003e                    # read one chat\nsplashify conversation \u003cid\u003e resolve            # close a chat\nsplashify unread                               # unread count\n```\n\n### Contacts\n\n```bash\nsplashify contacts --search john --tag vip\nsplashify contact \u003cid\u003e\nsplashify contact create --phone +919876543210 --name \"John Roe\" --email john@x.com\nsplashify contact tag \u003cid\u003e --tags vip,lead\nsplashify contact block \u003cid\u003e\nsplashify contact unblock \u003cid\u003e\nsplashify contact delete \u003cid\u003e\n```\n\n### Broadcasts, templates, analytics, wallet\n\n```bash\nsplashify broadcasts\nsplashify broadcast \u003cid\u003e\nsplashify broadcast stats\nsplashify broadcast create --name \"May Sale\" --template may_offer \\\n  --audience-type segment --audience-id \u003csegment-id\u003e --schedule 2026-06-01T10:00:00Z\n\nsplashify templates\nsplashify analytics            # message analytics summary\nsplashify analytics trends\nsplashify wallet               # balance\nsplashify wallet transactions\n```\n\n### Everything else — the generic `api` command\n\nAny `/api/v1/app/*` endpoint is reachable directly, so the CLI covers the\nfull app surface (segments, AI agents, team, tickets, WABA setup, …):\n\n```bash\nsplashify api GET  /app/segments\nsplashify api GET  \"/app/contacts?page=2\u0026page_size=50\"\nsplashify api POST /app/messages/send-text --data '{\"phone\":\"+919876543210\",\"message\":\"hi\"}'\nsplashify api POST /app/ai-agents --data '{\"name\":\"Support Bot\"}'\nsplashify api DELETE /app/contacts/\u003cid\u003e\n```\n\nThe path may be given with or without the `/api/v1` prefix. Use `--data` to\npass a JSON request body for `POST`/`PUT`/`PATCH`.\n\n## Connect Splashify Pro with OpenClaw\n\nTo let the OpenClaw AI assistant drive your account in natural language:\n\n```bash\n# 1. install OpenClaw\nnpm install -g openclaw@latest \u0026\u0026 openclaw onboard --install-daemon\n\n# 2. connect this machine (if not already done)\nsplashify connect\n\n# 3. register the splashify MCP server with OpenClaw\nsplashify link openclaw       # runs `openclaw mcp add splashify …` for you\nsplashify mcp-config          # or print the command to run manually\n\n# 4. restart the OpenClaw Gateway, then confirm\nsplashify doctor              # all checks should be ✓\n```\n\nThen ask your assistant things like *\"send a WhatsApp to +91… saying the order\nshipped\"* or *\"list my VIP contacts\"* — it performs them on your account.\n\n**Full step-by-step connect + usage guide:**\n[`app-docs/openclaw-integration.md`](../app-docs/openclaw-integration.md) — covers\nprerequisites, the manual `openclaw mcp add` command, example assistant\nprompts, revoking access, and troubleshooting.\n\nRun `splashify help` for the full command list.\n\n## Token model\n\n- `oc_live_` tokens are long-lived credentials accepted on every `/api/v1/app/*`\n  route as an alternative to the session JWT.\n- The raw token is shown **once** at creation; only its SHA-256 hash is stored.\n- Revoke from `splashify token revoke`, the app UI, or the API — revocation is\n  immediate.\n- A token resolves to the account owner; it never grants admin/reseller access.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsplashifypro%2Fcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsplashifypro%2Fcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsplashifypro%2Fcli/lists"}