Giter Club home page Giter Club logo

satena-bot's Introduction

Satena Bot

Satena Bot é uma aplicação Node.js voltada para automação de envio de mensagens. Utilizando uma integração com o Google Sheets e Z-API, esta ferramenta permite o envio automatizado de mensagens de WhatsApp tanto de forma massiva quanto individual. Atualmente, em sua versão alpha, Satena Bot foca no envio de mensagens de texto, com planos futuros para expandir suas capacidades.

Funcionalidades

Atualmente, o Satena Bot suporta:

  • Envio de Mensagens em Massa: Envie mensagens personalizadas para uma lista de contatos armazenada no Google Sheets. Ideal para campanhas de marketing, notificações em larga escala e comunicação de eventos.
  • Envio de Mensagens Unitárias: Possibilidade de enviar mensagens individualizadas, permitindo maior personalização no contato com cada destinatário.
  • Configuração Flexível: Através de um arquivo de configuração, é possível personalizar o template da mensagem, definindo como as mensagens devem ser apresentadas aos destinatários.

Planos futuros incluem a integração com outras plataformas de mensagens, suporte a mensagens multimídia e a construção de uma interface gráfica para facilitar a configuração e o uso.

Instalação

  1. Clone o repositório:

    git clone https://github.com/Lag0/satena-bot.git
    cd satena-bot
    
  2. Instale as dependências:

    npm install
    

Configuração Passo a Passo

Antes de utilizar o Satena Bot, uma configuração inicial é necessária.

1. Variáveis de Ambiente

  • Duplique o arquivo .env.example e renomeie a cópia para .env.
  • Preencha os valores de acordo com suas credenciais do Google Cloud e configurações da API de mensagens.

2. Arquivo de Configuração config.json

  • Abra config-template.json no seu editor de texto favorito.

  • Renomeie o arquivo para config.json.

  • Atualize com as informações específicas do seu projeto, como abaixo:

    {
      "GOOGLE_SHEET_ID": "<ID_DA_SUA_PLANILHA>",
      "GOOGLE_SHEET_INDEX": 0,
      "GOOGLE_SHEET_NAME_COLUMN_INDEX": 2,
      "GOOGLE_SHEET_PHONE_COLUMN_INDEX": 5,
      "ZAPI_ENDPOINT": "<SEU_ENDPOINT_DA_API_DE_MENSAGENS>",
      "CLIENT_TOKEN": "<SEU_TOKEN_DA_API_DE_MENSAGENS>",
      "MESSAGE_TEMPLATE": "Olá {{nome}}, sua mensagem personalizada aqui.",
      "MESSAGE_DELAY_MIN_MS": 1000,
      "MESSAGE_DELAY_MAX_MS": 5000
    }

    Nota: Certifique-se de substituir <ID_DA_SUA_PLANILHA>, <SEU_ENDPOINT_DA_API_DE_MENSAGENS> e <SEU_TOKEN_DA_API_DE_MENSAGENS> pelos valores correspondentes.

3. Permissões do Google Sheets

  • Adicione o email da conta de serviço do Google Cloud (fornecido no .env como GOOGLE_SERVICE_ACCOUNT_EMAIL) como um usuário autorizado na sua planilha do Google Sheets.

Uso

Para iniciar o envio de mensagens, execute:

node index.js

O programa processará os contatos especificados na sua planilha do Google Sheets e enviará as mensagens de acordo com o template configurado.

Contribuindo

Contribuições são muito bem-vindas! Para contribuir, por favor, abra um pull request ou issue.

Licença

[Inserir Licença]

satena-bot's People

Contributors

lag0 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.