Prerequisites
- Infrastructure deployed (
npx cdk deploy) - Add-on updated with endpoint from CDK deployment
- Add-on deployed (
alexa-ai deploy) - Permissions granted (via QR code scan or directly in Alexa+ app)
- Phone number added to your profile in Alexa mobile app (required for MessageProfessional)
- Echo Show device (required for APL visuals, pro cards, profile selection)
Conversation Script — House Cleaning (Browse & Choose)
Operations Coverage
Supported Categories
Home Services supports dynamic categories via your service catalog (GetServices). Categories are not hardcoded — your catalog determines what’s available. The starter template comes with one example for “House Cleaning,” but you can expand to whatever home services categories you choose (for example, you can add a category for “TV Repair”). If you add a category, you also need to add a specification for that category. When Alexa sends a request to GetServiceSpecification for your new category, return a set of questions with the answers you support for that category so Alexa can ask customers. Sample utterances for testing (matching the “House Cleaning” category in the template):- “I need house cleaning”
- “Help me find a house cleaner”
- “I need help with house cleaning”
- “Alexa, my apartment needs cleaning. Help me find somebody”
Notes
- Problem-first routing: Alexa may ask the customer to provide more details about their problem before showing a list of professionals, if the original request does not contain sufficient details.
- Batched Q&A: Questions come from your service specification (GetServiceSpecification). Alexa may group questions together to help collect information needed from customers more quickly.
- Dynamic categories: Your service catalog can expose many categories via GetServices. The template includes “House Cleaning” as an example, but you can add any category your service supports.
- Profile setup: Make sure to set up your phone number, zip code, and address in the Alexa mobile app before testing to avoid caching stale data.
