Moderation
Prior to moderation
Private skills are self-moderated when published, and public skills must be submitted for moderation. To do this:
- On the Settings tab, fill out all the required fields. To learn how to do it, see Creating a skill.
If you are a representative of the manufacturer for whose devices you are creating the skill, specify your name, email, and company site in the contact information. This way you can make your skill official. In other cases, it's enough to specify the name and email address.
In the Description field, list the types of devices your skill works with. For example: LED light bulb, socket.
If your skill is official, pass certification.
Moderators test the skill on each of the specified types.
- Test the skill.
- Grant moderators access to your devices. The Yango Dialogs team will test the skill remotely by video call: submit your skill for moderation and we'll send you an email to the address you specified in the skill settings. We'll ask you to choose a testing date (no later than two weeks from the application).
- Publish your skill as private.
- Create a test account on Yango.
- Grant the test account access to the skill.
- Add smart devices to the test account.
- Grant moderators access to the test account.
If you created an unofficial skill with sign-in via Yango OAuth:
Moderation steps
Moderation includes two steps:
- Checking the settings. This steps takes no more than one business day.
Testing a device with a skill. Agree and conduct remote testing by video call: it won't take more than an hour.
- Account linking works correctly: the devices connected in the provider's app show up as expected in the Yango Play app interface.
- The devices are running as expected.
- The state of devices changes correctly.
- The skill works without errors.
- The skill responds to each request within three seconds.
It takes no more than 2 weeks total between applying and getting the moderation result. You'll see the result of each moderation step in the developer console.
Skills awaiting moderation can't be edited. To edit a skill, in the developer console, open the skill page and click Return to development. The skill will be removed from moderation.
Blocking a skill
- The skill responds to one out of five requests with an error.
- The skill doesn't respond for 24 hours.
- Users have reported the skill.
The blocked skill will disappear from the Yango Play app and won't be available to new users. If users have already launched the skill, they will be able to launch it again.
To avoid skill lock, keep track of its quality. Analyze the statistics of requests addressed to the skill to detect errors in a timely manner. For more information, see Skill monitoring.
Frequently asked questions
The reason is that SSL certificates are installed incorrectly. Check their status using the SSL Labs online service.
For the skill to run correctly, set up the SSL certificate chain on the web server or in the provider service.
If your skill doesn't respond for several hours or users have reported it, the skill gets blocked. Check that the skill matches it's operating protocol, fix errors, and resubmit it for moderation.
Open the skill in the developer console, then click Return to development.
To submit a private skill for self-moderation, select the skill in the developer console, then click Deploy.
The skill will become searchable within 24 hours of publication. To get a link to a skill, open it in the developer console and go to the Promotion tab. A direct link will appear within 10 minutes after publication.