If you like to get feedback from Zendesk Guide articles, you can do it with embedded survey. If you like to see how this work, scroll down and you'll see question "Was this article helpful?" and NPS scale.
Create your survey
Create a simple survey which contains at least one page and one question.
For example https://my.surveypal.com/app/form/preview?_sid=630716711&_k=azBCd0TA9XsecPeYj8Kzy208GpnNAIp8PQkz-ZSTDwbm1_zw6z9MIlxCTB3i6I7u&_d=0&clear=1&showPreviewBar=true
You might want to change survey style so that it works better in article footer. Here are instructions how to do it: https://support.surveypal.com/hc/en-us/articles/360013643639
Create and edit iframe code
Copy iframe code from Surveypal Distribute view. Click "Embedded survey" and copy code from text field. For example
<iframe style="width:100%;height:600px;border:none" src="https://q.surveypal.com/form?sid=1222775745&sh=_5xR_niQ8OMY75AVjQ5Mlh94Kye_QctMpA9j2zPXEQzdkmn0ODGYLR4BRAaFFPyR&channel=website"></iframe>
Edit iframe link which is parameter src value
- replace /form with /app/form/ext
- add meta parameter and value after &channel=website
Your iframe code should look like this
<iframe style="width:100%;height:600px;border:none" src="https://q.surveypal.com/app/form/ext?sid=1222775745&sh=_5xR_niQ8OMY75AVjQ5Mlh94Kye_QctMpA9j2zPXEQzdkmn0ODGYLR4BRAaFFPyR&channel=website&meta=[{'key':'ArticleId','value':'{{article.id}}'},{'key':'ArticleTitle','value':'{{article.title}}'},{'key':'SectionName','value':'{{section.name}}'}]"></iframe>
Here we added article page id {'key':'ArticleId','value':'{{article.id}}'}, article title {'key':'ArticleTitle','value':'{{article.title}}'} and section name {'key':'SectionName','value':'{{section.name}}'} to the link and this information goes to Surveypal.
You can add more section or article page information to link meta parameter if you like. List of section placeholders https://developer.zendesk.com/rest_api/docs/help_center/sections and article placeholders https://developer.zendesk.com/rest_api/docs/help_center/articles
Add iframe code to Zendesk article page
Login to Zendesk Guide.
Select Customize design (eye icon) from left bar.
Click View theme
Click Edit code
Select file article_page.hbs
Scroll down and add your iframe code to inside <footer> tag. Best place might be after row
<span style="color:white;">{{article.locale}}</span>
Click Publish
Go to check your guide article page. You should see your survey there.
Multi language guide
If your guide have more than one language then you must create one survey for every language.
You also need to add logic to article page code. Here we have example where we check if article language is Finnish or something else and add different iframe code based on the language.
{{#is article.locale 'fi'}}
<iframe style="width:100%;height:600px;border:none" src="https://q.surveypal.com/app/form/ext?sid=1333775745&sh=rtyR_niQ8OMY75AVjQ5Mlh94Kye_QctMpA9j2zPXEQzdkmn0ODGYLR4BRAaFFRTY&channel=website&meta=[{'key':'ArticleTitle','value':'{{article.title}}'},{'key':'SectionName','value':'{{section.name}}'}]"></iframe>
{{else}}
<iframe style="width:100%;height:600px;border:none" src="https://q.surveypal.com/app/form/ext?sid=1222775745&sh=_5xR_niQ8OMY75AVjQ5Mlh94Kye_QctMpA9j2zPXEQzdkmn0ODGYLR4BRAaFFPyR&channel=website&meta=[{'key':'ArticleTitle','value':'{{article.title}}'},{'key':'SectionName','value':'{{section.name}}'}]"></iframe>
{{/is}}
Create an automation
Go to your survey and open Manage -view and click on "Automations", and make an automation as in the picture below. If you want to make a Zendesk ticket you need to insert your Zendesk support email address to the 'To:' -field. You can add background information to message subject or body by adding background information field name inside double curly brackets {{fieldname}}. You'll find background information field name from Manage view when you click "Meta fields".
If you create a ticket to Zendesk with this automation then it's possible that ticket goes to suspended tickets list. If it happens then click ticket in your suspended tickets list, click "Resolve automatically" and then open user "Surveypal" (user name comes from your automation "From" field), click menu next to primary email address (noreply@surveypal.com) and select "Verify now". Go to Zendesk admin view and select "Customers" under "Settings" title. Add noreply@surveypal.com to field "Allowlist" and click "Save tab".