Dispatch Locations Module Documentation
Table of Contents
- Module Overview (Technical)
- Module Overview (Commercial/Business)
- Module Overview (End User/Administrator)
- Configuration Fields Reference
- Address Components
- Common Scenarios & Examples
- Limitations & Important Notes
- Troubleshooting Tips
- Glossary
---
1. Module Overview (Technical)
What Are Dispatch Locations?
Dispatch Locations are dispatchable address records that provide precise physical location information for E911 compliance. They support RAY BAUM's Act requirements by associating detailed location data (street, building, floor, room) with extensions, devices, or trunks.
Architecture
┌─────────────────────────────────────────────────────────────────┐
│ Dispatch Locations System │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ Dispatch Location Record │ │
│ │ │ │
│ │ Location Name: Main Building - 3rd Floor East │ │
│ │ │ │
│ │ Assignment: │ │
│ │ ├─ Type: Extension │ │
│ │ └─ Extension: 1001 │ │
│ │ │ │
│ │ Address: │ │
│ │ ├─ Street: 123 Main Street, Suite 300 │ │
│ │ ├─ City: Miami │ │
│ │ ├─ State: FL │ │
│ │ └─ ZIP: 33131 │ │
│ │ │ │
│ │ Building Details: │ │
│ │ ├─ Building: Main Building │ │
│ │ ├─ Floor: 3 │ │
│ │ ├─ Room: 310 │ │
│ │ └─ Wing: East │ │
│ │ │ │
│ │ Emergency: │ │
│ │ ├─ ELIN: +13055551234 │ │
│ │ └─ Contact: John Smith (305) 555-9999 │ │
│ │ │ │
│ └──────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ Used during 911 calls │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ Emergency Call Routing │ │
│ │ │ │
│ │ Extension 1001 dials 911 │ │
│ │ → Lookup dispatch location by extension │ │
│ │ → Override Caller ID with ELIN │ │
│ │ → Include dispatchable location in call │ │
│ │ → Route to PSAP │ │
│ │ │ │
│ └──────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
Key Tables
| Table | Purpose |
|---|
public.dispatch_locations | Location records | |
public.sip_extensions | Extension association |
Key Files
| File | Description |
|---|
modules/dispatchLocations/DispatchLocationsPage.tsx | Main page | |
modules/dispatchLocations/DispatchLocationFormView.tsx | Configuration form |
2. Module Overview (Commercial/Business)
Business Value
Dispatch Locations provides E911 location compliance:
| Without Dispatch Locations | With Dispatch Locations |
|---|
| Generic address | Building/floor/room | |
| Delayed response | Pinpoint accuracy | |
| Compliance risk | RAY BAUM's compliant | |
| Manual updates | Centralized management |
Regulatory Compliance
| Regulation | Requirement | Solution |
|---|
| RAY BAUM's Act | Dispatchable location | Floor/room/wing data | |
| NG911 | Precise coordinates | Lat/long support | |
| Kari's Law | On-site notification | Emergency contact |
Use Cases
- Multi-Floor Buildings
- Per-floor location records
- Room-level precision
- Campus Environments
- Multiple buildings
- Building-specific ELINs
- Remote Workers
- Home office addresses
- Per-device locations
- Multi-Tenant Systems
- Tenant-specific locations
- Shared building compliance
Feature Highlights
| Feature | Benefit |
|---|
| Full Address | Complete street address | |
| Building Details | Floor, room, wing | |
| ELIN Support | Location-specific callback | |
| GPS Coordinates | Precise positioning | |
| Assignment Types | Extension, device, trunk | |
| Special Instructions | First responder notes |
3. Module Overview (End User/Administrator)
What Can You Do?
- Create location records with full addresses
- Add building/floor/room details
- Assign locations to extensions or devices
- Configure ELIN numbers
- Add emergency contact info
- Include special instructions
┌─────────────────────────────────────────────────────────────────┐
│ Create Dispatch Location │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Section: Basic Information │
│ ├─ Location Name: Main Building - 3rd Floor East │
│ ├─ Location Code: MB-3E │
│ └─ Enabled: ✓ │
│ │
│ Section: Assignment │
│ ├─ Assignment Type: [User/Extension ▼] │
│ └─ Extension: [1001 - John Smith ▼] │
│ │
│ Section: Street Address │
│ ├─ Street Number: 123 │
│ ├─ Street Name: Main │
│ ├─ Street Suffix: Street │
│ ├─ Unit Type: [Suite ▼] │
│ ├─ Unit Number: 300 │
│ ├─ City: Miami │
│ ├─ State: FL │
│ ├─ ZIP Code: 33131 │
│ └─ Country: US │
│ │
│ Section: Building/Room Details │
│ ├─ Building Name: Main Building │
│ ├─ Floor: 3 │
│ ├─ Room: 310 │
│ └─ Wing: East │
│ │
│ Section: Emergency Information │
│ ├─ ELIN: +13055551234 │
│ ├─ Contact Name: John Smith │
│ ├─ Contact Phone: (305) 555-9999 │
│ └─ Special Instructions: Enter through main lobby... │
│ │
│ [Save] [Cancel] │
│ │
└─────────────────────────────────────────────────────────────────┘
Quick Tips
TIP
Be Specific: Include floor, room, and wing for large buildings.
TIP
Update Regularly: Verify locations when employees move.
CAUTION
Critical Data: Inaccurate locations delay emergency response.
---
4. Configuration Fields Reference
| Field | Description | Example |
|---|
| Location Name | Descriptive name | Main Bldg - 3rd Fl East | |
| Location Code | Short identifier | MB-3E | |
| Enabled | Active status | On/Off |
Assignment
| Field | Description |
|---|
| Assignment Type | User/Extension, Device, or Trunk | |
| Extension ID | Associated extension | |
| Device MAC | Device MAC address | |
| Site ID | Site identifier |
Street Address
| Field | Description | Example |
|---|
| Street Number | Building number | 123 | |
| Street Name | Street name | Main | |
| Street Suffix | Type | Street, Avenue | |
| Unit Type | Unit category | Suite, Floor | |
| Unit Number | Unit value | 300 | |
| City | City name | Miami | |
| State | State code | FL | |
| ZIP Code | Postal code | 33131 | |
| Country | Country code | US |
Building/Room Details
| Field | Description | Example |
|---|
| Building Name | Building identifier | Main Building | |
| Floor | Floor number | 3 | |
| Room | Room number | 310 | |
| Wing | Building wing | East | |
| Latitude | GPS latitude | 25.7617 | |
| Longitude | GPS longitude | -80.1918 |
| Field | Description |
|---|
| ELIN | Emergency Location ID Number | |
| Contact Name | On-site emergency contact | |
| Contact Phone | Contact phone number | |
| Special Instructions | First responder notes | |
| Validated | Address verified |
5. Address Components
Unit Types
| Type | Usage |
|---|
| None | No sub-unit | |
| Apartment | Residential apt | |
| Suite | Office suite | |
| Floor | Entire floor | |
| Office | Specific office | |
| Building | Entire building | |
| Department | Dept area | |
| Penthouse | Top floor unit | |
| Basement | Below ground |
Assignment Types
| Type | Description |
|---|
| User/Extension | Assigned to extension | |
| Device | Assigned to MAC address | |
| Trunk | Assigned to SIP trunk |
6. Common Scenarios & Examples
Scenario 1: Single Floor Office
Location:
| Field | Value |
|---|
| Name | Miami Office | |
| Street | 123 Main Street | |
| Suite | 300 | |
| City/State/ZIP | Miami, FL 33131 | |
| ELIN | +13055551001 | |
| Assigned To | All extensions |
Scenario 2: Multi-Floor Building
Per-Floor Locations:
| Location | Floor | ELIN |
|---|
| Main Bldg - 1st Floor | 1 | +13055551001 | |
| Main Bldg - 2nd Floor | 2 | +13055551002 | |
| Main Bldg - 3rd Floor | 3 | +13055551003 |
Scenario 3: Campus with Multiple Buildings
Per-Building Locations:
| Building | Address | ELIN |
|---|
| Main Building | 100 Campus Dr | +13055551100 | |
| Warehouse | 200 Campus Dr | +13055551200 | |
| Annex | 300 Campus Dr | +13055551300 |
Scenario 4: Remote Worker
Home Office Location:
| Field | Value |
|---|
| Name | John Smith - Home Office | |
| Street | 456 Oak Lane | |
| City/State/ZIP | Fort Lauderdale, FL 33301 | |
| ELIN | +19545552001 | |
| Assigned To | Extension 1050 |
7. Limitations & Important Notes
Technical Notes
IMPORTANT
RAY BAUM's Act: Dispatchable locations required as of January 2022.
WARNING
Accuracy Critical: Wrong location = delayed emergency response.
NOTE
ELIN Required: Each location needs unique callback number.
Validation Requirements
| Field | Requirement |
|---|
| Street Number | Required | |
| Street Name | Required | |
| City | Required | |
| State | Required | |
| ZIP Code | Required | |
| Country | Required |
Best Practices
- Verify Addresses: Validate with USPS/carrier
- Update Regularly: When employees move
- Unique ELINs: One per location
- Contact Info: Current emergency contact
- Special Instructions: Access codes, hazards
---
8. Troubleshooting Tips
Common Issues
| Symptom | Possible Cause | Solution |
|---|
| Location not used | Not assigned | Assign to extension | |
| Wrong location | Outdated record | Update location | |
| No ELIN | Missing field | Add ELIN number | |
| Address rejected | Invalid format | Use standard format | |
| Not validated | Not verified | Validate with carrier |
Diagnostic SQL
List dispatch locations:
SELECT id, location_name, street_number, street_name, city, state,
building_name, floor, room, elin, enabled
FROM public.dispatch_locations
WHERE domain_id = [domain_id];
SELECT dl.*
FROM public.dispatch_locations dl
JOIN public.sip_extensions se ON dl.extension_id = se.id
WHERE se.extension = '1001';
---
9. Glossary
| Term | Definition |
|---|
| Dispatchable Location | Precise physical address with floor/room | |
| ELIN | Emergency Location Identification Number | |
| RAY BAUM's Act | US law requiring dispatchable locations | |
| NG911 | Next Generation 911 | |
| PSAP | Public Safety Answering Point | |
| GPS Coordinates | Latitude/longitude location |
Lua Script Status ℹ️
No Dedicated Lua Handler
| Component | Status |
|---|
| Dispatch Locations | ℹ️ Configuration module - data used by Emergency Numbers handler |
---
Documentation last updated: January 2026
