Para que sua skill esteja disponível para os usuários em seus dispositivos habilitados para Alexa, ela deve passar por um processo de certificação completo. Este módulo orienta você sobre como preparar sua skill e enviá-la para certificação. O primeiro passo é validar e testar sua skill.
A validação faz o seguinte:
- Verifica se todos os campos da skill necessários para publicação estão completos.
- Executa um conjunto de testes de pré-certificação na skill. Esses testes enviam solicitações ao endpoint da sua skill.
Os testes são executados para todos os locais que sua skill suporta. Os problemas são listados por localidade.
Esses testes fornecem feedback imediato para falhas comuns de certificação. Você pode iniciar os testes e depois sair da página. Volte para a página para verificar o status e os resultados do teste.
Para executar esses testes, abra sua skill no Console do Portal dos Desenvolvedores de Alexa, e clique na guia Certification (Certificação). A página de validação é aberta e exibe todos os problemas encontrados.
Depois de corrigir um ou mais problemas, retorne à guia Certification (Certificação). Na página de validação, clique em Run (Executar) para executar novamente os testes.
Para um processo de certificação mais suave, corrija quaisquer problemas relatados pelos testes. Quando não há problemas restantes, a página exibe "Zero errors founds (zero erros encontrados)".
Os testes executam um subconjunto dos testes realizados durante o processo de certificação. Você ainda deve revisar as listas de verificação de certificação e garantir que sua skill passe em todos os testes listados antes de enviar.
A seção Validation (Validação) pode ajudá-lo a encontrar problemas que poderiam causar falhas na certificação. No entanto, isso não corresponde ao conjunto completo de testes realizados como parte da certificação. Para garantir que suas skills passem pela certificação, revise as listas de verificação de envio relevantes para o modelo de interação da sua skill e quaisquer recursos especiais.
Clique aqui para obter links para revisar as listas de verificação de envio disponíveis.
Quando você estiver pronto para enviar sua skill, navegue para Certification (Certificação)> Submission (Envio). Se sua skill passou nos testes de validação, você pode clicar em Submit for Review (Enviar para revisão) para enviar a skill.
Depois de enviar a skill, o status da skill mostra "In Review (Em revisão)". Enquanto a skill estiver no processo de certificação, você não poderá fazer alterações na configuração.
Se necessário, retire a skill do processo de certificação clicando em Withdraw from review (Retirar da revisão).
Quando você envia a skill, os testes funcionais de pré-certificação são executados automaticamente. Se a skill falhar em algum desses testes, ela é removida da certificação e retornada ao status de desenvolvimento. Se isso acontecer, você será notificado por e-mail para o endereço associado à sua conta do Portal dos Desenvolvedores.
Para visualizar o status de sua skill e quaisquer atualizações do processo de revisão de certificação, navegue até Certification (Certificação)> Submission (Envio). A seção Certification Updates (Atualizações de Certificação) mostra a data e a hora em que os resultados da certificação devem estar disponíveis, conforme mostrado na imagem a seguir.
Depois que a Amazon concluir a revisão da certificação, você receberá um e-mail no endereço associado à sua conta do Portal dos Desenvolvedores de Alexa:
- Se a skill foi certificada, o e-mail fornecerá uma estimativa de quando ela estará disponível para os usuários finais.
- Se a skill não pode ser certificada, o email fornecerá informações sobre os problemas que você precisa corrigir. Você pode fazer as alterações necessárias e, em seguida, reenviá-las.
Para as skills que passam na revisão de certificação, a página Submission (Envio) lista os países em que a skill está disponível. Algumas skills que passam na revisão de certificação não estão disponíveis em todos os países.
O status atual da publicação de uma skill é exibido no console do desenvolvedor em sua lista de skills.
A skill está disponível apenas para você. Se você tiver habilitado para teste, poderá testá-lo em dispositivos registrados em sua conta de desenvolvedor.
A Amazon está revisando sua skill para publicação. Durante esse período, você não pode alterar as configurações da skill.
A skill foi publicada e está disponível para os usuários. Você não pode editar configurações de skills publicadas.
Hidden (Oculta)
A skill foi publicada anteriormente, mas desde então foi ocultada. A skill não está mais disponível quando os clientes pesquisam ou navegam na loja de skills.
A skill foi publicada anteriormente, mas foi removida desde então. Os clientes não podem ativar ou usar a skill.
Uma skill oculta ainda está disponível para aqueles que a habilitaram antes que ela ficasse oculta.
Você pode reenviar uma skill Oculta ou Removida.
Depois que sua skill for publicada para os usuários finais, o status da sua skill será alterado para live. Você não pode alterar a configuração de uma skill que está publicada. Como qualquer alteração na configuração de skills exigiria uma nova certificação, uma nova versão de desenvolvimento é criada automaticamente no Console do Portal dos Desenvolvedores. Esta versão tem as mesmas informações que a versão original. Você pode usar essa versão para melhorar a skill e adicionar recursos.
Você pode trabalhar na nova versão independentemente da original. Por exemplo, para uma skill personalizada, você pode adicionar mais intenções e amostras de enunciados ao modelo de interação. Se você fizer alterações de código em seu serviço, deverá usar um endpoint ou uma função Lambda diferente para testar essas alterações, para não interromper os usuários que estão usando a versão publicada que está ativa.
Quando você envia sua nova versão para certificação, ambas as versões permanecem na sua lista até que a nova versão seja certificada. Depois que a nova versão for certificada, ela é publicada e finalmente substitui a versão anterior. Uma nova versão de desenvolvimento é criada para que você possa continuar fazendo atualizações.
Para uma melhor experiência do usuário, mantenha a compatibilidade com versões anteriores da sua skill. Por exemplo, se você adicionar novas intenções, continue dando suporte as intenções anteriores que os usuários já estão usando.
Você pode suprimir uma skill ativa para que os clientes não possam mais habilitá-la. A supressão se aplica à skill em todas as localidades. Você não pode suprimir uma skill apenas em algumas localidades e mantê-la disponível para usuários em outras.
Existem dois tipos de supressão de skills:
A skill permanece ativa para clientes que a ativaram anteriormente. A skill não está mais disponível quando os clientes pesquisam ou navegam na Alexa Skill Store.
A skill é desativada para todos os clientes, incluindo aqueles que a ativaram anteriormente. Os clientes não podem ativar ou usar a skill.
Quando você oculta ou remove uma skill, ela não é excluída e você ainda pode vê-la no Console do Portal dos Desenvolvedores. As versões suprimidas e de desenvolvimento são exibidas no console. Você pode continuar fazendo alterações na versão de desenvolvimento.
Para ocultar ou remover uma skill, siga os passos abaixo:
- Abra o Console do Portal dos Desenvolvedores de Alexa.
- Encontre a skill live existente na lista. Na coluna Actions (Ações), clique em Hide(Ocultar) ou Remove (Remover).
- Quando solicitado, selecione um motivo para a supressão de skills e clique em Hide(Ocultar) ou Remove (Remover).
Isso envia uma solicitação para ocultar ou remover a skill. A supressão pode levar alguns dias para ser concluída. Depois que a skill é suprimida, o status atualizado é exibido no console.
Para publicar novamente uma skill, atualize a versão de desenvolvimento e envie novamente para certificação. O reenvio inicia um novo processo de certificação.
