Skip to content

Latest commit

 

History

History
143 lines (99 loc) · 4.45 KB

README.md

File metadata and controls

143 lines (99 loc) · 4.45 KB

Alexa - Newsletter Filipe Deschamps



Ver Demo · Reportar Bug · Solicitar Feature

Sobre o projeto

Skill de conversação para Alexa com objetivo de consumir a newsletter do Filipe Deschamps.

Está Skill consome os dados de um google sheet, onde armazenos as notícias de tecnologias que são enviadas na newsletter por e-mail. Neste repositório temos dois códigos, o primeiro é uma Custom Skill e o segundo é um Flash Briefing. Explico com mais detalhes a frente.

Tecnologias

Este projeto foi desenvolvido utilizando:

Custom Skill

A skill customizada realiza a leitura do conteúdo que está no Google Sheets e retorna para o usuário o texto com todas as notícias. O código está na pasta: custom skill newsletter

  • Vantagens: Conseguimos ler todas as notícias.

  • Desvantagens: Não é possível separar uma notícia de outra nem configurar de forma fácil para o resumo diário da Alexa.

Flash Briefing

É gerado um arquivo JSON que será enviado para o S3 da Amazon e após isso lido pela Alexa para ser apresentado no Flash Briefing (Resumo de notícias) do usuário.

Exemplo JSON:

[
   {
      "uid": "b89847c0-bd29-4ae6-a983-e1e715811b32",
      "updateDate": "2021-04-20T15:10:03.335Z",
      "titleText": "Notícias que chamaram a nossa atenção nesta terça-feira:",
      "mainText": "Notícias que chamaram a nossa atenção nesta terça-feira: ",
      "redirectionUrl": "https://filipedeschamps.com.br/newsletter"
   },
   {
       ...
   }
]
  • Vantagens: Conseguimos separar as notícias e adicionar ao resumo diário da Alexa

  • Desvantagens: Limite de 5 notícias por vez.

Rodando o projeto

Adicione suas credenciais no arquivo: client_secret_example.json, você pode encontrar estes dados no console do Google Cloud Platform.

Atualizei o arquivo .env com as suas credenciais do Amazon SDK.

Há dois modos de rodar o script para ler as notícias e gerar um JSON que será lido pela Alexa:

Docker Compose

docker-compose -f "docker-compose.yml" up -d --build

Docker

docker build -t docker-newsletter

docker run -it --name docker-newsletter docker-newsletter

Rodar uma única vez

### Para instalar os pacotes

npm install

### Rodar o script

yarn start

ou

npm run start

Contribuindo

Contribuições são o que tornam a comunidade de código aberto um lugar incrível para aprender, inspirar e criar. Quaisquer contribuições que você fizer serão muito apreciadas.

  1. Fork o projeto (Botão de Fork no Github)
start https://github.com/jjeanjacques10/alexa-newsletter-deschamps
  1. Criei sua Feature Branch
git checkout -b feature/AmazingFeature
  1. Commit suas alterações
git commit -m 'Add some AmazingFeature'
  1. Push para a Branch
git push origin feature/AmazingFeature
  1. Abra um Pull Request (Botão de Pull Request no Github)
start https://github.com/jjeanjacques10/alexa-newsletter-deschamps/pulls

Skills na Loja Amazon

Você pode testar acessando:

Star History

Star History Chart

Licença

Distribuído sob a licença MIT. Veja LICENSE para mais informações.

Autor


@jjeanjacques10