NNocSuiteDocumentação

Docs / Começar

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.

Atualizado 2026-11-09

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.json e config/alexa/modelo-interna.pt-BR.json.

Passo a passo: skill NocSuite (agenda)

  1. No console da Alexa, clique em Create Skill. Nome: NocSuite. Idioma principal: Portuguese (BR). Tipo: Custom. Hospedagem: Provision your own. Modelo: Start from scratch.
  2. 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.
  3. 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.
  4. Copie o Skill ID (começa com amzn1.ask.skill.) para a variável ALEXA_PUBLIC_SKILL_ID.
  5. 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.

  1. 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 para ALEXA_APP_LINK_CLIENT_ID e ALEXA_APP_LINK_CLIENT_SECRET. Deixe ALEXA_PUBLIC_SKILL_STAGE como development até a skill ser publicada; depois mude para live.
  2. Em Test, ligue o teste em Development. Ela já funciona nos Echos da sua conta Amazon.

Passo a passo: skill NocSuite interno

  1. Crie outra skill do mesmo jeito, com o nome NocSuite interno.
  2. Cole modelo-interna.pt-BR.json no JSON Editor. O nome de invocação vem como "noc suite interno".
  3. Use o mesmo endpoint, https://nocsuite.com.br/api/alexa. O Skill ID vai para ALEXA_INTERNAL_SKILL_ID.
  4. No Account Linking, use as mesmas duas URLs e outro Client ID e Secret (por exemplo, nocsuite-interna). Eles vão para ALEXA_INTERNAL_OAUTH_CLIENT_ID e ALEXA_INTERNAL_OAUTH_CLIENT_SECRET. Se os Alexa Redirect URLs forem diferentes dos da outra skill, acrescente-os em ALEXA_OAUTH_REDIRECT_URIS. Não ligue o vínculo pelo app nesta skill.
  5. 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

  1. 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.
  2. 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.
  3. 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.
  4. 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.

Este artigo também está disponível no ERP: /ajuda/comecar/alexa.

NocSuite Docs — NocSuite