Alexa no NocSuite
Perguntar à Alexa pela agenda (skill NocSuite) e, para o dono, pelo dinheiro e pelo atendimento (skill interna). Como criar, vincular e testar.
Alexa no NocSuite
O que você vai fazer
Ligar a Alexa ao NocSuite para perguntar coisas em voz alta. A Alexa só lê: não marca consulta, não recebe e não manda mensagem para ninguém.
São duas skills, com o mesmo endereço no sistema:
| Skill | Para quem | O que responde | Vai para a loja da Alexa? |
|---|---|---|---|
| NocSuite (agenda) | Profissionais e recepção de qualquer clínica | Próxima consulta, consultas de um dia (de 5 em 5), próximo horário livre e o resumo do dia | Sim, depois da certificação da Amazon |
| NocSuite interno | Só o dono | Quanto entrou hoje, total vencido a receber, o que vence hoje, conversas sem resposta, ordens de serviço abertas | Não. Fica em teste, na conta do dono |
A skill da agenda fala o horário e o tipo da consulta ("às 14 horas, avaliação"), sem o nome do paciente. Em Configurações › App da equipe › Alexa dá para ligar Falar o primeiro nome do paciente (vem desligado). Valores, procedimentos e dados da ficha nunca são falados.
Antes de começar
- Uma conta de desenvolvedor da Amazon em developer.amazon.com, com a mesma conta Amazon dos aparelhos Echo que vão usar a skill em teste.
- O suporte do NocSuite precisa colocar no servidor as variáveis que aparecem nos passos abaixo (nomes começando por
ALEXA_) e publicar a versão com a Alexa. - Os modelos de frases ficam no sistema, em
config/alexa/modelo-publica.pt-BR.jsoneconfig/alexa/modelo-interna.pt-BR.json.
Passo a passo: skill NocSuite (agenda)
- No console da Alexa, clique em Create Skill. Nome: NocSuite. Idioma principal: Portuguese (BR). Tipo: Custom. Hospedagem: Provision your own. Modelo: Start from scratch.
- Em Build › Interaction Model › JSON Editor, cole o conteúdo de
modelo-publica.pt-BR.json, clique em Save e depois em Build skill. O nome de invocação vem como "noc suite"; se no teste a Alexa não entender, troque aqui. - Em Build › Endpoint, escolha HTTPS e, em Default Region, ponha
https://nocsuite.com.br/api/alexa. No certificado, escolha a opção de certificado de autoridade confiável. - Copie o Skill ID (começa com
amzn1.ask.skill.) para a variávelALEXA_PUBLIC_SKILL_ID. - Em Build › Tools › Account Linking, ligue o vínculo de conta e preencha:
- Tipo: Auth Code Grant. - Web Authorization URI: https://nocsuite.com.br/alexa/vincular. - Access Token URI: https://nocsuite.com.br/api/alexa/oauth/token. - Your Client ID: um nome seu, por exemplo nocsuite-publica. Vai para ALEXA_PUBLIC_OAUTH_CLIENT_ID. - Your Secret: uma senha longa gerada na hora. Vai para ALEXA_PUBLIC_OAUTH_CLIENT_SECRET. - Your Authentication Scheme: HTTP Basic. - Scope: agenda. - Domain List: nocsuite.com.br. - Default Access Token Expiration Time: 3600. - Copie os três Alexa Redirect URLs que o console mostra, separados por vírgula, para ALEXA_OAUTH_REDIRECT_URIS.
- Ainda em Account Linking, ligue Allow users to link their account to your skill from within your application or website (vínculo pelo app). Em Your Redirect URLs, ponha
https://nocsuite.com.br/alexa/vinculo-app. O console mostra um Alexa Client ID e um Alexa Client Secret: vão paraALEXA_APP_LINK_CLIENT_IDeALEXA_APP_LINK_CLIENT_SECRET. DeixeALEXA_PUBLIC_SKILL_STAGEcomodevelopmentaté a skill ser publicada; depois mude paralive. - Em Test, ligue o teste em Development. Ela já funciona nos Echos da sua conta Amazon.
Passo a passo: skill NocSuite interno
- Crie outra skill do mesmo jeito, com o nome NocSuite interno.
- Cole
modelo-interna.pt-BR.jsonno JSON Editor. O nome de invocação vem como "noc suite interno". - Use o mesmo endpoint,
https://nocsuite.com.br/api/alexa. O Skill ID vai paraALEXA_INTERNAL_SKILL_ID. - No Account Linking, use as mesmas duas URLs e outro Client ID e Secret (por exemplo,
nocsuite-interna). Eles vão paraALEXA_INTERNAL_OAUTH_CLIENT_IDeALEXA_INTERNAL_OAUTH_CLIENT_SECRET. Se os Alexa Redirect URLs forem diferentes dos da outra skill, acrescente-os emALEXA_OAUTH_REDIRECT_URIS. Não ligue o vínculo pelo app nesta skill. - Não envie para certificação. Use em Test › Development, nos Echos da conta do dono. Para outra pessoa testar, use Distribution › Availability › Beta Test: até 500 e-mails, por 90 dias; depois disso, crie um beta novo.
Vincular a conta
- Pelo app NocSuite Equipe (skill da agenda): Mais › Amazon Alexa, escolha de quem é a agenda e toque em Vincular. O app Alexa abre e pede para aceitar. Sem o app Alexa, toque em Não tenho o app Alexa para entrar pela Amazon no navegador.
- Pelo app Alexa (as duas skills): abra a skill, toque em Ativar (ou Configurações › Vincular conta) e entre com o e-mail e a senha do NocSuite. Se a conta usa o aplicativo autenticador, o código é pedido em seguida. Na skill da agenda, escolha de quem é a agenda e toque em Aceitar e vincular.
- É preciso ter permissão de ver a agenda. Cada vínculo é de uma pessoa, numa empresa, e lê só a agenda escolhida.
Testar no Echo
- "Alexa, abra o noc suite."
- "Alexa, pergunte ao noc suite qual minha próxima consulta."
- "Alexa, pergunte ao noc suite quais consultas tenho amanhã." Depois de 5, ela pergunta se quer ouvir as próximas.
- "Alexa, pergunte ao noc suite qual meu próximo horário livre."
- "Alexa, pergunte ao noc suite qual o resumo do meu dia."
- Na interna: "Alexa, pergunte ao noc suite interno quanto entrou hoje", "... quem está devendo", "... o que vence hoje", "... quantas mensagens estão sem resposta", "... quantas ordens de serviço estão abertas".
Enviar a skill da agenda para a certificação
- Em Distribution › Skill Preview, preencha nome, descrição curta e longa, três frases de exemplo (as de cima), ícones de 108 e 512 px e a categoria. Em Privacy Policy URL, ponha
https://nocsuite.com.br/privacidade; em Terms of Use URL,https://nocsuite.com.br/termos. - Em Privacy & Compliance, responda que a skill não vende nada, não tem propaganda, não é para crianças e trata dados pessoais. Isso é preciso, porque ela lê a agenda.
- Em Testing Instructions, informe uma conta de teste do NocSuite sem o aplicativo autenticador, com agenda preenchida. Explique que a skill só lê a agenda de um profissional, sem nome de paciente nem valores.
- Em Certification › Validation, rode a validação e envie. A Amazon não diz quanto tempo leva. Se recusar, o motivo vem por e-mail e no console.
Desconectar
- No app NocSuite Equipe: Mais › Amazon Alexa › Desconectar.
- No computador, para quem administra usuários: Configurações › App da equipe › Alexa › Desconectar.
- No app Alexa: desativar a skill.
Trocar a senha do NocSuite ou sair de todos os aparelhos também desconecta a Alexa.
Se algo der errado
| O que aparece | O que fazer |
|---|---|
| A Alexa pede para vincular a conta | Vincule de novo. Isso acontece depois de troca de senha ou de desconectar. |
| "Seu usuário não tem mais permissão para ver a agenda" | Peça a quem administra para dar a permissão de ver a agenda. |
| "O sistema demorou para responder" | Tente de novo em instantes. |
| No app: "O vínculo pelo app ainda não foi ligado no servidor" | Faltam as variáveis ALEXA_APP_LINK_* no servidor; fale com o suporte. |
| A página de vínculo diz que o pedido não veio da skill | Confira, no console, o Client ID e os Alexa Redirect URLs passados ao suporte. |