KrisS
Khoros Alumni (Retired)
Joined 15 years ago
User Profile
User Widgets
Contributions
Escalating Support Cases
Some tips before escalating In the case portal, you have the ability to set/change the "Customer Priority" field between low, normal and high. When issues are urgent but not necessarily world ending, changing the priority to "high" will push it up the list of issues based on your support level, which is a good way to get support's attention to an issue. One thing to avoid if possible is creating a case and escalating it that same day without a strong reason. Same day escalations are generally pushed back on to allow them to go through the standard support triage process and gather all necessary information before bringing in other experts or teams, but short-cutting tends to be disruptive to that process and introduces further delays. While it is important to stay in close contact with your CSM or account rep, we strongly recommend bypassing them for escalations and instead escalating directly via the case portal. Ad-hoc escalations create back channels and can duplicate efforts, which has resulted in delays or confusion around escalations. CSM's are also informed around escalations automatically, so they will be aware. When should I escalate? You should escalate when there is urgency involved in a support ticket. This would include issues such as, but not limited to: Time constraints (SSL cert expiring, deadlines, events, etc.) A major impaired function that does not qualify as an severity 1 issue SLA missed for first response Unresponsive or lack of updates in a case While we'll do our best to keep it to a minimum, there will be times when escalated issues will not be accepted as an escalation. If/when that happens, an automated reply will be sent to inform the user who originally escalated the case. Decisions around escalations are entirely at the discretion of the team responsible for escalations. Additionally, the escalation feature is not designed to replace the outage alias. Any issue which qualifies as being of outage severity should continue to go through the standard outage process of emailing outage@lithium.com or setting the case severity to "1". When can I escalate? All Severity 1 cases (outages) are automatically escalated to our Mission Critical Support team and thus do not require further escalation. Cases that were submitted with a lower severity rating can be escalated four (4) hours after the original submission. Can I escalate outages? All severity 1 issues are considered outage level and it's not necessary to escalate since an on-call team is available 24/7/365 for issues that qualify. S1 cases are already at the highest and most visible level possible. How do I escalate a support case? Aftera case has been created, the option to escalate it will be available. Simply open the desired support ticket within the Case Portaland click Escalate Caselocated in the escalation information section. Anew form displays along with some details and instructions. On that form, provide a summary of why the case needs to be escalated to an Escalation Manager for review within 4 business hours. After you've filled out the escalation summary and submitted the request, an alert is sent to an Escalation Manager for review. An Escalation Manager will review the request and reply directly in the case you escalated with a decision or plan of action. What if I'm not satisfied with the current escalation decision or progress? Should you be unsatisfied with the results of your case escalation, you have the option to go up a higher level by clicking the "Escalate Case" button again. When the "Escalate Case" button is used again, you'll be presented with a different form acknowledging the next-level escalation and again requesting you provide an explanation around the reason for escalating again / higher. Once submitted, an Escalation Manager will review the request and respond directly within the escalated case. You can perform this process multiple times. The higher the escalation, the more members of Leadership or Management will be involved. Here's a breakdown of the various levels and what occurs: Level 1: The case is escalated to our senior support engineers, team leads and managers. Level 2: All of the previous team is alerted, but the escalation is extended to senior managers, directors and your account's Customer Success Manager (CSM). Level 3: All of the previous manager groups from Level 2 are alerted, but in addition, the Senior Director of Global Technical Support will be included. A full analysis will be completed to understand why this case needed an escalation to this level. Level 4: All of the managers from Level 3 are alerted, but our VP of Support is also alerted and will take personal responsibility to drive through to completion.Help Us Help You!
Dear Customer, You're looking to create a case because you've encountered a technical issue, would like a request to be completed, or have some other information you would like to receive. You would like to have your case completed as quickly as possible and so would we! While we can't always guarantee things will be resolved quickly depending on the nature of an issue, there are some things you can do to help move things along proactively! We've compiled some common requests for details that our Support team often asks for below with respect to each product Khoros offers, as well as some tips on things you can do to help focus the team's efforts on the right things. If you could provide this information when creating your case that would help move the request along, as it will eliminate some back and forth and allow our team to move forward and ask more targeted questions if more information is needed on top of what was already provided (sometimes this may be necessary). Some of this information may not always be relevant or available (e.g.: if you want to enable a new Community feature we probably won't need a HAR file), but please try to provide as much as you can! Care Community Marketing Care Care is a single-page web application that allows a lot of social media integrations. We have put up a list of scenarios with a set of information that the support team might require to investigate that scenario. Please be thorough while describing the issue you are facing. The clearer you are, the easier it will be for the Support team to step through the issue in the same way that you are. This includes filling out the "Steps to reproduce", "Expected Behavior", and "Actual Behavior" fields in detail. Including the steps you took can be very helpful. If the issue is regarding content(post) not ingesting into the Care application then it would be helpful to provide us with the following links: Native links of the original posts Screenshots to the native posts If the issue is regarding the user being unable to log in, then it would be important to provide the following information: Users email address Screenshots of the error while attempting to login How many users are unable to log in, is it specific to a set of users or all users? If the issue is that the content is ingesting with a delay then you can provide us with the following information Conversation ids where the delay was noticed. 2. The Social media handle name. 3. Is the delay in ingestion experienced for all the conversations from that specific social media handle or a different social media handle. If the issue is regarding conversations falling in an incorrect work queue, then you can provide us with the following information: Conversation ids that were incorrectly routed. Name of the work queue where the conversation should have been routed. Were any recent changes done to the work queues or the tags? If there were changes done then what were those changes. If the issue is related to user permissions and some of the roles aren’t reflected even after saving the user profile, please provide us with the following information: User email address. Screenshot of the error if any error pops up. How many other users are seeing a similar issue? Are the user permissions managed via any identity provider or do they login via SSO? If the care app appears to be slow, the following information would be absolutely necessary and important How many users are experiencing slowness is it specific to a group of users? If it is specific to a group of users are they located in the same geographic location. Is there a specific screen in the care application where the slowness is being experienced or it is with the overall application? Is the behavior consistent across different browsers too? Do you use any VPN to access the application? Were there any recent changes done to the network on your end? What exactly happens when you experience slowness on the application. Back to top Community The Community application is large and complex, carrying a number of different features and configuration options, as well as numerous avenues for customization. Here are some things to consider both while you are filing a case for anything Community related or perhaps while trying to review an issue on your own prior to creating a case: Technical issues: Please be thorough while describing the issue you are facing. The clearer you are, the easier it will be for the Support team to step through the issue in the same way that you are. This includes filling out the "Steps to reproduce", "Expected Behavior", and "Actual Behavior" fields in detail. Please also bear in mind that some communities are customized to add configuration options or pages that may not be present on any other community, so including steps to reach the page(s) you were looking at or how you obtained a certain piece of output can be very helpful! For example, if you are getting an error while trying to post, we would prefer that you describe the behavior as something like "When I try to submit a post I receive an error with this text: texthere" as opposed to something like "When I try to submit a post it doesn't work". From a backend perspective, "doesn't work" could mean a number of different things, so being as descriptive as possible in all fields will give the team a better picture of what is happening and allow them to focus their efforts. When possible, please try to confirm if an issue occurs in all of your environments (stage, production, preproduction) as well. We understand that not all issues can be tested everywhere for a variety of reasons, but it is helpful to know what you see in all of your environments for comparison purposes. Please include full URLs to the page(s) you would like us to pay attention to. The more specific the URL is, the better. You may already have these URLs open while creating your case as well and it is likely it will take less time to copy and paste them in the field for URLs than it would for someone from the Support team to track them down on their own. This also helps ensure the team is looking at the right instance(s), which can be especially important if you have more than one instance or refer to your communities in a different way than the Khoros team does internally. For example, "dev" is a common reference to stage instances among customers, but internally, we don't have any customer environments that are referred to as "dev", so this can cause confusion that can be solved by linking to the specific instance(s) you would like us to focus on. Please try to provide timestamps wherever possible. The log files for the Community application are very large and contain a lot of information about various things that happen in an individual community, so having something to focus on is extremely helpful. Please remember to include the timezone for any timestamps you provide. One person's 1 pm is another person's 1 am, so leaving out the timezone could lead to any results being off by several hours for a task where even a couple of seconds could make a difference. Screenshots and videos are also very helpful when trying to communicate an issue! For any screenshots or videos you provide, please try to include the full screen (including the address bar and taskbar with the clock visible). If you need to draw focus to a specific part of the page, please consider using a highlighter or other drawing tools rather than cropping the image. For technical issues where a problem occurs, a HAR file is often helpful. Please see this article for more information on HAR files and the steps to generate them. For any HAR files you provide, please try to start capturing traffic from start to finish - that is, start capturing traffic before you attempt to reproduce the issue and continue to capture traffic until the issue has been reproduced. Please try to give a meaningful name to any files you attach to a case. It is much easier to tell at a glance what "board-with-error.png" is for than it is when the filename is something along the lines of "image1.png". This becomes increasingly appreciated and helpful as more files are attached over time. Please try to reference specific users that the Support team can look at for any issues that occur, even if all users may be impacted. Having some sample users to look at can be useful for comparison purposes and for looking information up in our logs. Please try to provide a link to the user's profile, as this will help reduce confusion and ensure that we're looking at the right user (example of a profile URL: https://community.khoros.com/t5/user/viewprofilepage/user-id/1) Please consider things that may have changed recently, both on and off of the community. For example, if a deployment using Self Publish was recently carried out and something no longer works correctly, this is both helpful for the Support team and for you to consider as well as something to look into on your end. Along the same lines, changes in the community can be relevant as well. For example, if your community uses SSO and your SSO team makes a change, that may be relevant if SSO suddenly stops working. Having information like this from the start helps focus the team's efforts. Some other specific things that may be worth considering depending on the issue you are facing (but not limited to) are Community Admin panel changes, DNS changes your to community's hostname, deployments carried out by Khoros teams that you are aware of (e.g.: Services engagements, new features, upgrades), and changes to your authentication workflow (either on your side or on the Community side). Please try to include when the issue started if you have an idea of when something last worked differently. This is similar to the previous point in that you will generally have more experience with what you need and want your specific community to do, so knowing when something last worked differently can be extremely helpful in tracking down what may be causing an issue even if you aren't aware of any specific changes that might have been made. Please consider trying to reproduce any issues you encounter in a separate browser or using a private/incognito browsing session or on a different device if one is available. Some issues are specific to individual browser operating systems or may be caused by add-ons/programs specific to your computer, so taking this step can help rule things like that out. For connectivity and performance issues, please consider trying to reproduce the issue on a different network (e.g.: if you normally use a corporate VPN, try turning it off or using your cell phone). This can help rule out network issues as a cause of any issues you run into. Please note that in cases where a specific network has an issue, it is likely the team will recommend reaching out to the network owner, so you may want to consider doing this proactively as well. For any API calls you are using (either manually or through custom code/automation), please provide the full API call exactly as it is being made. You can scrub any session key information, but please try to keep the exact call intact and include any headers or query parameters you are using. In cases where you are using code to make the API call, please consider sharing that source code as well. The Support team generally cannot debug your custom code, but it can be helpful for us to get an idea of what it is doing and where. For display issues or script errors, the Support team will typically try to test an issue by changing the skin the page is using to an out-of-the-box (OOTB) skin to try and narrow down the scope of the issue. This may be something you want to try on your own as well. This can be accomplished by going to the Admin Panel -> Display -> Skins -> Select one of the OOTB skins (White UI or Responsive Peak) and save changes. If you are going to do this, we recommend doing so on stage or in a private area in your community, as the OOTB skins will look very different from your branded skin and this could cause confusion for your end-users. In cases where changing the skin appears to resolve the problem, the Support team may ask you to reach out to your internal teams to look into the issue. You may want to consider doing that proactively as well in order to review any changes that may have been made. Requests to enable features or for information: For any requests to enable features, if you happen to have the documentation available to point to that would be appreciated! We understand if you don't have it on hand when creating a case, but if you do happen to have it open, it helps ensure that everyone is looking at the same thing. Though not often as relevant to these types of cases, filling out the "Steps to reproduce", "Expected behavior", and "Actual behavior" fields can still be very helpful in ensuring that the team focuses their efforts on what it is you're interested in. Back to top Marketing Technical Issues: Please be thorough while describing the issue you are facing. The clearer you are, the easier it will be for the Support team to step through the issue in the same way that you are. This includes filling out the "Steps to reproduce", "Expected Behavior", and "Actual Behavior" fields in detail. Including the steps you took can be very helpful. For example, if you are getting an error while trying to post, we would prefer that you describe the behavior as something like "When I try to schedule or save a post I receive an error with this text: texthere" as opposed to something like "When I try to submit a post it doesn't work". From a backend perspective, "doesn't work" could mean a number of different things, so being as descriptive as possible in all fields will give the team a better picture of what is happening and allow them to focus their efforts. Screenshots and videos are also very helpful when trying to communicate an issue! For any screenshots or videos you provide, please try to include the full screen (including the address bar). This will provide more details as to where you are in the platform. If you need to draw focus to a specific part of the page, please consider using a highlighter or other drawing tools rather than cropping the image. For technical issues where a problem occurs, a HAR file and console logs are often helpful. Please see this article for more information on HAR files/console logs and the steps to generate them. For any files you provide, please try to start capturing traffic from start to finish - that is, start capturing traffic before you attempt to reproduce the issue and continue to capture traffic until the issue has been reproduced. Please consider trying to reproduce any issues you encounter in a separate browser or using a private/incognito browsing session or on a different device if one is available. Some issues are specific to individual browser operating systems or may be caused by add-ons/programs specific to your computer, so taking this step can help rule things like that out. Please try to reference specific users that the Support team can look at for any issues that occur, even if all users may be impacted. Please include details on how this impacts your daily workflow. Whether the issue is intermittent or happening all the time. Is this preventing you from completing a task. If so, is there a deadline you need to complete this by? For access-related issues please review the Admin FAQ. If you are unsure who your admin is, support can look up your admin who can provide you with the appropriate access. Specific to Marketing: For Calendar posts or Ads provide Message ID. To locate the message ID click on the post to open the side pane then click on the basics tab under Khoros ID copy the message:xxxxxxx. The name of the initiative the post/ad is in If the post includes media provide the original image/video file For Inbox items provide A screenshot of the item The name of the stream/collection or topic queue the item is in The name of the initiative the item is in For Analytics provide A full-page screenshot of the dashboard. Include the date ranges and any filters that are applied. Attach data exports For Mobile provide The name of the app, Device information (Android or iOS) Which OS version you are on Mobile app version. If you are not on the latest version of the app you may need to delete and re-download the app. For API provide Curl. This should include the token and the request/body being made. Text or screenshot of errors returned Specific to Intelligence: Provide a direct link to the search/topic or a full-page screenshot that includes the search name. Specific to Experiences: Provide a direct link to the stream, visualization, or space in the platform. Back to top As mentioned earlier, we may still need to ask for additional information depending on the nature of the case. However, by providing any of the above information when you can, we can hopefully move your case towards a satisfactory resolution quickly! We hope you have found the above information useful and we appreciate you sticking with us until the end of this article! As always, please don't hesitate to reach out and let us know if you have any questions or concerns! Sincerely, The Khoros Support TeamRe: configure the server with cache parameter
Hi Pradeep, In truth Support was experiencing delays last week that resulted in your case going so long before being claimed, but once it was claimed the agent responded within minutes - they weren't sitting on it for 7 days, it just hadn't made its way to an agent. That's something we obviously need to work on, and this is a focus point for us for the first half of the year with many new hires coming in to help address that issue. While we should have provided better context around why we were asking the questions we did, it's part of our standard process to ask to determine if customers are actually seeing/feeling the performance impact or if the focus is purely on a report. It is important to distinguish because lighthouse reports have a line that mentions making changes may improve speed, but not your rating. Once we know which area of concern we need to focus on, we can better prepare for how to speak to the specific concern. For this specific change we'll need to engage our engineering team to determine if this change can be made and what impact can be expected, as changing this may not change your rating as the report details. I've added some notes for the agent to follow in your open case so that would definitely be the place to continue to engage us or your TAM should you need anything pertaining to Support in general.Re: v1 API /boards/id/[id]/threads endpoint pagination and inconsistent results
Hi MattDe Issue 1: The problem here is that the nested based calls aren't supported when calling /threads/. The confusion there is our documentation states it's supported, but that's an error we're working on correcting (unless it's already been corrected SuzieH ?). You'll need to remove the nested.page and nested.page_size parameters from the call if you want to get the different content returned. Issue 2: When you query threads it will return data regardless of the page (if there's enough pages of threads on the board), but the linear node ('linear' in the response) is also leveraging the page and page size parameters. This means that linear node is looking for page 2 (or higher) at 1,000 posts per page for the thread when the thread in fact does not have 1,000 messages which results in the linear node being blank. Normally this is handled by calling /posts/recent because that gives you every post (root messages + replies) and includes the root message ID for the purpose of mapping replies to their root message. DougS are there any ways to get root messages + replies outside of using posts/recent when using V1? V2 does this but in this specific example we're looking for options when using V1.Re: What is restadmin?
perk wrote: When i am making this request: http://community.lithium.com/community-name/restapi/vc/users/id/[id]/settings I am getting: error 404: this page could not be found If you believe you are seeing this message in error, please contact communityhelp@lithium.com and note this message and page URL. How should I access this page? It's just an example of the call structure. You need tosubstitute yourcommunity values for the domain and ID, then append the rest to it. E.g.: http://yourcommunity.com/restapi/vc/users/user_ID_goes_here/settingsRe: What is restadmin?
perk wrote: Thanks! How may I know what other variables exist in /settings/name/ ? Is there a list I can access somewhere? You can use the user settingscall to get a list of potential options. Please note the call from your example is a custom field, but those should show up in the list as well.Re: What is restadmin?
perk wrote: Thanks! Is there a way to see all the possible values I can retrieve in this restadmin object? It's just about anything, but a note of caution to be very careful when using restadmin. It's basically making calls as an administrator, so you can easily exposeunwantedinformation to users if not careful. Wjhen you want to make the cal as a normal use, use "rest".
