Freight Client Onboard

Usage

Full onboarding (one command)

cd skills/freight-client-onboard/scripts
python3 onboard_client.py --name "ABC Trucking" --email "[email protected]" --phone "+1-555-123-4567"

Dry run (test without creating resources)

python3 onboard_client.py --name "Test Broker" --email "[email protected]" --phone "+1-555-0000" --dry-run

View onboarding history

python3 onboard_client.py --history

Start dashboard API

python3 dashboard_api.py --port 8080

Post-Onboarding (Manual Steps)

After the script runs:

1. Buy Twilio Number

   • Go to twilio.com/console/phone-numbers/search
   • Buy a local number (~$1/month)

2. Configure Webhook

   • Phone Numbers → Manage → Active Numbers
   • Click your number
   • Messaging → Webhook
   • URL: http://vps-ip:8080/webhook/sms
   • Method: HTTP POST

3. Test

   • Text "help" to the Twilio number
   • Should receive command list

Dashboard API

Web API for managing clients programmatically.

Create client via API

curl -X POST http://localhost:8080/api/clients \
  -H "Content-Type: application/json" \
  -d '{"name":"ABC Trucking","email":"[email protected]","phone":"+1-555-123-4567"}'

SMS Output Example

🚀 STARTING ONBOARDING: ABC Trucking
==================================================

📦 Step 1: Creating VPS...
   ✅ VPS created: CLIENT-20251218000001
   📍 IP: 192.0.2.100

⏳ Step 2: Waiting for VPS...
   ✅ VPS ready!

🔧 Step 3: Installing dependencies...
   ✅ Installed: Python, Twilio, OCR libs

📁 Step 4: Deploying freight skills...
   ✅ 11 skills deployed

📱 Step 5: Configuring Twilio webhook...
   ⚠️  Pending manual config
   Webhook URL: http://192.0.2.100:8080/webhook/sms

🚀 Step 6: Starting webhook server...
   ✅ Server running on port 8080

==================================================
✅ ONBOARDING COMPLETE!
Client ID: CLIENT-20251218000001
VPS IP: 192.0.2.100
Webhook: http://192.0.2.100:8080/webhook/sms

⚠️  ACTION REQUIRED:
1. Buy Twilio phone number
2. Configure webhook: http://192.0.2.100:8080/webhook/sms
3. Share number with broker
4. Test: text 'help'

Frontend Dashboard

Build a simple web UI that calls the dashboard API:

<!-- Client list -->
<script>
fetch('http://localhost:8080/api/clients')
  .then(r => r.json())
  .then(data => {
    data.clients.forEach(c => {
      console.log(`${c.name}: ${c.vps_ip} (${c.status})`);
    });
  });
</script>

Monitoring

• Onboarding logs: ~/.freight-broker/onboarding.log
• Client records: ~/.freight-broker/clients.json
• VPS status: vps_manager.py --status CLIENT-ID
• Webhook logs: /var/log/webhook.log (on VPS)

Troubleshooting

• "VPS_API_KEY not configured" → Set env var with your cloud provider key
• SSH timeout → Check firewall, verify SSH key is added to provider
• Webhook not responding → Check port 8080 is open, server is running
• Twilio errors → Verify Account SID and Auth Token in VPS env vars

Integrations

This skill uses the following external services. See INTEGRATIONS.md for detailed setup instructions, API documentation links, and implementation guidance.

See INTEGRATIONS.md for complete integration architecture

Twilio Costs

• Phone number: $1/month
• Inbound SMS: Free
• Outbound SMS: $0.0075/message
• 1000 messages/month = ~$8.50 total per client