Initial setup

  • Release version: Xanadu
  • Updated August 1, 2024
  • 3 minutes to read
  • This phase is meant to gather the initial information needed to successfully onboard a customer. For example, gathering core information such as onboarding manager, key customer contact, internal and external stakeholders, their responsibilities, and so on.

    Activity Details
    Select account When you select the customer account, a new account onboarding case is generated.
    Note:
    If the account onboarding case was generated from a case, this field is auto populated.

    Click Continue to go to the next activity.

    Enter onboarding related info The next activity in the playbook involves gathering onboarding related information. The mandatory fields to be entered are:
    • Assigned to: Select the provider agent who is working on this case.
    • Service Exchange integration: Select one of the following options:
      • Not required: No Service Exchange integration is required.
      • Remote catalog: A Service Exchange integration for the remote catalog feature is required.
      • Remote task: A Service Exchange integration for the remote task feature is required.
      • Foundation data sync: A Service Exchange integration for the foundation data sync feature is required.
    • Type: Select one of the following:
      • Phased: A specific part of the onboarding process for this customer is managed through this Account Lifecycle Events onboarding case.
      • Full: The entire onboarding process for this customer is by this Account Lifecycle Events onboarding case.
    • Specify the Go live date and select Mark complete to proceed with the next activity.
    Note:
    The State field is set to New for a new record. If this field is updated, the Stage field is automatically updated based on the predefined mapping. This mapping is also available for account onboarding case tasks between the Progress and State fields. See Field mapping for account onboarding cases and case tasks for details.
    Add customer team

    Add the customer contacts who will work on the account onboarding case.

    • Enter the First name, Last name, Email address and click Add to create a new customer contact.
    • Select Mark complete to move to the next step.
    Add customer team responsibilities Assign responsibilities to each of the customer contacts that have been added.
    • Select the Contact you’ve added in the previous step.
    • In the Responsibility field, select one of the predefined user roles and click Add to assign responsibility for the customer contact.
    • Click Mark complete to move to the next step.

    When this step is completed, two emails are automatically generated. The first email identifies the primary point of contact for the account onboarding case. The second email identifies the key team members participating in the onboarding process.

    Note:
    Users with the following responsibilities must be explicitly granted specific roles by the administrator:
    • Customer onboarding point of contact: Users with this responsibility must be granted the sn_customerservice.customer_admin role.
    • Key team members: Users who have key team member responsibilities must be granted the sn_customerservice.customer_case_manager role.
    Add account team Add and assign responsibilities to the internal team members (service providers) working on the account onboarding case. This includes the ServiceNow administrator handling the case. After the account is added, an email is sent to all the team members.
    • Select a predefined user role in the Responsibility field.
    • Select a user who is assigned this role and click Add to assign responsibility to the team member.
    • Click Mark complete to move to the next activity.
    Note:
    By default, all tasks in the playbook are assigned to the provider's ServiceNow administrator.
    Add squad Add the squad members who will be involved in completing the onboarding case and other activities. This is an optional activity.

    Click Mark complete to move to the next stage.

    After the Initial Setup stage has been completed, the case information, account, customer, and squad team member information you have added is displayed in the left panel.

    Field mapping for account onboarding cases and case tasks

    For account onboarding cases, when the Stage field is updated, the State field is automatically updated based on the mapping shown below:
    Table 1. Account onboarding case mapping between State and Stage fields
    State Default stage Available stages
    New Not started
    • Not started
    • At risk
    Unassigned Not started
    • Not started
    • At risk
    Active On track
    • On track
    • At risk
    Blocked Paused
    • Paused
    • At risk
    Closed Finished
    Canceled Finished
    For account onboarding case tasks, when the State field is updated, the Progress field is automatically updated based on the mapping shown below:
    Table 2. Account onboarding case task mapping between State and Progress fields
    State Default value Available options
    Open Not started
    Awaiting customer Paused
    • Paused
    • At risk
    Awaiting internal Paused
    • Paused
    • At risk
    In Progress On track
    • On track
    • At risk
    Review On track
    • On track
    • At risk
    Closed Finished
    Canceled Finished

    If you are using an earlier version of the Account Lifecycle Events application, follow the instructions in KB1651427 to correct the mapping between these fields.