Para disponibilizar seu assistente digital (ou habilidade standalone) na Cortana, registre-o por meio do Serviço de Bot do Azure.

Antes de criar esse registro, você precisa ter uma conta da Microsoft.

Para criar o registro:

1. Vá para https://portal.azure.com/ e faça log-in com sua conta da Microsoft.

2. No campo Pesquisar, procure e selecione Registro de Canais de Bot.

3. Na página Registro de Canais de Bot, preencha o campo Nome do Bot com o texto que você deseja usar como nome de chamada ao acessar seu assistente digital por meio do canal Cortana.

4. Preencha os demais campos obrigatórios.

5. Role para baixo e selecione Criar automaticamente o ID do Aplicativo e a senha. Em seguida, clique no botão para Criar automaticamente o ID do Aplicativo e a senha no painel que é aberto.

6. Clique em Criar.

7. Aguarde um minuto ou dois para que o registro do bot seja criado e implantado.

   Ao concluir, você receberá uma notificação de que a implantação foi bem-sucedida.

8. Na notificação, clique em Ir para o recurso.

   Se a notificação desaparecer antes de clicar nela, você poderá abri-la novamente clicando no ícone Notificações na parte superior da página.
   
   Descrição da ilustração azure-notification.png
   

9. Na barra de navegação esquerda, em Gerenciamento de Bots, selecione Configurações.

10. Copie o valor do ID do Aplicativo Microsoft e salve-o em um local seguro.

11. Gere e salve um segredo do cliente. Você pode fazer isso da seguinte forma:

    1. Clique no botão Gerenciar ao lado do ID do aplicativo.

       Isso leva você até a console do Microsoft Bot Framework.

    2. Clicando em Exibir este aplicativo no portal do Azure.

       Isso retorna você para o Azure.

    3. Na navegação esquerda, clicando em Certificados e segredos.
    4. Clicando em + Novo Segredo do Cliente.
    5. Clicando em Adicionar.
    6. Copiando o segredo do cliente e salvando-o em um local seguro no seu sistema.

    Você precisará do ID do aplicativo e do segredo do cliente para configurar o canal no Digital Assistant.

12. Agora que você copiou o segredo do cliente, feche a caixa de diálogo Certificados e segredos.

13. Deixe o Portal do Azure aberto no browser.

    Posteriormente, você concluirá o registro com um URL do webhook que você obtém quando cria o canal no Digital Assistant.

1. No Digital Assistant, clique em Canais no menu esquerdo e escolha Usuários.

2. Clique em + Canal para abrir a caixa de diálogo Criar Canal.

3. Dê um nome ao canal.

4. Escolha Cortana como tipo de canal.

5. Preencha o ID do Bot da Microsoft com o ID do Aplicativo Microsoft obtido quando você criou seu registro de bot no Azure.

6. Preencha a Senha do Microsoft Bot (Valor do Segredo do Cliente) com o valor do segredo do cliente que você obteve do registro de bot.

7. Clique em Criar.

8. Na página Canais, copie o URL do WebHook e cole-o em algum lugar conveniente no seu sistema.

9. Clique em e selecione o assistente digital ou a habilidade que deseja associar ao canal.

10. Alterne para ativado o controle Canal Ativado.

1. Na guia do browser na qual o Portar do Azure está aberto, use o campo Pesquisar para navegar para trás no seu registro de bot.

2. Na barra de navegação esquerda, selecione Configurações.

3. No campo Ponto final de mensagens, cole o URL do webhook que você obteve ao criar o canal no Digital Assistant.

4. Salve suas alterações.

5. No Serviço de Bot, na barra de navegação esquerda, role para baixo até a seção Gerenciamento de Bots e clique em Canais.

6. Clique no ícone da Cortana.

7. Após a configuração do canal, clique em Implantar na Cortana.

Concluída a configuração do canal e das mensagens da Cortana, você pode testar seu bot (assistente digital ou habilidade) na Cortana.

O teste pode ser feito usando uma das seguintes opções:

• No Portal do Azure, com o recurso Testar em Web Chat (em Gerenciamento de Bots).
• Pelo aplicativo Cortana (no desktop ou dispositivo móvel), usando o mesmo ID do usuário que você utilizou ao configurar o registro de bot no Azure.

  Quando você testar usando esse método, inclua o nome do bot (conforme registrado no Portal do Azure) sempre que digitar algo na janela de chat. Caso contrário, a Cortana não reconhecerá necessariamente que você está tentando falar com o assistente digital da Oracle.

Os canais Cortana do Digital Assistant suportam as seguintes capacidades:

• texto (envio e recebimento)
• imagens (suporte total para envio; não há suporte para recebimento)
• arquivos (suporte total para envio; não há suporte para recebimento)
• emojis (suporte total para envio; não há suporte para recebimento)
• links
• componentes personalizados
• componentes de carrossel
• componentes de lista
• indicador de digitação

Os canais Cortana do Digital Assistant têm as seguintes restrições de mensagens:

• Mensagens de Texto
  • Tamanho máximo do label de ação do texto: 1 linha (cerca de 50 caracteres)
  • Tipos de ações de texto permitidos: Postback, Chamada, URL
• Cartões Horizontais
  • Tamanho máximo do título: 2 linhas (cerca de 80 caracteres)
  • Tamanho máximo da descrição: 25.000 caracteres
  • Tamanho máximo do label de ação do cartão: 1 linha (cerca de 50 caracteres)
  • Número máximo de cartões: 10
  • Número máximo de ações do cartão: 6. Se o número de ações do cartão passar de 6, o cartão será duplicado para renderizar o restante das ações.
  • Número mínimo de ações do cartão: 0.
  • Número máximo de ações da lista de cartões: 6
  • Pelo menos uma descrição, imagem ou ação é necessária?: Não
  • Tipos de ações de cartão permitidos: Postback, Chamada, URL
  • Tipos de ações da lista de cartões permitidos: Postback, Chamada, URL
• Cartões Verticais
  • Tamanho máximo do título: 2 linhas (cerca de 80 caracteres)
  • Tamanho máximo da descrição: 25.000 caracteres
  • Tamanho máximo do label de ação do cartão: 1 linha (cerca de 50 caracteres)
  • Número máximo de cartões: 10
  • Número máximo de ações do cartão: 3.
  • Número mínimo de ações do cartão: 0.
  • Número máximo de ações da lista de cartões: 6
  • Pelo menos uma descrição, imagem ou ação é necessária?: Não
  • Tipos de ações de cartão permitidos: Postback, Chamada, URL
  • Tipos de ações da lista de cartões permitidos: Postback, Chamada, URL
• Mensagens de Anexo
  • Suportado?: Sim
  • Tipos de ações permitidos: Postback, Chamada, URL
• Botões de Ação
  • Tamanho máximo do label de ação global: 1 linha (cerca de 50 caracteres)
  • Número máximo de ações globais: 6
  • Tipos de ações globais permitidos: Postback, Chamada, URL

Para canais Cortana, você pode estender a funcionalidade dos componentes de Resposta Comum com recursos específicos da Cortana.

Acesse as extensões usando o elemento channelCustomProperties no componente e definindo as propriedades apropriadas. O código tem o seguinte formato:

...
            channelCustomProperties:
            - channel: "cortana"
              properties:
                PROPERTY_NAME: "PROPERTY_VALUE"
...

Estas são as propriedades personalizadas disponíveis para canais Cortana:

Para obter mais informações sobre como usar channelCustomProperties, consulte Extensões Específicas do Canal.