glaucia86 / hands-on-bots-node

Repositório responsável pelas vídeo aulas inerentes a nova série do canal: Hands on

Hands On: Bots + Node.Js - Microsoft Bot Framework v.3 (Glaucia Lemos)

Repositório responsável pelos códigos desenvolvidos das vídeos aulas inerentes a nova série do meu canal do Youtube! Essas vídeos aulas servirão também de material de apoio para a Maratona Bots que está ocorrendo no site: TI Capacitacion

Todo o conteúdo desenvolvido aqui, estão destinados a linguagem Node.Js. Caso queira aprender a desenvolver um Bot usando C#, acompanhe as vídeos aulas da Maratona Bots!

Porém, estarei desenvolvendo as demos relacionadas aos códigos inerentes a Node.Js da Maratona Bots. Estarei diferenciando os códigos e vídeos da maratona via link do próprio repositório em questão e destacando nas grids também.

Recursos Utilizados no Desenvolvimento: 🚀

Para realizar as demos dessa série, se faz necessário instalar os seguintes programas:

• Visual Studio Code - DOWNLOAD AQUI

• Node.JS - DOWNLOAD AQUI

• Microsoft Bot Framework Emulator - DOWNLOAD AQUI

• Instalar a versão Python 2.x - DOWNLOAD AQUI

• Instalar globalmente o node-gyp - DOCUMENTAÇÃO PARA INSTALAÇÃO DE MANEIRA CORRETA AQUI

• Cadastro no site LUIS: https://www.luis.ai/

• Cadastro no site Azure: https://azure.microsoft.com/services/bot-service/?WT.mc_id=javascript-0000-gllemos

OBS.: Quando seguir o passo da instalação do node-gyp é de suma importância que façam o seguinte:

Passo 1: criar manualmente o arquivo binding.gyp dentro do diretório do node_modules do appData, conforme o exemplo abaixo:

> C:\users\UserName\appdata\roaming\npm\node_modules\node-gyp

Passo 2: incluir no arquivo binding.gyp o seguinte bloco de código e salve:

{
    "targets": [{
    "target_name": "binding",
    "sources": [ "build/Release/binding.node" ]
    }]
}

Passo 3: feito isso, agore execute os seguintes comandos abaixo, dentro do mesmo diretório do appData:

> node-gyp configure

> node-gyp configure --msvs_version=2015

> node-gyp build

Seguindo todos esses passos, vocês estará para pronta para instalar as depedências do projeto na pasta do projeto! ;)

Atualização da Instalação (node-gyp) 11/2018:

Devido a nova versão do Node.js, houve mudanças significativas inerente aos passos acima para a instalação do pacote node-gyp. Após a versão 10.x do Node.js bastam seguir os seguintes passos:

1º - Desinstale da sua máquina o Node.js

2º - Exclua a pasta npm localizada no AppData: (remove manualmente):

C:\Users\<folder-name>\AppData\Roaming\npm directory was not deleted.

3º - Reinstale a última versão do Node.js 10.x: https://nodejs.org/en/

4º - Abre agora o prompt de comando como administrador e execute o comando abaixo:

> npm install npm@latest -g

5º - E finalmente, instale globalmente o pacote node-gyp no prompt de comando como adminstrador:

> npm install -g node-gyp

Depois de seguir esses passos, vá até o local onde está o projeto e digite o comando:

> npm install

O problema será resolvido! :)

O que Preciso Saber para prosseguir na série?!

• Ter noções de JavaScript:

  • Desvendando a linguagem JavaScript (Rodrigo Branas): AQUI

• Ter noções de Node.js:

  • Tutorial: CRUD API RESTful com: Node + Express + MongoDb (Glaucia Lemos): AQUI

  • Curso: Criando APIs com NodeJs (Baltaio): AQUI

Demos Relacionadas ao Hands on (Node.JS):

Módulo	Aula	Código	Link (Vídeo Demo)
Módulo 2	Aula 03	Código	Aula 03
Módulo 2	Aula 04	Código	Aula 04
Módulo 2	Aula 06	Código	Aula 06
Módulo 2	Aula 07	Código	Aula 07
Módulo 3	Aula 09	Código	Aula 09
Módulo 3	Aula 10	Código	Aula 10
Módulo 3	Aula 12	Código	Aula 12
Módulo 3	Aula 13	Código	Aula 13
Módulo 4	Aula 15	Código	Aula 15
Módulo 4	Aula 16	Código	Aula 16
Módulo 4	Aula 17	Código	Aula 17

Demos Relacionadas a Maratona Bots (Node.JS):

Módulo	Lição	Código	Link (Vídeo Demo)
Exercícios Módulo 2	Lições: 2 & 3	Código	Módulo 2
Exercícios Módulo 3	Lições: 1-5	Código	Módulo 3
Exercícios Módulo 4	Lições: 1-5	Código	Módulo 4
Exercícios Módulo 5	Lições:	Código	Módulo 5

Conteúdo da Série: Hands On: Bots + Node.Js - Microsoft BOT Framework (* em desenvolvimento)

• Módulo 01: Breve Introdução sobre Bots

  • Aula 01 - Breve Introdução sobre Bots

• Módulo 02: Desenvolvendo o meu primeiro Bot!

  • Aula 02 - Preparando o Ambiente de Desenvolvimento
  • Aula 03 - Desenvolvendo Bot via Console
  • Aula 04 - Desenvolvendo Bot via Bot Emulator
  • Aula 05 - Conceitos Chaves do Bot Builder SDK em Node.Js
  • Aula 06 - Demo: Bot com Connector & Dialog via Console
  • Aula 07 - Demo: Bot com Connector & Dialog via Emulator

• Módulo 03: Bots Conversam?! Sim Senhor!

  • Aula 08 - Conceitos sobre Dialogs (Teoria)
  • Aula 09 - Demo: Uso do método 'beginDialog'
  • Aula 10 - Demo: Uso do método 'endDialog'
  • Aula 11 - Armazenamento de Dados em Dialogs (Teoria)
  • Aula 12 - Demo: Uso da propriedade 'userData'
  • Aula 13 - Demo: Uso da propriedade 'dialogData'

• Módulo 04: (em desenvolvimento)

  • Aula 14 - Conceitos sobre Tipos de Prompts (Teoria)
  • Aula 15 - Demo: Uso de 'Prompts.confirm'
  • Aula 16 - Demo: Uso de 'Prompts.choice'
  • Aula 17 - Demo: Uso de Diferentes Tipos de Prompts
  • Aula 18 - Demo: Fluxo de Conversação: Waterfalls
  • Aula 19 -

aulas em desenvolvimento

Algumas Observações Importantes!!! 🔥

p.s.:As aulas procurarei estar enviando o maior número possível. Como estou fazendo o Hands on e ao mesmo tempo desenvolvendo as demos em vídeo em Node.Js da Maratona Bots, leva-se um tempo para editar e enviar vídeos. Assim que, peço que aguardem por novas vídeos aulas.

p.s.2: Quando tiver algum tema que não ficou compreensível a todos, estarei explicando via README.md. Com o propósito de criar uma documentação sobre o assunto para Node.

Quer Propor Melhorias no Código? Façam Pull Request!!!

Caso queiram que eu implemente algo no código, abram uma ISSUE nesse repositório. Assim, todos poderão colaborar para o melhor desenvolvimento desse repositório. E sintam-se à vontade em fazer Pull Requests!!

Espero que possam gostar das vídeos aulas dessa nova série no meu canal!!! Não esqueçam de dar uma ⭐ no repositório e claro: Apreciem sem moderação!! ❤️ ❤️ ❤️

hands-on-bots-node's Issues

Descobrindo qual intenção retornou do LUIS

Olá Glaucia

Eu sei que depois de chamar o builder.UniversalBot eu consigo interceptar as mensagens que estão trafegando entre o bot e o usuário.

const bot = new builder.UniversalBot(connector)
bot.use({
    botbuilder: (session, next) => {
        console.log('botbuilder', session.message.text)
        next()
    },
    send: (event, next) => {
        console.log('event', event)
        next()
    }
})

Porém eu gostaria de saber se eu estiver trabalhando com o LUIS em que momento eu consigo descobrir que intent foi retornada do LUIS, para que eu possa gravar em um DB essa informação.

Erro ao Subir servidor

ao Tentar subir o Servidor apresenta um erro. Cheguei a copiar seu codigo para ver se era erro do meu e continuou.
erro:

[nodemon] 1.18.4
[nodemon] to restart at any time, enter rs
[nodemon] watching: .
[nodemon] starting node saudacao.js
module.js:549
throw err;
^

Error: Cannot find module 'restify'
at Function.Module._resolveFilename (module.js:547:15)
at Function.Module._load (module.js:474:25)
at Module.require (module.js:596:17)
at require (internal/module.js:11:18)
at Object. (D:_TCCBot\src\Modulo-3\saudacao.js:6:17)
at Module._compile (module.js:652:30)
at Object.Module._extensions..js (module.js:663:10)
at Module.load (module.js:565:32)
at tryModuleLoad (module.js:505:12)
at Function.Module._load (module.js:497:3)
[nodemon] app crashed - waiting for file changes before starting...

Dúvida ao trabalhar com Intent + Dialog

Olá Glaucia,

Existe alguma maneira de eu mesclar o dialogo com a intenção para que eu não precise ter o trecho de código redundante?

bot.dialog('whats-your-name', require('./dialogs/whats-your-name'))
intents.matches('whats-your-name', require('./dialogs/whats-your-name'))

Utilizando o session.userData

Dúvida ref. a aula 11

Uma dúvida é se eu estiver atribuindo um dado, por exemplo:
session.userData.name = "Fulano"

Para eu conseguir resgatar esse dado em outro diálogo eu preciso chamar o método session.save() ou não precisa?

Prompts.confirm em inglês

Olá Glaucia,
Antes de tudo parabéns pelo material!

Na aula 15 você mostra o uso do Prompts.confirm no meu caso, eu nao havia configurado o locale como pt-br e as opções vieram como yes | no.

Tem como forçar que as opções sejam em português sem usar o Prompts.choice e definir na mão?

Obrigado

Botão "Começar" para o canal Facebook

Não consegui encontrar na documentação como inserir o botão "Começar" para o canal facebook, alguém chegou a fazer isso?