Integrating Hudu Articles Into Your Portal

Aside from building out KB articles yourself, you can seamlessly bring your documentation over from Hudu to your client portal without reinventing the wheel.

• Create an API Key in Hudu
• Entering the Hudu API Key in CloudRadial
• Putting Your Hudu Article(s) in CloudRadial 
  • Putting the Hudu Articles in Partner > Content for Mass Distribution
• Troubleshooting Hudu Article Issues
  • FAQ

1. Create an API Key in Hudu

1. Navigate to your Hudu instance 
2. Click the dropdown option at the top and select Admin
   
   
   
   
3. Select API under the Account Administration section
4. Use the left-hand input to create an API key 
   • Name the key whatever you wish
   • You do not need to restrict to a specific company
   • You no not need to list allowed IP addresses
   • You do not need to allow access to passwords
   • You do not need to allow access to destructive actions
5. Copy the API key you get from Hudu

2. Entering the Hudu API Key into CloudRadial

1. Navigate to Partner > Settings
2. Select Integrations on the right, under the Configurations column
3. Select Hudu from the list
4. Enter your Hudu domain and your API key 
   • Your Hudu domain should not contain any HTTP prefix.
   • Ex: cloudradial.huducloud.com
5. Select Test Credentials to ensure the key is working properly
   • If not, try to regenerate a new key. 
6. Upon a successful test, select Submit at the bottom to finalize your settings

3. Putting Your Hudu Article(s) in CloudRadial

Once you've got the API set up with Hudu, you'll notice a new option when creating knowledge base articles. There will be a selection - From Hudu. Here's how the setup works.

Putting the Hudu Articles in Partner > Content for Mass Distribution

1. Head to Partner > Content
2. Navigate to an existing Articles content package
   • You can also create one from the +Add button at the top right
3. Once in the content package, create a new article via the +Add button at the top right
   • Set Category to be the folder under which the article will reside
   • Set Subject as the title of the article in CloudRadial
   • Set the Article to "From Hudu" rather than from the editor
     • Perform a Lookup using the button on the right to find the article you want to bring in.
4. Select Submit at the bottom.

You can add additional Hudu articles as necessary to this content package, provided that their target audience is the same (specifically, company groups and user groups).

Once you set the audience and publish the package, the article will appear within client's knowledge base(s). 

Troubleshooting Hudu Article Issues

Sometimes, you may experience issues with images not pulling into the articles within CloudRadial. If this is the case, you may need to make the article public-facing in order for the API to allow the screenshots to pull through.

To do so:

1. Log into Hudu
2. Locate the article(s) that you're experiencing issues with
3. On the right-hand side, locate and select the option to Create Public Share Link

That's all there is to it. Creating the article as a public share link, even without sharing the link with anyone specifically, unlocks the ability for images to be pulled through the API connection to CloudRadial. 

Notes and FAQs

• Due to limitations in the Hudu API, CloudRadial is only able to display articles that have been created in Hudu. PDFs uploaded to Hudu are not exposed to their API and therefore cannot be displayed in CloudRadial. 
• I don't see the Hudu option when adding an article at the company level. What gives?
  • Hudu articles can only be added via Partner > Content OR at the company level for the Partner-level company.
    
    The reason is that the lookup function for Hudu articles spans across all companies in Hudu - so making it available on a company level opens up the possibility for data leakage and article distribution to wrong companies.