Ao criar uma skill, precisamos sempre ter em mente facilitar a vida do usuário, certo?
Nesse artigo eu vou te mostrar como acessar dados de contato do usuário.
Vamos conversar sobre como você pode utilizar dados de contato para criar uma experiencia melhor para seu usuário.
Acessar Dados De Contato
Já mostrei aqui no canal que para saber qual é o nome do usuário da nossa skill, podemos simplesmente perguntar e armazenar a resposta para usar depois.
Mas existe uma outra maneira de obtermos este tipo de informação do usuário: através da conta Alexa do usuário.
Sua skill pode terá acesso ao que a Amazon chama de dados de contato: nome, e-mail e telefone do usuário.
Além de chamar o usuário pelo nome, para que podemos utilizar estas informações? Vamos ver alguns exemplos?
- Numa skill de viagens, podemos enviar torpedos para o celular do usuário para confirmar os preparativos da viagem.
- Numa skill de receitas, podemos oferecer novas receitas e recomendações de livros detalhadas por e-mail.
Mas como acessar dados de contato do usuário da nossa skill?
Como Configurar A Skill Para Acessar Dados De Contato?
Vá até o Console do Desenvolvedor e configure sua skill assim:
- Na aba Build, clique em Permissions no menu esquerdo.
- Selecione as informações de que sua skill precisa
Você pode selecionar as seguintes informações:
- Endereço do dispositivo;
- Nome do usuário: você pode escolher entre o primeiro nome ou o nome completo.
- Endereço de E-mail;
- Número de telefone;
É aqui também que você informa que sua skill precisa acessar outros recursos, como Lembretes, Alarmes, Listas, etc.
Cuidados Ao Acessar Dados De Contato
Para proteger os dados do usuário, precisamos atender a alguns pré-requisitos.
A Amazon pode rejeitar a certificação da sua skill por conta de um destes pontos. Portanto, muito cuidado ao criar uma skill que acessa dados do usuário.
- Inclua um link para a Política de Privacidade na aba Distribuição.
- Sua skill não deve ser dirigida a crianças. Já falamos um pouco sobre skills infantis aqui.
- Você deve solicitar permissão para receber informações de contato do usuário somente quando estritamente necessário.
- Você não deve usar as informações do usuário para vincular a conta do cliente em segundo plano.
- A skill deve chamar a API Alexa Customer Profile para obter as informações mais recentes do usuário sempre que uma solicitação precisar dessas informações.
Qualquer uma das informações solicitadas podem não estar disponíveis quando solicitado. Portanto, seu código deve lidar com as informações ausentes normalmente.
Lembrando que os dados de contatos não são verificadas.
E Como Acessar Dados De Contato?
- Crie um ServiceClientFactory
- Utilize o UpsServiceClient para chamar a API Alexa Customer Profile
- Chame um método para obter a informação requerida
getProfileEmail()
getProfileGivenName()
getProfileMobileNumber()
getProfileName()
Todos os métodos são assíncronos
E para saber se o usuário deu a permissão que você precisa, cheque as Permission Values:
- Nome completo – alexa::profile:name:read
- Primeiro nome – alexa::profile:given_name:read
- Endereço de e-mail – alexa::profile:email:read
- Número de telefone – alexa::profile:mobile_number:read
Palavras Finais
Quando um usuário ativa sua skill, ela pode solicitar a permissão do usuário para acessar dados de contato, que incluem seu nome, e-mail e telefone.
Você pode então usar esses dados para oferecer suporte a intenções personalizadas para aprimorar a experiência do usuário sem precisar utilizar a vinculação de contas (Account Linking).
Meu e-book com 4 passos para criar sua primeira skill Alexa está GRATUITO por tempo limitado!
Olha o link: 👉🏼 http://celsokitamura.com.br/minha-primeira-skill-alexa
Bora aprender a desenvolver skills para Alexa!