KrisS
Khoros Alumni (Retired)
Joined 15 years ago
User Profile
User Widgets
Contributions
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 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 Team7.8KViews5likes0CommentsEscalating Support Cases
Considerations before escalating In Khoros’ support case portal, you can set or change the "Customer Priority" field between low, medium, and high. When issues are urgent, changing the priority to "high" will push them up the list of issues based on your support level. One practice to avoid is creating a support case and escalating it the same day. Same-day escalations are generally pushed back to allow the team to go through the standard support triage process and gather all necessary information before bringing in other experts or teams. Shortcutting tends to be disruptive to that process and introduces further delays. While it is essential to stay in close contact with your account team, we strongly recommend bypassing them for escalations and instead escalating directly via Khoros’ support chatbot, Maia. Ad-hoc escalations create back channels and can duplicate efforts, resulting in delays or confusion. Customer success managers are also automatically informed about escalations, so they will be aware. When should I escalate? You should escalate a support case when there is urgency involved. 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 a severity 1 issue SLA missed for first response Unresponsive or lack of updates in a case Although Khoros endeavors to keep it to a minimum, there may be times when escalated issues are not accepted as valid escalations. Decisions about 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 that qualifies as outage severity should continue to go through the standard outage process of emailing outage@khoros.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 submitted through email or the case portal with a lower severity rating can be escalated. We recommend allowing the support team 24 hours to review the case before escalating. Can I escalate outages? All severity 1 issues are considered outage level, and it's unnecessary to escalate since an on-call team is available 24/7/365 for issues that qualify. Severity 1 cases are already at the highest and most visible level possible. How do I escalate a support case? You can escalate a case by opening Maia (in-app chat or via Atlas) and typing ‘escalate a case.’ Maia will ask a few questions: Enter your case number Reason for escalation (select one): time constraints, lack of updates, defect resolution time, missed SLA, security concern Number of users impacted: (select one) single user, less than 50% of users, more than 50% of users Explain how this issue impacts your business operations Would you prefer a live call to share the latest update on this escalation? (select one) Yes, No All escalation requests will go to an active queue, which our shift supervisors and managers will acknowledge and review to determine the next steps. All further updates will be provided directly in the case.28KViews5likes12CommentsRe: Khoros Communities 22.10 Release
beacampos I have not seen any reports of this, but if you haven't already please open a support case with a high priority and ask the team to review the security.css.checkClass configuration. We should be able to identify the root cause and propose the available remediation options. Assuming it's not the result of anyone unintentionally copy/pasting styling without being aware (it doesn't sound like it based on your note), it may be a configuration issue.539Views1like0CommentsRe: Khoros Communities 22.8 Release
irach15 the timing is definitely suspect and the first thing we look at is what changed on or around the date the issue was first reported. However, having encountered this before we knew where to check in the logs to quickly see the URI for the solution came from the reply by email path used in the email link. This is tied to the end user who gave the solutions and does not impact your account. Your post was marked as a solution because when you contributed to the thread it generated a subscription email for a new reply for the user we believe is using some type of security scanner on emails that's actually clicking the links generating solutions.317Views0likes0CommentsRe: Khoros Communities 22.8 Release
Drew_C thanks for the info - you are spot on. irach15 this is likely the result of your email system either having new features pushed out or turned on that scan emails in real-time and click on links. In this case I can confirm this is indeed what's occurring based on the URI from the logs showing the reply by email is what generated the solution: uri=/t5/action/replybyemailactionpage Basically, once an email comes in it's being scanned and has links clicked, which in turn trigger the solutions or kudos. Disabling the email mechanism would be the true solution, but on the Khoros side it can be worked around by disabling reply by email for users like Drew mentioned.347Views1like0CommentsRe: Khoros Communities 22.8 Release
allensmith81 the new behavior introduced in 22.8 is controlled by a config that will be enabled by default as of 22.8 and forward. For customers who do not want that behavior, they can either request Support disable the feature by config, or simply not make the necessary permission changes. Similar to many features it's made available out the gate so customers can opt to use it not, but there is an option through Support for those who do not wish for this behavior to even be an option.905Views1like0CommentsRe: Khoros Communities 22.4 Release
Fix is now available and included within 22.4 so anyone in need of it just needs to be restarted (live, no downtime). Most of this will occur naturally through restarts from normal actions or requests, and anyone upgrading to 22.4 gets it with the fix built in. allensmith81 you should be good to go across all your instances, and should see an update in your open case. estieg I'm having your instances restarted shortly to pick the fix up. luk given you work on a number of communities, a simple Support case requesting "a restart for the LIA-81530 fix" should suffice and let the team know exactly what to do if you include a list of communities. For anyone else, the same applies and you just need to file a Support case to request a restart.672Views4likes0CommentsRe: Khoros Communities 22.4 Release
allensmith81 the 22.4 upgrades have already started on production, and I'm not certain it will be fixed before next week when you're scheduled. I may be able to go out of process and work with a colleague to have the change set reverted, but that can be tricky since it requires a patch and patches can interfere with engineering efforts since they cannot be long terms and effectively force engineering action before a new release. We'll take a look and see what we can do to potentially make it an option for customers on or preparing for 22.4 in order to prevent upgrade postponement requests.896Views0likes0CommentsRe: Khoros Communities 22.4 Release
luk & allensmith81 we have confirmed the issue and filed a priority jira to see if we can get it tackled in this Q2 cycle. It appears to stem from changes made to improve a future API function, but caused the very issue described where the output has changed in 22.4.944Views2likes0Comments