claudetools/clients/valleywide/voip/README.md

# Valley Wide Plastering - VoIP Provisioning

**Client:** Valley Wide Plastering
**Domain:** vwp.91912.service
**Main Number:** 480-705-9500
**Status:** Ready for CSV Import

---

## Quick Navigation

### Current Status & Next Steps
- **[PROVISIONING-STATUS.md](PROVISIONING-STATUS.md)** - Current status, next actions, what to do tomorrow morning

### Complete Documentation
- **[SESSION-SUMMARY-2026-07-09.md](SESSION-SUMMARY-2026-07-09.md)** - Full session documentation, all decisions, technical details
- **[COMPLETE-CLIENT-SETUP.md](COMPLETE-CLIENT-SETUP.md)** - Complete VoIP setup guide (DIDs, queues, auto-attendants, time frames)

### Working Files
- **[extension-mapping.md](extension-mapping.md)** - Extension to M365 account mapping (11 matched, 7 unmatched)
- **[vwp-users-import.csv](vwp-users-import.csv)** - Bulk import CSV for PacketDial (ready to upload)
- **[DEVICE-ASSIGNMENT-COMMANDS.md](DEVICE-ASSIGNMENT-COMMANDS.md)** - Copy-paste command reference for assigning phones to users

---

## Quick Reference

### Domain Info
```
Domain: vwp.91912.service
Reseller: 91912.service (ACG)
Description: Valley Wide Plastering
Timezone: America/Phoenix
Dial Policy: US and Canada
E911 Address ID: a-6a395c03d4cfe
  (301 N 56TH ST, CHANDLER AZ 85226)
Main Caller ID: Valley Wide Plastering / 4807059500
```

### YMCS Info
```
Site: Valley Wide Plastering
Site ID: 1e7578a6fe0e41cfb5a3e8b40933ffee
RPS Server: http://ndp.ucaasnetwork.com/cfg
RPS Credentials: Prov_Admin / YJ5UgRd9pV
  (Vault: msp-tools/oitvoip-provisioning.sops.yaml)
```

### PacketDial Web UI
```
URL: https://pbx.packetdial.com/
Username: Prov_Admin
Password: YJ5UgRd9pV
Navigation: Domains → vwp.91912.service → Users → Import
```

---

## Implementation Status

### Phase 1: Basic Setup ✓
- [x] Domain created
- [x] E911 address configured
- [x] RPS URL fixed (critical issue resolved)
- [x] 11 matched users prepared (CSV ready)
- [ ] CSV uploaded to PacketDial **← NEXT STEP**
- [ ] Users verified created
- [ ] Devices assigned as phones distributed

### Phase 2: Main Line Setup (Planned)
- [ ] Create general reception queue (8000)
- [ ] Create main auto-attendant (3000)
- [ ] Assign main DID 480-705-9500
- [ ] Test inbound calling

### Phase 3: Business Hours (Planned)
- [ ] Create business hours timeframe (M-F 7am-5pm)
- [ ] Create after-hours timeframe
- [ ] Update DID routing for time-based handling

### Phase 4: Additional Features (Optional)
- [ ] Management queue (8001)
- [ ] Accounting queue (8002)
- [ ] Shared extensions (Kitchen, Conference Room, Warehouse)
- [ ] Get clarification on 7 unmatched users

---

## Critical Fix Completed

**Phone Registration Issue - RESOLVED ✓**

**Problem:** Test phone showed Status 3 (Unregistered) despite correct SIP credentials.

**Root Cause:** Wrong RPS provisioning server URL in YMCS.

**Wrong URL (Whitelabel Communication):**
```
ftp://p.packetdials.net
Username: lrshwh
```

**Correct URL (OIT/PacketDial):**
```
http://ndp.ucaasnetwork.com/cfg
Username: Prov_Admin
Password: YJ5UgRd9pV
```

**Result:** Test phone (805e0cdd71b1) immediately registered after fix.

**Important:** ACG has TWO whitelabel accounts:
- Whitelabel Communication (WLC): `ftp://p.packetdials.net`
- OIT/PacketDial: `http://ndp.ucaasnetwork.com/cfg` ← VWP uses this

---

## User Summary

### Matched Users (11) - Ready for Import
CSV file ready with correct M365 email addresses:
- 102: Jesse Guerrero
- 103: Rose Guerrero
- 104: Shelly Dooley
- 105: JR Guerrero
- 107: Payroll Department
- 109: Kayla Guerrero
- 110: Ron Winger
- 113: Chris Guerrero
- 114: Ty Fetters
- 115: Toni Billing
- 116: Bart Graffin

### Unmatched Users (7) - Need Clarification
- 101: Natalya - no M365 match
- 106: Tammy - no M365 match
- 108: Shannon - no M365 match
- 111: Kitchen - shared phone
- 112: Conference Room - shared phone
- 117: Jesse III - possibly Ryan Guerrero?
- 118: Warehouse - shared phone

---

## Device Assignment Workflow

**Strategy:** Users created WITHOUT devices. Devices assigned later as phones physically distributed.

**Per-Phone Process:**
1. User provides last 4 digits of MAC address
2. Create SIP device in PacketDial → get auto-generated password
3. Create YMCS SIP account with that password
4. Bind account to physical phone by device ID
5. Reboot phone → registers and ready to use

**Full workflow documented in:** PROVISIONING-STATUS.md

---

## Contact & Support

### PacketDial/OIT Support
- Portal: https://pbx.packetdial.com/
- Support: support@oitvoip.com
- Phone: (Check portal for current number)

### Yealink YMCS
- Portal: https://us.ymcs.yealink.com/
- Support: support@yealink.com
- Documentation: https://support.yealink.com/

### ACG Internal
- PacketDial Skill: `.claude/skills/packetdial/`
- YMCS Skill: `.claude/skills/yealink-ymcs/`
- Vault: `msp-tools/oitvoip*.sops.yaml`

---

## Timeline

**2026-07-09:**
- Domain created (vwp.91912.service)
- RPS URL issue diagnosed and fixed
- M365 account matching completed
- CSV bulk import prepared
- Complete VoIP setup documented
- Device assignment workflow designed

**Next (Tomorrow Morning):**
- Upload CSV to PacketDial web UI
- Verify 11 users created
- Get client clarification on 7 unmatched users
- Begin device assignment as phones distributed

**Soon (Within Week):**
- Create reception queue
- Create auto-attendant
- Assign main DID
- Test complete call flow

---

## Files in This Directory

```
clients/valleywide/voip/
├── README.md                           ← This file (quick navigation)
├── PROVISIONING-STATUS.md              ← Current status & next steps
├── SESSION-SUMMARY-2026-07-09.md       ← Complete session documentation
├── COMPLETE-CLIENT-SETUP.md            ← Full VoIP setup guide
├── DEVICE-ASSIGNMENT-COMMANDS.md       ← Copy-paste commands for device assignment
├── extension-mapping.md                ← Extension to M365 mapping
└── vwp-users-import.csv                ← Bulk import file (READY)
```

---

**Last Updated:** 2026-07-09 20:45 MST
**Next Update:** After CSV upload completion