> ## Documentation Index
> Fetch the complete documentation index at: https://altostrat.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# E911 address validation campaign across the customer base

> Pull every active DID, cross-reference E911 registered addresses with the address validation database, identify mismatches, ask subscribers to re-attest, and produce the regulator-ready compliance report.

The state PUC requires the carrier to demonstrate that every DID has a current, validated E911 dispatchable address on file. The carrier owns 84,000 DIDs across 11,000 subscribers. The campaign has to find the gaps, get subscribers to fix them, and produce the evidence — quietly, without breaking emergency service for anyone.

## Systems involved

| System                            | Role                                                           |
| --------------------------------- | -------------------------------------------------------------- |
| Carrier billing / OSS             | Source list of active DIDs and the registered address per DID. |
| Intrado / Bandwidth E911 / RedSky | E911 registration system and address validation API.           |
| USPS / address validation API     | Authoritative address normalization.                           |
| Splynx / Sonar / homegrown CRM    | Subscriber contact lookup.                                     |
| Gmail / Outlook                   | Subscriber re-attestation request.                             |
| Twilio SMS                        | Reminder for non-responding subscribers.                       |
| Studio Procedures                 | `E911 validation campaign` runbook.                            |
| Files / SharePoint                | Compliance evidence pack.                                      |

## Walkthrough

<Steps>
  <Step title="Build the master DID + address join">
    Copilot pulls every active DID and joins to the registered E911 address from Intrado. The result is a row per DID with subscriber, location identifier, address-on-file, and last attestation date.
  </Step>

  <Step title="Validate addresses">
    Each address is sent through the USPS validation API in batches. Three classes come back: validated, validated-with-corrections, and unable-to-validate. Counts: 78,300 / 4,200 / 1,500.
  </Step>

  <Step title="Apply auto-corrections where safe">
    The 4,200 validated-with-corrections rows get a Markdown report listing the change. Routine corrections (zip-code +4, abbreviation expansion, casing) are auto-applied through Intrado after a sample review. Material changes go to subscriber re-attestation.
  </Step>

  <Step title="Subscriber re-attestation requests">
    For the 1,500 unable-to-validate and the material-change subset, Copilot drafts personalised emails through Gmail with the address on file, the proposed correction, and a one-click portal link to confirm. Sent in batches of 200 to avoid overwhelming support.
  </Step>

  <Step title="SMS reminders">
    After 7 days, Copilot finds subscribers who haven't responded and sends a Twilio SMS reminder. After 14 days, support follows up by phone.
  </Step>

  <Step title="Track responses">
    Each response updates the master campaign table. Copilot maintains a live dashboard with response rate by region, by tier, by DID type.
  </Step>

  <Step title="Handle non-responders carefully">
    For subscribers who have not responded by the deadline, the carrier must not break their 911 — the procedure flags them for a phone call from compliance, not a service suspension.
  </Step>

  <Step title="Produce the regulator pack">
    Generate the compliance artifact: total DIDs, validation breakdown, attestations received, evidence per subscriber, exceptions and remediation plan. PDF to the regulator and to the carrier's CCO.
  </Step>
</Steps>

## Where Studio earns its keep

* The DID list, the E911 registrations, and the validation API live in one workspace — no sequential exports across three systems.
* Subscriber re-attestation goes out personalised, with the actual data on the line, instead of as a generic "please verify your address" email.
* The non-responder workflow respects emergency service — the system does not casually disable 911 for someone who didn't open an email.
* The evidence pack is generated from the campaign state at any point in time, so the regulator's question is answered with a current PDF.

## Related

<CardGroup cols={2}>
  <Card title="Procedures" icon="workflow" href="../../procedures" arrow="true" cta="Run quarterly">
    `E911 validation campaign` runs every quarter against the current DID list.
  </Card>

  <Card title="Connectors and MCP" icon="plug" href="../../connectors-and-mcp" arrow="true" cta="Wire APIs">
    Intrado, USPS validation, Twilio, and Gmail as Copilot tools.
  </Card>
</CardGroup>
