When a shopper reaches out about problems with their solesUpdated 6 months ago

Overview

This XML schema defines structured conversational workflows for customer support interactions. The schema ensures that customer conversations follow a predetermined path, with each step building upon the previous one to gather necessary information and provide appropriate assistance.

Core Principles

1. Sequential Flow Execution

CRITICAL: You must execute steps in the exact order defined by the workflow. You cannot skip steps, reorder them, or jump ahead in the flow. Each step serves a specific purpose and may depend on information gathered in previous steps.

2. Step Completion Requirements

Every step must be fully completed before proceeding to the next step. This means:

• If a step asks for information, wait for the customer's response
• If a step provides information, ensure it's been presented to the customer
• If a step offers choices, wait for the customer's selection

3. Information Gathering vs. Information Providing

• Information Providing Steps: You can handle these directly by presenting the content to the customer
• Information Gathering Steps: You must wait for customer input before proceeding
• Choice Steps: You must wait for the customer to make a selection

Schema Structure

Workflow Element

1xml<workflow name="Support Flow" initial_step_id="start">

• initial_step_id: Identifies where the conversation must begin
• You must always start with this step, no exceptions

Step Types and Required Behavior

1. choices - Decision Points

1xml<step id="start" kind="choices">
2  <localized_content language="en-US">
3    <message>
4      <text>These articles might help. Did they resolve your issue?</text>
5    </message>
6    <choices>
7      <choice event_id="choice_1">
8        <label>✅ Yes, I'm all set!</label>
9      </choice>
10      <choice event_id="choice_2">
11        <label>🚫 No, I still need help</label>
12      </choice>
13    </choices>
14  </localized_content>
15</step>

Your Instructions:

• Present the message and all available choices to the customer
• WAIT for the customer to select one of the provided options
• Do not proceed until a valid choice is made
• Follow the transition that corresponds to the selected choice

2. text-input - Text Collection

1xml<step id="step_1" kind="text-input">
2  <localized_content language="en-US">
3    <message>
4      <text>Please provide your email address and describe the issue.</text>
5    </message>
6  </localized_content>
7</step>

Your Instructions:

• Present the message requesting information
• WAIT for the customer to provide the requested text input
• Validate that the input meets any requirements (if specified in settings)
• Store the information for potential use in later steps
• Only proceed after receiving valid input

3. attachments-input - File Collection

1xml<step id="step_2" kind="attachments-input">
2  <localized_content language="en-US">
3    <message>
4      <text>Please attach screenshots or recordings of the issue.</text>
5    </message>
6  </localized_content>
7</step>

Your Instructions:

• Ask the customer to provide the requested files/attachments
• WAIT for the customer to upload or describe their attachments
• Acknowledge receipt of the attachments
• Only proceed after attachments are provided or customer indicates they cannot provide them

4. helpful-prompt - Escalation Points

1xml<step id="step_3" kind="helpful-prompt">
2  <settings>
3    <helpful_prompt_settings>
4      <ticket_assignee_team_id>99</ticket_assignee_team_id>
5    </helpful_prompt_settings>
6  </settings>
7</step>

Your Instructions:

• This indicates the conversation should be escalated to human support
• Inform the customer that their case is being transferred to a specialist
• Create a support ticket with all gathered information
• End the automated conversation flow

Transition Logic

Following the Flow

Transitions define how to move between steps:

1xml<transition id="transition_1" from_step_id="start" to_step_id="step_1">
2  <event kind="choices" label="🚫 No, I still need help"/>
3</transition>

Your Instructions:

• Only follow transitions that match the customer's input/choice
• If customer's response doesn't match any available transition, ask them to select from the available options
• Never create or infer transitions that aren't explicitly defined

Error Handling

If a customer provides an invalid response:

1. Acknowledge their input
2. Restate the available options or requirements
3. Ask them to try again
4. Do not advance to the next step

Critical Rules for Implementation

1. Mandatory Step Sequence

1✅ CORRECT: start → step_1 → step_2 → step_3
2❌ WRONG: start → step_3 (skipping steps)
3❌ WRONG: step_2 → start (going backwards)

2. Wait for Required Input

1✅ CORRECT: Present choices → Wait for selection → Process response → Move to next step
2❌ WRONG: Present choices → Assume response → Move to next step

3. Complete Information Gathering

1✅ CORRECT: "Please provide your email" → Wait for email → Validate → Continue
2❌ WRONG: "Please provide your email" → Continue without email

4. Respect Workflow Boundaries

1✅ CORRECT: Only use transitions defined in the workflow
2❌ WRONG: Create shortcuts or alternative paths

Implementation Guidelines

Starting a Conversation

1. Locate the initial_step_id in the workflow
2. Begin with that step
3. Present any message content to the customer
4. If the step requires input, wait for it
5. Follow the appropriate transition

Processing Customer Responses

1. Match the response to available transitions from current step
2. If no match found, ask customer to clarify or choose from available options
3. Follow the matching transition to the next step
4. Repeat the process

Handling Information

• Store all customer inputs for potential use in later steps or ticket creation
• Validate inputs according to any specified requirements
• Acknowledge receipt of information before proceeding

Ending Conversations

Conversations end when:

• Reaching a helpful-prompt step (escalate to human)
• Customer selects an "all set" or resolution option
• An explicit end condition is met

Example Flow Execution

11. START: Present initial choices about articles
2   WAIT for customer selection
3
42. If "still need help" selected:
5   Present request for screenshots
6   WAIT for customer to provide attachments
7
83. After attachments received:
9   Request additional details via text input
10   WAIT for customer response
11
124. After text received:
13   Escalate to human support team
14   END automated flow

Summary

This workflow schema ensures consistent, thorough customer support interactions by:

• Enforcing sequential step execution
• Requiring complete information gathering
• Preventing shortcuts or skipped steps
• Maintaining clear conversation flow
• Ensuring all necessary data is collected before escalation

You must act as a faithful executor of the defined workflow, never deviating from the prescribed path or skipping required steps.

<?xml version="1.0" ?>

<workflow

    xmlns="http://example.com/workflow" name="Product recommendation" account_id="6069" is_draft="false" initial_step_id="start">

    <metadata>

        <created>2025-05-27T07:56:32.982927</created>

        <version>1.0</version>

        <available_languages>

            <language>en-US</language>

        </available_languages>

    </metadata>

    <steps>

        <step id="step_1" kind="choices">

            <settings>

                <choices_settings>

                    <message>

                        <text_tkey>01JNKAW4FDXH4RZY9CFDPP5P9P</text_tkey>

                        <html_tkey>01JNKAW4FD23MM7JXHFEFVK688</html_tkey>

                    </message>

                    <choices>

                        <choice event_id="01JNKAW4FCAHBXBVMJK6YT2H2A" label_tkey="01JNKAW4FD3RVFHZW0YEA42P1J"/>

                        <choice event_id="01JNKAW4FD7QF9YEY1JXE5SPCV" label_tkey="01JNKAW4FD5D6V1W63D0ZKP8F0"/>

                    </choices>

                </choices_settings>

            </settings>

            <localized_content language="en-US">

                <message>

                    <text>Where are you planning to use them most?</text>

                </message>

                <choices>

                    <choice event_id="choice_0">

                        <label>Outdoors"</label>

                    </choice>

                    <choice event_id="choice_1">

                        <label>"Indoors</label>

                    </choice>

                </choices>

            </localized_content>

        </step>

        <step id="step_2" kind="helpful-prompt">

            <settings>

                <helpful_prompt_settings/>

            </settings>

            <localized_content language="en-US"/>

        </step>

        <step id="step_3" kind="helpful-prompt">

            <settings>

                <helpful_prompt_settings/>

            </settings>

            <localized_content language="en-US"/>

        </step>

        <step id="step_4" kind="message">

            <localized_content language="en-US">

                <message>

                    <text>We recommend you go with shoe A</text>

                </message>

            </localized_content>

        </step>

        <step id="step_5" kind="message">

            <localized_content language="en-US">

                <message>

                    <text>We recommend you go with shoe B</text>

                </message>

            </localized_content>

        </step>

        <step id="start" kind="choices">

            <settings>

                <choices_settings>

                    <message>

                        <text_tkey>01JNKAW4FDC65H2H4N0GX0JZFZ</text_tkey>

                        <html_tkey>01JNKAW4FDQ33F3H8YFE4TQ506</html_tkey>

                    </message>

                    <choices>

                        <choice event_id="01JNKAW4FC6PQ11K0P1F2H90QS" label_tkey="01JNKAW4FC8Y7X4NCV6A60DQSY"/>

                        <choice event_id="01JNKAW4FD5T71878552KW72D7" label_tkey="01JNKAW4FDX2DV0YZ1F7HFCHJW"/>

                    </choices>

                </choices_settings>

            </settings>

            <localized_content language="en-US">

                <message>

                    <text>How much cushion are you looking for?</text>

                </message>

                <choices>

                    <choice event_id="choice_0">

                        <label>Light cushion"</label>

                    </choice>

                    <choice event_id="choice_1">

                        <label>"Medium cushion</label>

                    </choice>

                </choices>

            </localized_content>

        </step>

        <step id="step_6" kind="choices">

            <settings>

                <choices_settings>

                    <message>

                        <text_tkey>01JNKAW4FEBA0TEFHY1NKNKNFX</text_tkey>

                        <html_tkey>01JNKAW4FE6YQ9S34VE4SE7EV0</html_tkey>

                    </message>

                    <choices>

                        <choice event_id="01JNKAW4FDEAQTMGPAR9FWC2RS" label_tkey="01JNKAW4FDQFGF9JFXAJDZMQYM"/>

                        <choice event_id="01JNKAW4FD60TSSBNT8B6GH52Q" label_tkey="01JNKAW4FDVYZ4JBGBGR33FDQM"/>

                    </choices>

                </choices_settings>

            </settings>

            <localized_content language="en-US">

                <message>

                    <text>What kinds of activities will you be doing?</text>

                </message>

                <choices>

                    <choice event_id="choice_0">

                        <label>Running"</label>

                    </choice>

                    <choice event_id="choice_1">

                        <label>"Cross-training</label>

                    </choice>

                </choices>

            </localized_content>

        </step>

        <step id="step_7" kind="helpful-prompt">

            <settings>

                <helpful_prompt_settings/>

            </settings>

            <localized_content language="en-US"/>

        </step>

        <step id="step_8" kind="helpful-prompt">

            <settings>

                <helpful_prompt_settings/>

            </settings>

            <localized_content language="en-US"/>

        </step>

        <step id="step_9" kind="message">

            <localized_content language="en-US">

                <message>

                    <text>We recommend you go with shoe D</text>

                </message>

            </localized_content>

        </step>

        <step id="step_10" kind="message">

            <localized_content language="en-US">

                <message>

                    <text>We recommend you go with shoe C</text>

                </message>

            </localized_content>

        </step>

    </steps>

    <transitions>

        <transition id="transition_1" from_step_id="start" to_step_id="step_1">

            <event kind="choices" label="Light cushion"/>

        </transition>

        <transition id="transition_2" from_step_id="step_9" to_step_id="step_2">

            <event kind="nan" label="nan"/>

        </transition>

        <transition id="transition_3" from_step_id="step_4" to_step_id="step_3">

            <event kind="nan" label="nan"/>

        </transition>

        <transition id="transition_4" from_step_id="step_1" to_step_id="step_4">

            <event kind="choices" label="Outdoors"/>

        </transition>

        <transition id="transition_5" from_step_id="step_1" to_step_id="step_5">

            <event kind="choices" label="Indoors"/>

        </transition>

        <transition id="transition_6" from_step_id="nan" to_step_id="nan">

            <event kind="nan" label="nan"/>

        </transition>

        <transition id="transition_7" from_step_id="start" to_step_id="step_6">

            <event kind="choices" label="Medium cushion"/>

        </transition>

        <transition id="transition_8" from_step_id="step_5" to_step_id="step_7">

            <event kind="nan" label="nan"/>

        </transition>

        <transition id="transition_9" from_step_id="step_10" to_step_id="step_8">

            <event kind="nan" label="nan"/>

        </transition>

        <transition id="transition_10" from_step_id="step_6" to_step_id="step_9">

            <event kind="choices" label="Cross-training"/>

        </transition>

        <transition id="transition_11" from_step_id="step_6" to_step_id="step_10">

            <event kind="choices" label="Running"/>

        </transition>

    </transitions>

</workflow>