digital-agent-phone-system-troubleshooting

digital-agent-phone-system-troubleshooting

Decision tree

Overview

Type
Decision tree
Entry
START
Questions
1
Outcomes
20
Author
Digital Agent
Last updated
2026-09-03

Full decision path

Start: START

START — Which phone system does the customer use?

Outcomes

Identify the phone system (OUT_ITGLUE)
Reached from START (D).
Troubleshoot network connectivity (OUT_NETWORK)
Reachable via multiple paths.
Troubleshoot VPN connectivity (OUT_VPN)
Reachable via multiple paths.
Refer to the Home User Troubleshooting Guide (OUT_HOME_GUIDE)
Reachable via multiple paths.
Switchvox user configuration issue (OUT_SW_USER)
Reachable via multiple paths.
Switchvox credential issue (OUT_SW_CREDENTIALS)
Reachable via multiple paths.
Switchvox hostname issue (OUT_SW_HOSTNAME)
Reachable via multiple paths.
Switchvox registration issue (OUT_REGISTRATION)
Reachable via multiple paths.
Escalate to Sangoma (OUT_SANGOMA)
Reachable via multiple paths.
Update the desktop softphone (OUT_SOFTPHONE_UPDATE)
Reachable via multiple paths.
Refer to the Softphone Troubleshooting Guide SOP (OUT_SOFTPHONE_SOP)
Reachable via multiple paths.
Refer to BroadSoft internal documentation (OUT_BS_DOCS)
Reachable via multiple paths.
Open a ticket with Weave (OUT_WEAVE)
Reachable via multiple paths.
Application issue (OUT_APPLICATION)
Reachable via multiple paths.
Individual user issue (OUT_INDIVIDUAL)
Reachable via multiple paths.
Provider or carrier issue (OUT_PROVIDER)
Reachable via multiple paths.
Escalate to Digital Agent Engineering (OUT_ENGINEERING)
Reachable via multiple paths.
Potential onsite truck roll (OUT_TRUCK_ROLL)
Reachable via multiple paths.
Phone may need replacement (OUT_PHONE_REPLACEMENT)
Reachable via multiple paths.
Issue Resolved (OUT_RESOLVED)
Reachable via multiple paths.

Machine-Readable JSON (Canonical Model)

View JSON
{
  "_meta": {
    "schema": "https://www.drawdecisiontree.com/decision-dag.schema.json",
    "source": "https://www.drawdecisiontree.com",
    "description": "DrawDecisionTree.com is a free tool for building, sharing, and embedding interactive decision trees. This file is the machine-readable export of a published decision tree. The `dsl` field contains the original source in the Decision DAG DSL; the `dag` schema is documented at the URL in `schema` above.",
    "links": {
      "interactive": "https://www.drawdecisiontree.com/trees/dasupport/voicetroubleshooting",
      "embed": "https://www.drawdecisiontree.com/embed/path/dasupport/voicetroubleshooting",
      "dsl_reference": "https://www.drawdecisiontree.com/decision-tree-dsl-reference",
      "guides": "https://www.drawdecisiontree.com/guides",
      "schema_docs": "https://www.drawdecisiontree.com/decision-dag.schema.json",
      "author_trees": "https://www.drawdecisiontree.com/trees/dasupport"
    },
    "generated_at": "2026-09-16T22:04:30.655Z"
  },
  "author": {
    "handle": "dasupport",
    "first_name": "Digital",
    "last_name": "Agent",
    "avatar_url": "https://lh3.googleusercontent.com/a/ACg8ocJf2utbt9DMoyUiJ7pmEU8nx5T-jHsDOSWn3sb5DESOSjrTdUvU=s96-c",
    "display_name": "Digital Agent"
  },
  "file": {
    "id": "8b88d258-a694-4b8f-9fea-87efdc7bf94c",
    "name": "digital-agent-phone-system-troubleshooting",
    "public_slug": "voicetroubleshooting",
    "updated_at": "2026-09-03T03:32:16.2887+00:00",
    "url": "https://www.drawdecisiontree.com/trees/dasupport/voicetroubleshooting",
    "json_url": "https://www.drawdecisiontree.com/trees/dasupport/voicetroubleshooting/tree.json",
    "dsl_url": "https://www.drawdecisiontree.com/trees/dasupport/voicetroubleshooting/tree.dag"
  },
  "meta": {
    "description": null,
    "mode": "decision",
    "entry": "START",
    "tags": [],
    "image": null
  },
  "questions": [
    {
      "id": "START",
      "text": "Which phone system does the customer use?"
    }
  ],
  "outcomes": [
    {
      "id": "OUT_ITGLUE",
      "label": "Identify the phone system"
    },
    {
      "id": "OUT_NETWORK",
      "label": "Troubleshoot network connectivity"
    },
    {
      "id": "OUT_VPN",
      "label": "Troubleshoot VPN connectivity"
    },
    {
      "id": "OUT_HOME_GUIDE",
      "label": "Refer to the Home User Troubleshooting Guide"
    },
    {
      "id": "OUT_SW_USER",
      "label": "Switchvox user configuration issue"
    },
    {
      "id": "OUT_SW_CREDENTIALS",
      "label": "Switchvox credential issue"
    },
    {
      "id": "OUT_SW_HOSTNAME",
      "label": "Switchvox hostname issue"
    },
    {
      "id": "OUT_REGISTRATION",
      "label": "Switchvox registration issue"
    },
    {
      "id": "OUT_SANGOMA",
      "label": "Escalate to Sangoma"
    },
    {
      "id": "OUT_SOFTPHONE_UPDATE",
      "label": "Update the desktop softphone"
    },
    {
      "id": "OUT_SOFTPHONE_SOP",
      "label": "Refer to the Softphone Troubleshooting Guide SOP"
    },
    {
      "id": "OUT_BS_DOCS",
      "label": "Refer to BroadSoft internal documentation"
    },
    {
      "id": "OUT_WEAVE",
      "label": "Open a ticket with Weave"
    },
    {
      "id": "OUT_APPLICATION",
      "label": "Application issue"
    },
    {
      "id": "OUT_INDIVIDUAL",
      "label": "Individual user issue"
    },
    {
      "id": "OUT_PROVIDER",
      "label": "Provider or carrier issue"
    },
    {
      "id": "OUT_ENGINEERING",
      "label": "Escalate to Digital Agent Engineering"
    },
    {
      "id": "OUT_TRUCK_ROLL",
      "label": "Potential onsite truck roll"
    },
    {
      "id": "OUT_PHONE_REPLACEMENT",
      "label": "Phone may need replacement"
    },
    {
      "id": "OUT_RESOLVED",
      "label": "Issue Resolved"
    }
  ],
  "dsl": "dag: digital-agent-phone-system-troubleshooting\nversion: 3.0.0\nentry: START\n\n\nSTART: Which phone system does the customer use?\n  hint: Check IT Glue > Voice/PBX Asset.\n  A: Switchvox  -> SW_USERS\n  B: BroadSoft  -> BS_USERS\n  C: Weave      -> WV_USERS\n  D: Unknown    -> OUT_ITGLUE\n\n\nSW_USERS: How many users are affected?\n  A: One user                  -> SW_DEVICE\n  B: Multiple users            -> SW_MULTI_USERS\n  C: Everyone at one location  -> SW_LOCATION\n  D: Multiple locations        -> SW_MULTI_LOCATION\n\n\nSW_DEVICE: Which Switchvox device is affected?\n  A: Physical phone    -> SW_PHONE_ISSUE\n  B: Mobile app        -> SW_MOBILE_USER\n  C: Desktop softphone -> SW_DESKTOP_HOSTNAME\n  D: Multiple devices  -> SW_MULTI_DEVICE\n\n\nSW_MULTI_DEVICE: Does the problem occur on every device the user has?\n  A: Yes -> OUT_INDIVIDUAL\n  B: No  -> SW_MULTI_DEVICE_TYPE\n\n\nSW_MULTI_DEVICE_TYPE: Which Switchvox device has the problem?\n  A: Physical phone    -> SW_PHONE_ISSUE\n  B: Mobile app        -> SW_MOBILE_USER\n  C: Desktop softphone -> SW_DESKTOP_HOSTNAME\n\n\nSW_PHONE_ISSUE: What is the physical phone issue?\n  A: Phone is not powering on          -> SW_PHONE_POWER\n  B: Phone is offline or unregistered  -> SW_PHONE_REBOOT\n  C: Cannot make outbound calls       -> SW_PHONE_REBOOT\n  D: Cannot receive inbound calls     -> SW_PHONE_REBOOT\n  E: No audio or one-way audio        -> SW_PHONE_REBOOT\n  F: Poor call quality                -> SW_PHONE_REBOOT\n  G: Calls dropping                   -> SW_PHONE_REBOOT\n  H: Voicemail problem                -> SW_PHONE_REBOOT\n  I: Transfer problem                 -> SW_PHONE_REBOOT\n  J: Other                             -> SW_PHONE_REBOOT\n\n\nSW_PHONE_POWER: Can the user try plugging the phone into a different location?\n  A: Yes -> SW_PHONE_POWER_TEST\n  B: No  -> SW_PHONE_CABLE\n\n\nSW_PHONE_POWER_TEST: Does the phone power on when plugged into the different location?\n  A: Yes -> OUT_TRUCK_ROLL\n  B: No  -> SW_PHONE_CABLE\n\n\nSW_PHONE_CABLE: Can the user try a different Ethernet/power cable?\n  A: Yes -> SW_PHONE_CABLE_TEST\n  B: No  -> OUT_SANGOMA\n\n\nSW_PHONE_CABLE_TEST: Does the phone power on with the new cable?\n  A: Yes -> OUT_RESOLVED\n  B: No  -> OUT_SANGOMA\n\n\nSW_PHONE_REBOOT: Reboot the Switchvox physical phone.\n  A: Problem resolved -> OUT_RESOLVED\n  B: Problem remains  -> SW_PHONE_RECONFIGURE\n\n\nSW_PHONE_RECONFIGURE: Reconfigure the Switchvox physical phone.\n  A: Problem resolved -> OUT_RESOLVED\n  B: Problem remains  -> SW_PHONE_FACTORY_RESET\n\n\nSW_PHONE_FACTORY_RESET: Factory reset the Switchvox physical phone.\n  A: Problem resolved -> OUT_RESOLVED\n  B: Problem remains  -> OUT_SANGOMA\n\n\nSW_MOBILE_USER: Is the user's email configured as a user in Switchvox?\n  A: Yes -> SW_MOBILE_CREDENTIALS\n  B: No  -> OUT_SW_USER\n\n\nSW_MOBILE_CREDENTIALS: Are the user's Switchvox credentials correct?\n  A: Yes -> SW_MOBILE_HOSTNAME\n  B: No  -> OUT_SW_CREDENTIALS\n\n\nSW_MOBILE_HOSTNAME: Is the correct Switchvox hostname configured?\n  A: Yes -> SW_MOBILE_NETWORK\n  B: No  -> OUT_SW_HOSTNAME\n\n\nSW_MOBILE_NETWORK: Is the user remote or at the office?\n  A: Remote -> SW_MOBILE_REMOTE\n  B: Office -> SW_MOBILE_OFFICE\n\n\nSW_MOBILE_REMOTE: Is the remote user connected to VPN?\n  A: Yes -> SW_MOBILE_VPN\n  B: No  -> OUT_HOME_GUIDE\n  C: VPN not required -> SW_MOBILE_STATUS\n\n\nSW_MOBILE_VPN: Can the user reach the Switchvox system through the VPN?\n  A: Yes -> SW_MOBILE_STATUS\n  B: No  -> OUT_VPN\n\n\nSW_MOBILE_OFFICE: Is the office device connected by wired Ethernet or Wi-Fi?\n  A: Wired -> SW_MOBILE_IP\n  B: Wi-Fi -> SW_MOBILE_IP\n\n\nSW_MOBILE_IP: Is the device receiving the correct office IP address?\n  A: Yes -> SW_MOBILE_STATUS\n  B: No  -> OUT_NETWORK\n\n\nSW_MOBILE_STATUS: What status does the Switchvox mobile app show?\n  hint: Normal statuses may include Ready or Registered. Problem statuses may include Unavailable, Unregistered, or another error/status.\n  A: Ready         -> SW_MOBILE_SYMPTOM\n  B: Registered    -> SW_MOBILE_SYMPTOM\n  C: Unavailable   -> SW_MOBILE_APP_REINSTALL\n  D: Unregistered  -> SW_MOBILE_APP_REINSTALL\n  E: Something else -> SW_MOBILE_APP_REINSTALL\n\n\nSW_MOBILE_SYMPTOM: What problem is the user experiencing?\n  A: Cannot make outbound calls   -> SW_MOBILE_OUTBOUND\n  B: Cannot receive inbound calls -> SW_MOBILE_INBOUND\n  C: No audio                     -> SW_MOBILE_AUDIO\n  D: One-way audio                -> SW_MOBILE_AUDIO\n  E: Notifications not working   -> SW_MOBILE_APP_REINSTALL\n  F: Other                         -> SW_MOBILE_APP_REINSTALL\n\n\nSW_MOBILE_OUTBOUND: Does inbound or outbound calling work on another device?\n  A: Yes, another device works             -> OUT_APPLICATION\n  B: No, another device also fails         -> OUT_ENGINEERING\n  C: User does not have another device     -> SW_MOBILE_OUTBOUND_OTHER\n\n\nSW_MOBILE_OUTBOUND_OTHER: Can another user at the same location make an outbound call?\n  A: Yes -> OUT_APPLICATION\n  B: No  -> OUT_PROVIDER\n\n\nSW_MOBILE_INBOUND: Does inbound calling work on another device?\n  A: Yes, another device works             -> OUT_APPLICATION\n  B: No, another device also fails         -> OUT_ENGINEERING\n  C: User does not have another device     -> SW_MOBILE_INBOUND_OTHER\n\n\nSW_MOBILE_INBOUND_OTHER: Can another user at the same location receive an inbound call?\n  A: Yes -> OUT_APPLICATION\n  B: No  -> OUT_PROVIDER\n\n\nSW_MOBILE_AUDIO: Check the microphone, speaker, headset, and device permissions.\n  A: Problem resolved -> OUT_RESOLVED\n  B: Problem remains  -> SW_MOBILE_APP_REINSTALL\n\n\nSW_MOBILE_APP_REINSTALL: Reinstall the Switchvox mobile app.\n  A: Problem resolved -> OUT_RESOLVED\n  B: Problem remains  -> SW_MOBILE_SIP\n\n\nSW_MOBILE_SIP: Change the SIP protocol for the extension in Switchvox to TCP/UDP.\n  A: Continue -> SW_MOBILE_REOPEN\n\n\nSW_MOBILE_REOPEN: Have the user completely close and reopen the Switchvox mobile app.\n  A: Problem resolved -> OUT_RESOLVED\n  B: Problem remains  -> OUT_SOFTPHONE_SOP\n\n\nSW_DESKTOP_HOSTNAME: Is the correct Switchvox hostname configured?\n  hint: The hostname check applies specifically to the Switchvox desktop softphone.\n  A: Yes -> SW_DESKTOP_NETWORK\n  B: No  -> OUT_SW_HOSTNAME\n\n\nSW_DESKTOP_NETWORK: Is the user remote or at the office?\n  A: Remote -> SW_DESKTOP_REMOTE\n  B: Office -> SW_DESKTOP_OFFICE\n\n\nSW_DESKTOP_REMOTE: Is the remote user connected to VPN?\n  A: Yes -> SW_DESKTOP_VPN\n  B: No  -> OUT_HOME_GUIDE\n  C: VPN not required -> SW_DESKTOP_CONNECT\n\n\nSW_DESKTOP_VPN: Can the user reach the Switchvox system through the VPN?\n  A: Yes -> SW_DESKTOP_CONNECT\n  B: No  -> OUT_VPN\n\n\nSW_DESKTOP_OFFICE: Is the office computer connected by wired Ethernet or Wi-Fi?\n  A: Wired -> SW_DESKTOP_IP\n  B: Wi-Fi -> SW_DESKTOP_IP\n\n\nSW_DESKTOP_IP: Is the computer receiving the correct office IP address?\n  A: Yes -> SW_DESKTOP_CONNECT\n  B: No  -> OUT_NETWORK\n\n\nSW_DESKTOP_CONNECT: Can the Switchvox desktop softphone connect successfully?\n  A: Yes -> SW_DESKTOP_RELOAD\n  B: No  -> SW_DESKTOP_RELOAD\n\n\nSW_DESKTOP_RELOAD: Click the Reload button in the Switchvox desktop softphone.\n  A: Problem resolved -> OUT_RESOLVED\n  B: Problem remains  -> SW_DESKTOP_LOGIN\n\n\nSW_DESKTOP_LOGIN: Log out of the desktop softphone and log back in.\n  A: Problem resolved -> OUT_RESOLVED\n  B: Problem remains  -> SW_DESKTOP_VERSION\n\n\nSW_DESKTOP_VERSION: Is the desktop softphone running the current version?\n  A: Yes -> SW_DESKTOP_SYMPTOM\n  B: No  -> OUT_SOFTPHONE_UPDATE\n\n\nSW_DESKTOP_SYMPTOM: What problem is the user experiencing?\n  A: Cannot make outbound calls   -> SW_DESKTOP_OUTBOUND\n  B: Cannot receive inbound calls -> SW_DESKTOP_INBOUND\n  C: No microphone audio           -> SW_DESKTOP_AUDIO\n  D: No speaker audio              -> SW_DESKTOP_AUDIO\n  E: One-way audio                -> SW_DESKTOP_AUDIO\n  F: Poor call quality             -> SW_DESKTOP_SIP\n  G: Calls dropping                -> SW_DESKTOP_SIP\n  H: Other application issue       -> SW_DESKTOP_SIP\n\n\nSW_DESKTOP_OUTBOUND: In Settings, what device is selected for making calls out?\n  A: Correct device -> SW_DESKTOP_SIP\n  B: Wrong device   -> SW_DESKTOP_DEVICE\n\n\nSW_DESKTOP_INBOUND: In Settings, what device is selected for making calls out?\n  A: Correct device -> SW_DESKTOP_SIP\n  B: Wrong device   -> SW_DESKTOP_DEVICE\n\n\nSW_DESKTOP_DEVICE: Select the correct device for making calls.\n  A: Problem resolved -> OUT_RESOLVED\n  B: Problem remains  -> SW_DESKTOP_SIP\n\n\nSW_DESKTOP_AUDIO: Check the computer microphone, speaker, headset, and application permissions.\n  A: Problem resolved -> OUT_RESOLVED\n  B: Problem remains  -> SW_DESKTOP_SIP\n\n\nSW_DESKTOP_SIP: What SIP protocol is currently configured?\n  A: UDP -> SW_DESKTOP_TCP\n  B: TCP -> SW_DESKTOP_UDP\n  C: Already tested both -> OUT_SOFTPHONE_SOP\n\n\nSW_DESKTOP_TCP: Change the desktop softphone SIP protocol from UDP to TCP.\n  A: Continue -> SW_DESKTOP_TEST\n\n\nSW_DESKTOP_UDP: Change the desktop softphone SIP protocol from TCP to UDP.\n  A: Continue -> SW_DESKTOP_TEST\n\n\nSW_DESKTOP_TEST: Test the desktop softphone after changing the SIP protocol.\n  A: Problem resolved -> OUT_RESOLVED\n  B: Problem remains -> OUT_SOFTPHONE_SOP\n\n\nSW_MULTI_USERS: Are multiple Switchvox users experiencing the same issue?\n  A: Yes -> SW_MULTI_NETWORK\n  B: No  -> OUT_INDIVIDUAL\n\n\nSW_MULTI_NETWORK: Do the affected users share the same location or network?\n  A: Yes -> SW_MULTI_LOCATION_SCOPE\n  B: No  -> SW_MULTI_GOOD_USER\n\n\nSW_MULTI_LOCATION_SCOPE: Is the issue limited to that location or network?\n  A: Yes -> OUT_NETWORK\n  B: No  -> SW_MULTI_GOOD_USER\n\n\nSW_MULTI_GOOD_USER: Can a known-good Switchvox user make and receive calls?\n  A: Yes -> OUT_INDIVIDUAL\n  B: No  -> OUT_ENGINEERING\n\n\nSW_LOCATION: Are the Switchvox phones powered and connected to the network?\n  A: Yes -> SW_LOCATION_REGISTERED\n  B: No  -> OUT_NETWORK\n\n\nSW_LOCATION_REGISTERED: Are the Switchvox phones registered?\n  A: Yes -> SW_LOCATION_INTERNAL\n  B: No  -> OUT_REGISTRATION\n\n\nSW_LOCATION_INTERNAL: Can users make internal calls?\n  A: Yes -> SW_LOCATION_OUTBOUND\n  B: No  -> OUT_ENGINEERING\n\n\nSW_LOCATION_OUTBOUND: Can users make outbound calls?\n  A: Yes -> SW_LOCATION_INBOUND\n  B: No  -> OUT_PROVIDER\n\n\nSW_LOCATION_INBOUND: Can users receive inbound calls?\n  A: Yes -> OUT_RESOLVED\n  B: No  -> OUT_PROVIDER\n\n\nSW_MULTI_LOCATION: Are multiple locations experiencing the same Switchvox issue?\n  A: Yes -> SW_MULTI_LOC_TEST\n  B: No  -> SW_LOCATION\n\n\nSW_MULTI_LOC_TEST: Can any location make or receive calls?\n  A: Yes -> SW_MULTI_LOC_GOOD\n  B: No  -> OUT_PROVIDER\n\n\nSW_MULTI_LOC_GOOD: Can a known-good Switchvox user make and receive calls?\n  A: Yes -> OUT_INDIVIDUAL\n  B: No  -> OUT_ENGINEERING\n\n\n\nBS_USERS: How many users are affected?\n  A: One user                  -> BS_DEVICE\n  B: Multiple users            -> OUT_BS_DOCS\n  C: Everyone at one location  -> OUT_BS_DOCS\n  D: Multiple locations        -> OUT_BS_DOCS\n\n\nBS_DEVICE: Which BroadSoft device is affected?\n  A: Physical phone       -> BS_PHONE_REGISTERED\n  B: Desktop application  -> OUT_BS_DOCS\n  C: Multiple devices     -> OUT_BS_DOCS\n  D: Other                -> OUT_BS_DOCS\n\n\nBS_PHONE_REGISTERED: Is the phone registered in BroadSoft?\n  hint: Go to Extension > Utilities > Registration.\n  A: Yes -> OUT_BS_DOCS\n  B: No  -> BS_PHONE_POWER\n\n\nBS_PHONE_POWER: Is the phone powering on?\n  A: Yes -> BS_PHONE_IP\n  B: No  -> BS_PHONE_POWER_LOCATION\n\n\nBS_PHONE_POWER_LOCATION: Can the user plug the phone into a location where there is known power?\n  A: Yes -> BS_PHONE_POWER_TEST\n  B: No  -> BS_PHONE_CABLE\n\n\nBS_PHONE_POWER_TEST: Does the phone power on in the new location?\n  A: Yes -> BS_PHONE_IP\n  B: No  -> BS_PHONE_CABLE\n\n\nBS_PHONE_CABLE: Can the user try a new cable?\n  A: Yes -> BS_PHONE_CABLE_TEST\n  B: No  -> BS_PHONE_WARRANTY\n\n\nBS_PHONE_CABLE_TEST: Does the phone power on with the new cable?\n  A: Yes -> BS_PHONE_IP\n  B: No  -> BS_PHONE_WARRANTY\n\n\nBS_PHONE_WARRANTY: Is the phone under warranty or HaaS?\n  A: Yes -> OUT_PHONE_REPLACEMENT\n  B: No  -> OUT_PHONE_REPLACEMENT\n\n\nBS_PHONE_IP: Can the user provide the IP address of the phone?\n  A: Yes -> BS_PHONE_MAC\n  B: No  -> OUT_BS_DOCS\n\n\nBS_PHONE_MAC: Can the user provide the MAC address of the phone?\n  A: Yes -> BS_PHONE_PING\n  B: No  -> OUT_BS_DOCS\n\n\nBS_PHONE_PING: Can the phone's IP address be pinged from the Edgewater firewall?\n  A: Yes -> BS_PHONE_NAT\n  B: No  -> OUT_BS_DOCS\n\n\nBS_PHONE_NAT: Create a NAT port forward and attempt to log into the phone.\n  A: Continue -> OUT_BS_DOCS\n\n\n\nWV_USERS: How many users are affected?\n  A: One user                  -> WV_DEVICE\n  B: Multiple users            -> OUT_WEAVE\n  C: Everyone at one location  -> OUT_WEAVE\n  D: Multiple locations        -> OUT_WEAVE\n\n\nWV_DEVICE: Which Weave device is affected?\n  A: Physical phone       -> WV_PHONE_ISSUE\n  B: Mobile app           -> WV_MOBILE_USER\n  C: Desktop application  -> WV_DESKTOP_USER\n  D: Multiple devices     -> OUT_WEAVE\n\n\nWV_PHONE_ISSUE: What is the Weave physical phone problem?\n  A: No power or phone is off       -> WV_PHONE_REBOOT\n  B: Phone is offline               -> WV_PHONE_REBOOT\n  C: Cannot make outbound calls     -> WV_PHONE_REBOOT\n  D: Cannot receive inbound calls   -> WV_PHONE_REBOOT\n  E: Audio or one-way audio         -> WV_PHONE_REBOOT\n  F: Poor call quality              -> WV_PHONE_REBOOT\n  G: Calls dropping                 -> WV_PHONE_REBOOT\n  H: Other                           -> WV_PHONE_REBOOT\n\n\nWV_PHONE_REBOOT: Reboot the Weave physical phone.\n  A: Problem resolved -> OUT_RESOLVED\n  B: Problem remains  -> WV_PHONE_NETWORK\n\n\nWV_PHONE_NETWORK: Check the Weave phone's power and network connection.\n  A: Problem resolved -> OUT_RESOLVED\n  B: Problem remains  -> OUT_WEAVE\n\n\nWV_MOBILE_USER: Is the user's email configured as a user in Weave?\n  A: Yes -> WV_MOBILE_PERMISSIONS\n  B: No  -> OUT_WEAVE\n\n\nWV_MOBILE_PERMISSIONS: Does the user have the correct permissions in Weave?\n  A: Yes -> WV_MOBILE_NETWORK\n  B: No  -> OUT_WEAVE\n\n\nWV_MOBILE_NETWORK: Is the user remote or at the office?\n  A: Remote -> WV_MOBILE_REMOTE\n  B: Office -> WV_MOBILE_OFFICE\n\n\nWV_MOBILE_REMOTE: Is the remote user connected to VPN?\n  A: Yes -> WV_MOBILE_VPN\n  B: No  -> WV_MOBILE_SYMPTOM\n  C: VPN not required -> WV_MOBILE_SYMPTOM\n\n\nWV_MOBILE_VPN: Can the user reach Weave through the VPN?\n  A: Yes -> WV_MOBILE_SYMPTOM\n  B: No  -> OUT_VPN\n\n\nWV_MOBILE_OFFICE: Is the office device connected by wired Ethernet or Wi-Fi?\n  A: Wired -> WV_MOBILE_IP\n  B: Wi-Fi -> WV_MOBILE_IP\n\n\nWV_MOBILE_IP: Is the device receiving the correct office IP address?\n  A: Yes -> WV_MOBILE_SYMPTOM\n  B: No  -> OUT_NETWORK\n\n\nWV_MOBILE_SYMPTOM: What problem is the user experiencing?\n  A: Cannot make outbound calls   -> OUT_WEAVE\n  B: Cannot receive inbound calls -> OUT_WEAVE\n  C: No audio                    -> OUT_WEAVE\n  D: One-way audio               -> OUT_WEAVE\n  E: Notifications not working   -> OUT_WEAVE\n  F: Other                        -> OUT_WEAVE\n\n\nWV_DESKTOP_USER: Does the Weave desktop application open successfully?\n  A: Yes -> WV_DESKTOP_NETWORK\n  B: No  -> OUT_WEAVE\n\n\nWV_DESKTOP_NETWORK: Is the user remote or at the office?\n  A: Remote -> WV_DESKTOP_REMOTE\n  B: Office -> WV_DESKTOP_OFFICE\n\n\nWV_DESKTOP_REMOTE: Is the remote user connected to VPN?\n  A: Yes -> WV_DESKTOP_VPN\n  B: No  -> WV_DESKTOP_CONNECT\n  C: VPN not required -> WV_DESKTOP_CONNECT\n\n\nWV_DESKTOP_VPN: Can the user reach Weave through the VPN?\n  A: Yes -> WV_DESKTOP_CONNECT\n  B: No  -> OUT_VPN\n\n\nWV_DESKTOP_OFFICE: Is the office computer connected by wired Ethernet or Wi-Fi?\n  A: Wired -> WV_DESKTOP_IP\n  B: Wi-Fi -> WV_DESKTOP_IP\n\n\nWV_DESKTOP_IP: Is the computer receiving the correct office IP address?\n  A: Yes -> WV_DESKTOP_CONNECT\n  B: No  -> OUT_NETWORK\n\n\nWV_DESKTOP_CONNECT: Can the Weave desktop application connect successfully?\n  A: Yes -> WV_DESKTOP_SYMPTOM\n  B: No  -> OUT_WEAVE\n\n\nWV_DESKTOP_SYMPTOM: What problem is the user experiencing?\n  A: Cannot make outbound calls   -> OUT_WEAVE\n  B: Cannot receive inbound calls -> OUT_WEAVE\n  C: No microphone audio           -> WV_DESKTOP_AUDIO\n  D: No speaker audio              -> WV_DESKTOP_AUDIO\n  E: One-way audio                -> WV_DESKTOP_AUDIO\n  F: Poor call quality             -> OUT_WEAVE\n  G: Calls dropping                -> OUT_WEAVE\n  H: Other                         -> OUT_WEAVE\n\n\nWV_DESKTOP_AUDIO: Check the computer microphone, speaker, headset, and application permissions.\n  A: Problem resolved -> OUT_RESOLVED\n  B: Problem remains  -> OUT_WEAVE\n\n\n\n[OUT_ITGLUE]: Identify the phone system\n  description: Go to IT Glue > Voice/PBX Asset and identify whether the customer uses Switchvox, BroadSoft, or Weave.\n  code: CHECK_ITGLUE\n\n\n[OUT_NETWORK]: Troubleshoot network connectivity\n  description: Verify the correct IP address, DHCP, VLAN, switch connectivity, Wi-Fi or Ethernet connectivity, and internet connectivity.\n  code: CHECK_NETWORK\n\n\n[OUT_VPN]: Troubleshoot VPN connectivity\n  description: Verify VPN connectivity and the user's ability to reach the phone system.\n  code: CHECK_VPN\n\n\n[OUT_HOME_GUIDE]: Refer to the Home User Troubleshooting Guide\n  description: Identify the remote user's internet provider and follow the Home User Troubleshooting Guide for remote users.\n  code: HOME_USER_GUIDE\n\n\n[OUT_SW_USER]: Switchvox user configuration issue\n  description: Verify the user's email exists as a user in Switchvox and is associated with the correct extension.\n  code: CHECK_SW_USER\n\n\n[OUT_SW_CREDENTIALS]: Switchvox credential issue\n  description: Verify the user's Switchvox credentials and account status.\n  code: CHECK_SW_CREDENTIALS\n\n\n[OUT_SW_HOSTNAME]: Switchvox hostname issue\n  description: Verify the application is configured with the correct Switchvox hostname or server.\n  code: CHECK_SW_HOSTNAME\n\n\n[OUT_REGISTRATION]: Switchvox registration issue\n  description: Verify extension configuration, credentials, provisioning, network connectivity, and phone system status.\n  code: CHECK_REGISTRATION\n\n\n[OUT_SANGOMA]: Escalate to Sangoma\n  description: Reboot, reconfigure, and factory reset have been attempted. Open a support ticket with Sangoma. If the phone is out of warranty, determine whether a replacement phone is needed.\n  code: SANGOMA_TICKET\n\n\n[OUT_SOFTPHONE_UPDATE]: Update the desktop softphone\n  description: Install the current available version, restart the application, and test again.\n  code: UPDATE_SOFTPHONE\n\n\n[OUT_SOFTPHONE_SOP]: Refer to the Softphone Troubleshooting Guide SOP\n  description: Open the internal documents and follow the Softphone Troubleshooting Guide SOP for additional troubleshooting.\n  code: SOFTPHONE_SOP\n\n\n[OUT_BS_DOCS]: Refer to BroadSoft internal documentation\n  description: Go to IT Glue > Voice/Data and follow the applicable BroadSoft troubleshooting documentation.\n  code: BROADSOFT_DOCS\n\n\n[OUT_WEAVE]: Open a ticket with Weave\n  description: Open a support ticket at weavehelp.com. Include the customer, location, affected user, phone or device, phone number or extension, exact symptoms, timestamps, and troubleshooting already performed.\n  code: WEAVE_TICKET\n\n\n[OUT_APPLICATION]: Application issue\n  description: The issue appears isolated to the user's application or device. Continue with the applicable application troubleshooting procedure.\n  code: APPLICATION_ISSUE\n\n\n[OUT_INDIVIDUAL]: Individual user issue\n  description: The issue appears isolated to one user or one user's device. Continue with individual user troubleshooting.\n  code: INDIVIDUAL_USER\n\n\n[OUT_PROVIDER]: Provider or carrier issue\n  description: Document affected numbers, extensions, call direction, timestamps, symptoms, and troubleshooting performed before contacting the provider.\n  code: PROVIDER_ISSUE\n\n\n[OUT_ENGINEERING]: Escalate to Digital Agent Engineering\n  description: Document the customer, location, phone system, affected users, extensions, devices, exact symptoms, tests performed, results, and changes made.\n  code: ENGINEERING_ESCALATION\n\n\n[OUT_TRUCK_ROLL]: Potential onsite truck roll\n  description: The phone works from a different location, indicating the original network port may not be working. Message the All Support Teams chat for truck roll assistance.\n  code: TRUCK_ROLL\n\n\n[OUT_PHONE_REPLACEMENT]: Phone may need replacement\n  description: Check whether the phone is under warranty or HaaS. If applicable, proceed with replacement. If not covered, determine whether a new phone needs to be purchased.\n  code: PHONE_REPLACEMENT\n\n\n[OUT_RESOLVED]: Issue Resolved\n  description: Test the affected function one final time and document the resolution in the ticket.\n  code: RESOLVED\n  "
}

DSL Representation

dag: digital-agent-phone-system-troubleshooting
version: 3.0.0
entry: START


START: Which phone system does the customer use?
  hint: Check IT Glue > Voice/PBX Asset.
  A: Switchvox  -> SW_USERS
  B: BroadSoft  -> BS_USERS
  C: Weave      -> WV_USERS
  D: Unknown    -> OUT_ITGLUE


SW_USERS: How many users are affected?
  A: One user                  -> SW_DEVICE
  B: Multiple users            -> SW_MULTI_USERS
  C: Everyone at one location  -> SW_LOCATION
  D: Multiple locations        -> SW_MULTI_LOCATION


SW_DEVICE: Which Switchvox device is affected?
  A: Physical phone    -> SW_PHONE_ISSUE
  B: Mobile app        -> SW_MOBILE_USER
  C: Desktop softphone -> SW_DESKTOP_HOSTNAME
  D: Multiple devices  -> SW_MULTI_DEVICE


SW_MULTI_DEVICE: Does the problem occur on every device the user has?
  A: Yes -> OUT_INDIVIDUAL
  B: No  -> SW_MULTI_DEVICE_TYPE


SW_MULTI_DEVICE_TYPE: Which Switchvox device has the problem?
  A: Physical phone    -> SW_PHONE_ISSUE
  B: Mobile app        -> SW_MOBILE_USER
  C: Desktop softphone -> SW_DESKTOP_HOSTNAME


SW_PHONE_ISSUE: What is the physical phone issue?
  A: Phone is not powering on          -> SW_PHONE_POWER
  B: Phone is offline or unregistered  -> SW_PHONE_REBOOT
  C: Cannot make outbound calls       -> SW_PHONE_REBOOT
  D: Cannot receive inbound calls     -> SW_PHONE_REBOOT
  E: No audio or one-way audio        -> SW_PHONE_REBOOT
  F: Poor call quality                -> SW_PHONE_REBOOT
  G: Calls dropping                   -> SW_PHONE_REBOOT
  H: Voicemail problem                -> SW_PHONE_REBOOT
  I: Transfer problem                 -> SW_PHONE_REBOOT
  J: Other                             -> SW_PHONE_REBOOT


SW_PHONE_POWER: Can the user try plugging the phone into a different location?
  A: Yes -> SW_PHONE_POWER_TEST
  B: No  -> SW_PHONE_CABLE


SW_PHONE_POWER_TEST: Does the phone power on when plugged into the different location?
  A: Yes -> OUT_TRUCK_ROLL
  B: No  -> SW_PHONE_CABLE


SW_PHONE_CABLE: Can the user try a different Ethernet/power cable?
  A: Yes -> SW_PHONE_CABLE_TEST
  B: No  -> OUT_SANGOMA


SW_PHONE_CABLE_TEST: Does the phone power on with the new cable?
  A: Yes -> OUT_RESOLVED
  B: No  -> OUT_SANGOMA


SW_PHONE_REBOOT: Reboot the Switchvox physical phone.
  A: Problem resolved -> OUT_RESOLVED
  B: Problem remains  -> SW_PHONE_RECONFIGURE


SW_PHONE_RECONFIGURE: Reconfigure the Switchvox physical phone.
  A: Problem resolved -> OUT_RESOLVED
  B: Problem remains  -> SW_PHONE_FACTORY_RESET


SW_PHONE_FACTORY_RESET: Factory reset the Switchvox physical phone.
  A: Problem resolved -> OUT_RESOLVED
  B: Problem remains  -> OUT_SANGOMA


SW_MOBILE_USER: Is the user's email configured as a user in Switchvox?
  A: Yes -> SW_MOBILE_CREDENTIALS
  B: No  -> OUT_SW_USER


SW_MOBILE_CREDENTIALS: Are the user's Switchvox credentials correct?
  A: Yes -> SW_MOBILE_HOSTNAME
  B: No  -> OUT_SW_CREDENTIALS


SW_MOBILE_HOSTNAME: Is the correct Switchvox hostname configured?
  A: Yes -> SW_MOBILE_NETWORK
  B: No  -> OUT_SW_HOSTNAME


SW_MOBILE_NETWORK: Is the user remote or at the office?
  A: Remote -> SW_MOBILE_REMOTE
  B: Office -> SW_MOBILE_OFFICE


SW_MOBILE_REMOTE: Is the remote user connected to VPN?
  A: Yes -> SW_MOBILE_VPN
  B: No  -> OUT_HOME_GUIDE
  C: VPN not required -> SW_MOBILE_STATUS


SW_MOBILE_VPN: Can the user reach the Switchvox system through the VPN?
  A: Yes -> SW_MOBILE_STATUS
  B: No  -> OUT_VPN


SW_MOBILE_OFFICE: Is the office device connected by wired Ethernet or Wi-Fi?
  A: Wired -> SW_MOBILE_IP
  B: Wi-Fi -> SW_MOBILE_IP


SW_MOBILE_IP: Is the device receiving the correct office IP address?
  A: Yes -> SW_MOBILE_STATUS
  B: No  -> OUT_NETWORK


SW_MOBILE_STATUS: What status does the Switchvox mobile app show?
  hint: Normal statuses may include Ready or Registered. Problem statuses may include Unavailable, Unregistered, or another error/status.
  A: Ready         -> SW_MOBILE_SYMPTOM
  B: Registered    -> SW_MOBILE_SYMPTOM
  C: Unavailable   -> SW_MOBILE_APP_REINSTALL
  D: Unregistered  -> SW_MOBILE_APP_REINSTALL
  E: Something else -> SW_MOBILE_APP_REINSTALL


SW_MOBILE_SYMPTOM: What problem is the user experiencing?
  A: Cannot make outbound calls   -> SW_MOBILE_OUTBOUND
  B: Cannot receive inbound calls -> SW_MOBILE_INBOUND
  C: No audio                     -> SW_MOBILE_AUDIO
  D: One-way audio                -> SW_MOBILE_AUDIO
  E: Notifications not working   -> SW_MOBILE_APP_REINSTALL
  F: Other                         -> SW_MOBILE_APP_REINSTALL


SW_MOBILE_OUTBOUND: Does inbound or outbound calling work on another device?
  A: Yes, another device works             -> OUT_APPLICATION
  B: No, another device also fails         -> OUT_ENGINEERING
  C: User does not have another device     -> SW_MOBILE_OUTBOUND_OTHER


SW_MOBILE_OUTBOUND_OTHER: Can another user at the same location make an outbound call?
  A: Yes -> OUT_APPLICATION
  B: No  -> OUT_PROVIDER


SW_MOBILE_INBOUND: Does inbound calling work on another device?
  A: Yes, another device works             -> OUT_APPLICATION
  B: No, another device also fails         -> OUT_ENGINEERING
  C: User does not have another device     -> SW_MOBILE_INBOUND_OTHER


SW_MOBILE_INBOUND_OTHER: Can another user at the same location receive an inbound call?
  A: Yes -> OUT_APPLICATION
  B: No  -> OUT_PROVIDER


SW_MOBILE_AUDIO: Check the microphone, speaker, headset, and device permissions.
  A: Problem resolved -> OUT_RESOLVED
  B: Problem remains  -> SW_MOBILE_APP_REINSTALL


SW_MOBILE_APP_REINSTALL: Reinstall the Switchvox mobile app.
  A: Problem resolved -> OUT_RESOLVED
  B: Problem remains  -> SW_MOBILE_SIP


SW_MOBILE_SIP: Change the SIP protocol for the extension in Switchvox to TCP/UDP.
  A: Continue -> SW_MOBILE_REOPEN


SW_MOBILE_REOPEN: Have the user completely close and reopen the Switchvox mobile app.
  A: Problem resolved -> OUT_RESOLVED
  B: Problem remains  -> OUT_SOFTPHONE_SOP


SW_DESKTOP_HOSTNAME: Is the correct Switchvox hostname configured?
  hint: The hostname check applies specifically to the Switchvox desktop softphone.
  A: Yes -> SW_DESKTOP_NETWORK
  B: No  -> OUT_SW_HOSTNAME


SW_DESKTOP_NETWORK: Is the user remote or at the office?
  A: Remote -> SW_DESKTOP_REMOTE
  B: Office -> SW_DESKTOP_OFFICE


SW_DESKTOP_REMOTE: Is the remote user connected to VPN?
  A: Yes -> SW_DESKTOP_VPN
  B: No  -> OUT_HOME_GUIDE
  C: VPN not required -> SW_DESKTOP_CONNECT


SW_DESKTOP_VPN: Can the user reach the Switchvox system through the VPN?
  A: Yes -> SW_DESKTOP_CONNECT
  B: No  -> OUT_VPN


SW_DESKTOP_OFFICE: Is the office computer connected by wired Ethernet or Wi-Fi?
  A: Wired -> SW_DESKTOP_IP
  B: Wi-Fi -> SW_DESKTOP_IP


SW_DESKTOP_IP: Is the computer receiving the correct office IP address?
  A: Yes -> SW_DESKTOP_CONNECT
  B: No  -> OUT_NETWORK


SW_DESKTOP_CONNECT: Can the Switchvox desktop softphone connect successfully?
  A: Yes -> SW_DESKTOP_RELOAD
  B: No  -> SW_DESKTOP_RELOAD


SW_DESKTOP_RELOAD: Click the Reload button in the Switchvox desktop softphone.
  A: Problem resolved -> OUT_RESOLVED
  B: Problem remains  -> SW_DESKTOP_LOGIN


SW_DESKTOP_LOGIN: Log out of the desktop softphone and log back in.
  A: Problem resolved -> OUT_RESOLVED
  B: Problem remains  -> SW_DESKTOP_VERSION


SW_DESKTOP_VERSION: Is the desktop softphone running the current version?
  A: Yes -> SW_DESKTOP_SYMPTOM
  B: No  -> OUT_SOFTPHONE_UPDATE


SW_DESKTOP_SYMPTOM: What problem is the user experiencing?
  A: Cannot make outbound calls   -> SW_DESKTOP_OUTBOUND
  B: Cannot receive inbound calls -> SW_DESKTOP_INBOUND
  C: No microphone audio           -> SW_DESKTOP_AUDIO
  D: No speaker audio              -> SW_DESKTOP_AUDIO
  E: One-way audio                -> SW_DESKTOP_AUDIO
  F: Poor call quality             -> SW_DESKTOP_SIP
  G: Calls dropping                -> SW_DESKTOP_SIP
  H: Other application issue       -> SW_DESKTOP_SIP


SW_DESKTOP_OUTBOUND: In Settings, what device is selected for making calls out?
  A: Correct device -> SW_DESKTOP_SIP
  B: Wrong device   -> SW_DESKTOP_DEVICE


SW_DESKTOP_INBOUND: In Settings, what device is selected for making calls out?
  A: Correct device -> SW_DESKTOP_SIP
  B: Wrong device   -> SW_DESKTOP_DEVICE


SW_DESKTOP_DEVICE: Select the correct device for making calls.
  A: Problem resolved -> OUT_RESOLVED
  B: Problem remains  -> SW_DESKTOP_SIP


SW_DESKTOP_AUDIO: Check the computer microphone, speaker, headset, and application permissions.
  A: Problem resolved -> OUT_RESOLVED
  B: Problem remains  -> SW_DESKTOP_SIP


SW_DESKTOP_SIP: What SIP protocol is currently configured?
  A: UDP -> SW_DESKTOP_TCP
  B: TCP -> SW_DESKTOP_UDP
  C: Already tested both -> OUT_SOFTPHONE_SOP


SW_DESKTOP_TCP: Change the desktop softphone SIP protocol from UDP to TCP.
  A: Continue -> SW_DESKTOP_TEST


SW_DESKTOP_UDP: Change the desktop softphone SIP protocol from TCP to UDP.
  A: Continue -> SW_DESKTOP_TEST


SW_DESKTOP_TEST: Test the desktop softphone after changing the SIP protocol.
  A: Problem resolved -> OUT_RESOLVED
  B: Problem remains -> OUT_SOFTPHONE_SOP


SW_MULTI_USERS: Are multiple Switchvox users experiencing the same issue?
  A: Yes -> SW_MULTI_NETWORK
  B: No  -> OUT_INDIVIDUAL


SW_MULTI_NETWORK: Do the affected users share the same location or network?
  A: Yes -> SW_MULTI_LOCATION_SCOPE
  B: No  -> SW_MULTI_GOOD_USER


SW_MULTI_LOCATION_SCOPE: Is the issue limited to that location or network?
  A: Yes -> OUT_NETWORK
  B: No  -> SW_MULTI_GOOD_USER


SW_MULTI_GOOD_USER: Can a known-good Switchvox user make and receive calls?
  A: Yes -> OUT_INDIVIDUAL
  B: No  -> OUT_ENGINEERING


SW_LOCATION: Are the Switchvox phones powered and connected to the network?
  A: Yes -> SW_LOCATION_REGISTERED
  B: No  -> OUT_NETWORK


SW_LOCATION_REGISTERED: Are the Switchvox phones registered?
  A: Yes -> SW_LOCATION_INTERNAL
  B: No  -> OUT_REGISTRATION


SW_LOCATION_INTERNAL: Can users make internal calls?
  A: Yes -> SW_LOCATION_OUTBOUND
  B: No  -> OUT_ENGINEERING


SW_LOCATION_OUTBOUND: Can users make outbound calls?
  A: Yes -> SW_LOCATION_INBOUND
  B: No  -> OUT_PROVIDER


SW_LOCATION_INBOUND: Can users receive inbound calls?
  A: Yes -> OUT_RESOLVED
  B: No  -> OUT_PROVIDER


SW_MULTI_LOCATION: Are multiple locations experiencing the same Switchvox issue?
  A: Yes -> SW_MULTI_LOC_TEST
  B: No  -> SW_LOCATION


SW_MULTI_LOC_TEST: Can any location make or receive calls?
  A: Yes -> SW_MULTI_LOC_GOOD
  B: No  -> OUT_PROVIDER


SW_MULTI_LOC_GOOD: Can a known-good Switchvox user make and receive calls?
  A: Yes -> OUT_INDIVIDUAL
  B: No  -> OUT_ENGINEERING



BS_USERS: How many users are affected?
  A: One user                  -> BS_DEVICE
  B: Multiple users            -> OUT_BS_DOCS
  C: Everyone at one location  -> OUT_BS_DOCS
  D: Multiple locations        -> OUT_BS_DOCS


BS_DEVICE: Which BroadSoft device is affected?
  A: Physical phone       -> BS_PHONE_REGISTERED
  B: Desktop application  -> OUT_BS_DOCS
  C: Multiple devices     -> OUT_BS_DOCS
  D: Other                -> OUT_BS_DOCS


BS_PHONE_REGISTERED: Is the phone registered in BroadSoft?
  hint: Go to Extension > Utilities > Registration.
  A: Yes -> OUT_BS_DOCS
  B: No  -> BS_PHONE_POWER


BS_PHONE_POWER: Is the phone powering on?
  A: Yes -> BS_PHONE_IP
  B: No  -> BS_PHONE_POWER_LOCATION


BS_PHONE_POWER_LOCATION: Can the user plug the phone into a location where there is known power?
  A: Yes -> BS_PHONE_POWER_TEST
  B: No  -> BS_PHONE_CABLE


BS_PHONE_POWER_TEST: Does the phone power on in the new location?
  A: Yes -> BS_PHONE_IP
  B: No  -> BS_PHONE_CABLE


BS_PHONE_CABLE: Can the user try a new cable?
  A: Yes -> BS_PHONE_CABLE_TEST
  B: No  -> BS_PHONE_WARRANTY


BS_PHONE_CABLE_TEST: Does the phone power on with the new cable?
  A: Yes -> BS_PHONE_IP
  B: No  -> BS_PHONE_WARRANTY


BS_PHONE_WARRANTY: Is the phone under warranty or HaaS?
  A: Yes -> OUT_PHONE_REPLACEMENT
  B: No  -> OUT_PHONE_REPLACEMENT


BS_PHONE_IP: Can the user provide the IP address of the phone?
  A: Yes -> BS_PHONE_MAC
  B: No  -> OUT_BS_DOCS


BS_PHONE_MAC: Can the user provide the MAC address of the phone?
  A: Yes -> BS_PHONE_PING
  B: No  -> OUT_BS_DOCS


BS_PHONE_PING: Can the phone's IP address be pinged from the Edgewater firewall?
  A: Yes -> BS_PHONE_NAT
  B: No  -> OUT_BS_DOCS


BS_PHONE_NAT: Create a NAT port forward and attempt to log into the phone.
  A: Continue -> OUT_BS_DOCS



WV_USERS: How many users are affected?
  A: One user                  -> WV_DEVICE
  B: Multiple users            -> OUT_WEAVE
  C: Everyone at one location  -> OUT_WEAVE
  D: Multiple locations        -> OUT_WEAVE


WV_DEVICE: Which Weave device is affected?
  A: Physical phone       -> WV_PHONE_ISSUE
  B: Mobile app           -> WV_MOBILE_USER
  C: Desktop application  -> WV_DESKTOP_USER
  D: Multiple devices     -> OUT_WEAVE


WV_PHONE_ISSUE: What is the Weave physical phone problem?
  A: No power or phone is off       -> WV_PHONE_REBOOT
  B: Phone is offline               -> WV_PHONE_REBOOT
  C: Cannot make outbound calls     -> WV_PHONE_REBOOT
  D: Cannot receive inbound calls   -> WV_PHONE_REBOOT
  E: Audio or one-way audio         -> WV_PHONE_REBOOT
  F: Poor call quality              -> WV_PHONE_REBOOT
  G: Calls dropping                 -> WV_PHONE_REBOOT
  H: Other                           -> WV_PHONE_REBOOT


WV_PHONE_REBOOT: Reboot the Weave physical phone.
  A: Problem resolved -> OUT_RESOLVED
  B: Problem remains  -> WV_PHONE_NETWORK


WV_PHONE_NETWORK: Check the Weave phone's power and network connection.
  A: Problem resolved -> OUT_RESOLVED
  B: Problem remains  -> OUT_WEAVE


WV_MOBILE_USER: Is the user's email configured as a user in Weave?
  A: Yes -> WV_MOBILE_PERMISSIONS
  B: No  -> OUT_WEAVE


WV_MOBILE_PERMISSIONS: Does the user have the correct permissions in Weave?
  A: Yes -> WV_MOBILE_NETWORK
  B: No  -> OUT_WEAVE


WV_MOBILE_NETWORK: Is the user remote or at the office?
  A: Remote -> WV_MOBILE_REMOTE
  B: Office -> WV_MOBILE_OFFICE


WV_MOBILE_REMOTE: Is the remote user connected to VPN?
  A: Yes -> WV_MOBILE_VPN
  B: No  -> WV_MOBILE_SYMPTOM
  C: VPN not required -> WV_MOBILE_SYMPTOM


WV_MOBILE_VPN: Can the user reach Weave through the VPN?
  A: Yes -> WV_MOBILE_SYMPTOM
  B: No  -> OUT_VPN


WV_MOBILE_OFFICE: Is the office device connected by wired Ethernet or Wi-Fi?
  A: Wired -> WV_MOBILE_IP
  B: Wi-Fi -> WV_MOBILE_IP


WV_MOBILE_IP: Is the device receiving the correct office IP address?
  A: Yes -> WV_MOBILE_SYMPTOM
  B: No  -> OUT_NETWORK


WV_MOBILE_SYMPTOM: What problem is the user experiencing?
  A: Cannot make outbound calls   -> OUT_WEAVE
  B: Cannot receive inbound calls -> OUT_WEAVE
  C: No audio                    -> OUT_WEAVE
  D: One-way audio               -> OUT_WEAVE
  E: Notifications not working   -> OUT_WEAVE
  F: Other                        -> OUT_WEAVE


WV_DESKTOP_USER: Does the Weave desktop application open successfully?
  A: Yes -> WV_DESKTOP_NETWORK
  B: No  -> OUT_WEAVE


WV_DESKTOP_NETWORK: Is the user remote or at the office?
  A: Remote -> WV_DESKTOP_REMOTE
  B: Office -> WV_DESKTOP_OFFICE


WV_DESKTOP_REMOTE: Is the remote user connected to VPN?
  A: Yes -> WV_DESKTOP_VPN
  B: No  -> WV_DESKTOP_CONNECT
  C: VPN not required -> WV_DESKTOP_CONNECT


WV_DESKTOP_VPN: Can the user reach Weave through the VPN?
  A: Yes -> WV_DESKTOP_CONNECT
  B: No  -> OUT_VPN


WV_DESKTOP_OFFICE: Is the office computer connected by wired Ethernet or Wi-Fi?
  A: Wired -> WV_DESKTOP_IP
  B: Wi-Fi -> WV_DESKTOP_IP


WV_DESKTOP_IP: Is the computer receiving the correct office IP address?
  A: Yes -> WV_DESKTOP_CONNECT
  B: No  -> OUT_NETWORK


WV_DESKTOP_CONNECT: Can the Weave desktop application connect successfully?
  A: Yes -> WV_DESKTOP_SYMPTOM
  B: No  -> OUT_WEAVE


WV_DESKTOP_SYMPTOM: What problem is the user experiencing?
  A: Cannot make outbound calls   -> OUT_WEAVE
  B: Cannot receive inbound calls -> OUT_WEAVE
  C: No microphone audio           -> WV_DESKTOP_AUDIO
  D: No speaker audio              -> WV_DESKTOP_AUDIO
  E: One-way audio                -> WV_DESKTOP_AUDIO
  F: Poor call quality             -> OUT_WEAVE
  G: Calls dropping                -> OUT_WEAVE
  H: Other                         -> OUT_WEAVE


WV_DESKTOP_AUDIO: Check the computer microphone, speaker, headset, and application permissions.
  A: Problem resolved -> OUT_RESOLVED
  B: Problem remains  -> OUT_WEAVE



[OUT_ITGLUE]: Identify the phone system
  description: Go to IT Glue > Voice/PBX Asset and identify whether the customer uses Switchvox, BroadSoft, or Weave.
  code: CHECK_ITGLUE


[OUT_NETWORK]: Troubleshoot network connectivity
  description: Verify the correct IP address, DHCP, VLAN, switch connectivity, Wi-Fi or Ethernet connectivity, and internet connectivity.
  code: CHECK_NETWORK


[OUT_VPN]: Troubleshoot VPN connectivity
  description: Verify VPN connectivity and the user's ability to reach the phone system.
  code: CHECK_VPN


[OUT_HOME_GUIDE]: Refer to the Home User Troubleshooting Guide
  description: Identify the remote user's internet provider and follow the Home User Troubleshooting Guide for remote users.
  code: HOME_USER_GUIDE


[OUT_SW_USER]: Switchvox user configuration issue
  description: Verify the user's email exists as a user in Switchvox and is associated with the correct extension.
  code: CHECK_SW_USER


[OUT_SW_CREDENTIALS]: Switchvox credential issue
  description: Verify the user's Switchvox credentials and account status.
  code: CHECK_SW_CREDENTIALS


[OUT_SW_HOSTNAME]: Switchvox hostname issue
  description: Verify the application is configured with the correct Switchvox hostname or server.
  code: CHECK_SW_HOSTNAME


[OUT_REGISTRATION]: Switchvox registration issue
  description: Verify extension configuration, credentials, provisioning, network connectivity, and phone system status.
  code: CHECK_REGISTRATION


[OUT_SANGOMA]: Escalate to Sangoma
  description: Reboot, reconfigure, and factory reset have been attempted. Open a support ticket with Sangoma. If the phone is out of warranty, determine whether a replacement phone is needed.
  code: SANGOMA_TICKET


[OUT_SOFTPHONE_UPDATE]: Update the desktop softphone
  description: Install the current available version, restart the application, and test again.
  code: UPDATE_SOFTPHONE


[OUT_SOFTPHONE_SOP]: Refer to the Softphone Troubleshooting Guide SOP
  description: Open the internal documents and follow the Softphone Troubleshooting Guide SOP for additional troubleshooting.
  code: SOFTPHONE_SOP


[OUT_BS_DOCS]: Refer to BroadSoft internal documentation
  description: Go to IT Glue > Voice/Data and follow the applicable BroadSoft troubleshooting documentation.
  code: BROADSOFT_DOCS


[OUT_WEAVE]: Open a ticket with Weave
  description: Open a support ticket at weavehelp.com. Include the customer, location, affected user, phone or device, phone number or extension, exact symptoms, timestamps, and troubleshooting already performed.
  code: WEAVE_TICKET


[OUT_APPLICATION]: Application issue
  description: The issue appears isolated to the user's application or device. Continue with the applicable application troubleshooting procedure.
  code: APPLICATION_ISSUE


[OUT_INDIVIDUAL]: Individual user issue
  description: The issue appears isolated to one user or one user's device. Continue with individual user troubleshooting.
  code: INDIVIDUAL_USER


[OUT_PROVIDER]: Provider or carrier issue
  description: Document affected numbers, extensions, call direction, timestamps, symptoms, and troubleshooting performed before contacting the provider.
  code: PROVIDER_ISSUE


[OUT_ENGINEERING]: Escalate to Digital Agent Engineering
  description: Document the customer, location, phone system, affected users, extensions, devices, exact symptoms, tests performed, results, and changes made.
  code: ENGINEERING_ESCALATION


[OUT_TRUCK_ROLL]: Potential onsite truck roll
  description: The phone works from a different location, indicating the original network port may not be working. Message the All Support Teams chat for truck roll assistance.
  code: TRUCK_ROLL


[OUT_PHONE_REPLACEMENT]: Phone may need replacement
  description: Check whether the phone is under warranty or HaaS. If applicable, proceed with replacement. If not covered, determine whether a new phone needs to be purchased.
  code: PHONE_REPLACEMENT


[OUT_RESOLVED]: Issue Resolved
  description: Test the affected function one final time and document the resolution in the ticket.
  code: RESOLVED
  

Machine Access

Questions in this decision tree

Possible outcomes

How to use this decision tree

Click "Open interactive version" to step through the questions. Your answers narrow the tree until a recommended outcome is reached. You can also embed this tree on your own site.