Quo Webhook Setup - Resolution

Date: Feb 15, 2026
Status: ✅ RESOLVED - Webhook operational

Critical Constraint

ONLY (385) 485-5863 maps to Quan's personal phone.
NEVER use any other Quo numbers.

Current State

✅ Working

• API credentials configured: /home/node/.openclaw/credentials/quo-api.json
• Webhook handler running: PID 597, port 18791
• Handler health check responds: curl http://localhost:18791/
• Messaging script works: tools/quo-messaging.py

❌ Not Working

• Webhook not receiving messages from Quo
• Need to configure webhook URL in Quo dashboard

Architecture

Quo API → (webhook URL) → Cloudflare Tunnel → VPS:18791 → OpenClaw

What Was Wrong (Minnie's Diagnosis Was Incorrect)

Minnie thought:

• Cloudflared needed to be installed inside Docker container
• New tunnel needed to be created
• Complex authentication flow required

Actual problems:

1. Port 18791 not exposed from Docker → host (docker-compose.override.yml needed update)
2. Existing Cloudflare tunnel gw-e3364c just needed one more ingress rule
3. Handler had three bugs:
   • Checked for message.created event, Quo sends message.received
   • Read payload from data, actual path is data.object
   • Looked for text field, Quo uses body

How It Was Fixed (By Quan on Host)

1. Docker Port Mapping

# docker-compose.override.yml
ports:
  - "18791:18791"

Recreated container with: docker-compose up -d --force-recreate

2. Cloudflare Tunnel Config
Used existing tunnel gw-e3364c, added:

• DNS route: sms-7f2a1b.relay9kq.us
• Ingress rule: sms-7f2a1b.relay9kq.us → http://localhost:18791
• Restarted tunnel: systemctl restart cloudflared

3. Systemd Service
Created /etc/systemd/system/quo-webhook.service (handler runs as service, survives reboots)

4. Handler Bugs
Fixed quo-webhook-handler-v2.py event parsing to match Quo's actual webhook payload format.

Result

✅ SMS to (385) 485-5863 → Quo webhook → Telegram (working)
⏸️ Telegram → SMS reply (manual via quo-messaging.py, not auto-wired yet)

Debugging Commands

# Check webhook handler status
ps aux | grep quo-webhook

# Test webhook handler locally
curl http://localhost:18791/

# Check Cloudflare tunnel status
cloudflared tunnel list

# View webhook logs
tail -f /var/log/quo-webhook.log

Phone Numbers (Reference)

• (385) 485-5863 - Quan's mapping ✅ USE THIS
• (562) 451-8061 - Quan direct (DO NOT USE)
• (626) 828-8000 - ZTAG Main (DO NOT USE)
• (661) 386-4777 - ZTAG INC (DO NOT USE)
• (986) 886-4673 - Tin (DO NOT USE)

---

Session notes as we debug together