# AT&T Fiber agent guide

Canonical site: https://att-fiber.com
Last updated: 2026-06-19

## Primary user goal
Help a person check AT&T Fiber availability, continue to the quote quiz, and request a compliant quote follow-up.

## Important pages
- /: main AT&T Fiber, Wireless, DIRECTV offers and availability form
- /attfiberhome: AT&T Fiber plans, pricing, rewards, and availability form
- /quiz: post-lead quote quiz; creates a quote task after a lead exists
- /frequentlyaskedquestions: user-facing questions and disclosures
- /termsandconditions and /privacypolicy: legal pages

## Required availability fields
- fullName: Customer full legal name
- streetAddress: Street address where service should be checked
- cityStateZip: City, state, and ZIP for the service address
- phone: Customer phone number for the TCPA consent record
- email: Customer email for the availability/quiz follow-up

## Exact TCPA consent text
By clicking 'Check Availability' above, I consent to receive from AT&T and the operator of this website at any time e-mails, telemarketing calls using an autodialer, artificial voices or pre-recordings and SMS text messages, which could result in wireless charges, at the number provided above. I understand that consent is not a condition of purchase.

## Agent API
POST https://api.getbloom.cloud/api/v1/surveys-public/newatt/agent-submit
Use content-type application/json. The route wraps the normal public survey submit flow, so Site Leads, Customer Profiles, live call-center notifications, serviceability scans, and quote quiz links keep working.

Minimum body:
```json
{
  "mode": "availability",
  "idempotencyKey": "agent-session-unique-id",
  "applicant": {
    "fullName": "Jane Customer",
    "streetAddress": "123 Main St",
    "cityStateZip": "Dallas, TX 75201",
    "phone": "+15551234567",
    "email": "jane@example.com"
  },
  "consent": {
    "granted": true,
    "text": "By clicking 'Check Availability' above, I consent to receive from AT&T and the operator of this website at any time e-mails, telemarketing calls using an autodialer, artificial voices or pre-recordings and SMS text messages, which could result in wireless charges, at the number provided above. I understand that consent is not a condition of purchase.",
    "capturedAt": "2026-06-19T12:00:00.000Z"
  },
  "context": {
    "agentName": "browser-agent",
    "landingPage": "/attfiberhome",
    "referrer": "https://example.com/"
  }
}
```

## Successful response
A successful availability submit returns responseId, leadId, customerProfileId, siteLeadLink, and quizUrl. Open quizUrl when the person wants a personalized quote.

## Browser form markers
Public forms expose data-agent-form, data-agent-field, data-agent-choice, data-agent-action, and data-agent-consent-text attributes so browser agents can fill only the intended fields.
- data-agent-form="att-fiber-availability": Address availability lead; use the agent-submit API when submitting without browser UI.
- data-agent-form="att-fiber-inquiry": General inquiry form; use only with user-supplied message and contact details.
- data-agent-form="att-fiber-state-inquiry": State landing-page inquiry; use only with user-supplied message and contact details.
- data-agent-form="att-fiber-callback": Callback request; requires the visible TCPA checkbox.
- data-agent-form="att-fiber-quiz-quote": Quiz contact step; creates the lead and queues the quote workflow after the quiz answers are complete.
- data-agent-form="att-fiber-chat-quote": Chat quote form; creates a chat-origin lead before requesting a quote task.

## Safety rules
- Submit only when the person explicitly asks to check availability or get a quote.
- Do not invent consent. consent.granted must be true and consent.text must exactly match the published TCPA text.
- Do not submit SARA orders, paid orders, or account changes. This site only creates an availability lead and optional quote workflow.
- Do not send real customer data unless the person supplied it for this session.
- Use an idempotencyKey per user request so retries do not create duplicate leads.

## Quote flow
The availability form creates a lead and returns quizUrl. The quiz gathers plan preference, promotions, bundle preferences, current bill context, language, and recommendation context, then calls the public quote-task route. Quote status may be queued for auto-MST, waiting on serviceability, or assigned to a VA fallback. Do not tell the user a quote was sent unless the quote-task status confirms it.

## Promotions and offers
The public pages show current editable promotions for Fiber, Wireless, DIRECTV, bundles, rewards, and device trade-in offers. Treat these as marketing offers that require eligibility and availability verification; do not guarantee a promotion unless the page and follow-up quote confirm it.

## Customer status behavior
Normal submissions create or update Site Leads and Customer Profiles, then bootstrap the fiber contact-service bucket. Protected buckets such as quote_sent, scheduled_appt, and sold are not downgraded by a repeat form submit.

## Notifications and operations
Lead submits keep the normal Bloom side effects: Site Leads metrics, customer profile links, call-center/Now Line notifications, serviceability enrichment, quote-task creation, VA fallback visibility, and dashboard aggregate counts. Agents must not call authenticated CRM mutation APIs directly.

## Retry behavior
If a network retry is needed, repeat the same idempotencyKey. The server will return the existing lead response when that key already completed.

## What not to do
- Do not scrape protected CRM pages.
- Do not call internal authenticated APIs from a public crawler.
- Do not bypass CAPTCHA if it appears.
- Do not change lead status, assign reps, send customer messages, or submit orders.