Skip to main content

WhatsApp Bot (Yamify)

Yamify includes a WhatsApp bot so you can manage workspaces and deploy apps without opening the dashboard.

What You Can Do​

  • Link your WhatsApp number to your Yamify account
  • List marketplace apps
  • Create a workspace (+ Yam)
  • Deploy apps and receive the final URLs

Prereqs​

  • A Yamify account (Google sign-in or email sign-in)
  • WhatsApp Cloud API bot configured by Yamify admin

Test The Bot (User Steps)​

Meta test number: +1 555 151 6683

  1. Open WhatsApp (your personal phone).
  2. Start a chat with +1 555 151 6683.
  3. Send: help
  4. Expected response: a list of commands.
  1. Send: link
  2. The bot replies with a URL like: https://yamify.co/bot/whatsapp/link?token=...
  3. Open the link and sign in to Yamify.
  4. After linking, return to WhatsApp and run:
    • workspaces
    • marketplace

Commands​

Help​

help

Marketplace catalog​

marketplace

List workspaces​

workspaces

Create workspace (also creates a Yam)​

workspace <name>

Example: workspace mike

List apps in your account​

apps

Deploy an app​

deploy <app> <workspace> <project> key=value...

Examples:

  • Deploy n8n: deploy n8n mike-workspace sales dbUser=n8n dbPassword=supersecret
  • Deploy OpenClaw (local by default if configured): deploy openclaw mike-workspace agent llmProvider=ollama llmModel=ollama/qwen2.5:0.5b

Admin Setup (Webhook)​

Webhook URL: https://yamify.co/api/v1/whatsapp/webhook

Meta verification uses:

  • Method: GET
  • Query params:
    • hub.mode=subscribe
    • hub.challenge=...
    • hub.verify_token=...

Verify endpoint (safe test)​

curl -sG 'https://yamify.co/api/v1/whatsapp/webhook' \
  --data-urlencode 'hub.mode=subscribe' \
  --data-urlencode 'hub.challenge=12345' \
  --data-urlencode 'hub.verify_token=<WHATSAPP_VERIFY_TOKEN>'

Expected output: 12345

Troubleshooting​

No reply from bot​

  • Confirm the webhook is subscribed to messages in Meta.
  • Confirm Yamify server has WHATSAPP_ACCESS_TOKEN and WHATSAPP_PHONE_NUMBER_ID configured.
  • Confirm the WhatsApp test user is allowed in Meta’s test settings (if using a sandbox/test number).

“Not linked” replies​

Run link and complete the login flow.