
Seja muito bem-vindo a Join Developer!
Uma empresa focada em oferecer produtos de qualidade para que os negócios tenham as ferramentas necessários para agregar ainda mais valor aos seus clientes, fazendo com que as empresas cresçam e atinjam mais pessoas.
Meu nome é Luan Gabriel Hayakawa Duarte, sou o produtor deste curso e estarei contigo em todas as próximas aulas até o código fonte estar rodando em seu servidor, pronto para ser integrado a seus sistemas e soluções.
ATENÇÃO: Veja todos os vídeos do curso antes de começar a usar em seu próprio servidor! Isto é importantíssimo para conseguir usar a API by yourself, por você mesmo. Ok?
Enjoy it. Aproveite bastante o nosso curso e a qualidade de nosso produto!
Instalando a API no Windows
Instalar o Git
- Faça o Download no link: https://git-scm.com/download/win
Instalar o NodeJs
- Faça o Download no link: https://nodejs.org/en/download
Instalar o MongoDb
- Faça o Download no link: https://www.mongodb.com/try/download/community
Instalar o NPM
- Já vem instalado no NodeJs.
Instalar o Yarn
- Execute o comando no CMD: npm install -g yarn
Instalar o Ngrok
- Execute o comando no Power Shell como Administrador: choco install ngrok
Instalando a API no Windows
Instalar o Git
- Faça o Download no link: https://git-scm.com/download/win
Instalar o NodeJs
- Faça o Download no link: https://nodejs.org/en/download
Instalar o MongoDb
- Faça o Download no link: https://www.mongodb.com/try/download/community
Instalar o NPM
- Já vem instalado no NodeJs.
Instalar o Yarn
- Execute o comando no CMD: npm install -g yarn
Instalar o Ngrok
- Execute o comando no Power Shell como Administrador: choco install ngrok
Instalando a API no Windows com NPM/Yarn
[DEPRECIADO]- Baixar o repositório com o comando git clone https://github.com/code-chat-br/whatsapp-api
- Baixar o repositório pelo link https://github.com/code-chat-br/whatsapp-api/archive/refs/tags/v1.2.8.zip
- Extrair o arquivo, abrir um CMD e ir até a pasta do projeto
- Instalar o código fonte com o comando: yarn install
- Realizar uma cópia do arquivo dev-env.yml para env.yml dentro da pasta SRC
- Alterar as configurações do env.yml, salvar e fechar o arquivo
- Rodar a API com o comando: yarn start
Extra: Rodar o ngrok para externalizar a API diretamente da sua máquina
- Abra o PowerShell e execute o comando: ngrok http http://localhost:porta
Instalando a API com o Docker no Windows
- Instalar o Docker
Faça o Download no link: https://docs.docker.com/desktop/install/windows-in...
[DEPRECIADO]- Baixar o repositório com o comando git clone https://github.com/code-chat-br/whatsapp-api
Baixar o repositório pelo link https://github.com/code-chat-br/whatsapp-api/archive/refs/tags/v1.2.8.zip
Extrair o arquivo zip
Entrar na pasta do código fonte com o comando: cd whatsapp-api
Instalar o código fonte com o comando: yarn install
Editar o arquivo de configuração chamado docker-compose.yml dentro da pasta da API
Alterar as configurações do docker-compose.yml e remover a linha - ./src/env.yml:/codechat/src/env.yml:ro
Pressionar Ctrl + S - Para salvar
Abrir o Docker Desktop
Rodar a API com o comando: docker-compose up
OBS: usar obrigatóriamente a apikey como t8OOEeISKzpmc3jjcMqBWYSaJsafdefer
[CONFIGURAÇÃO OPCIONAL]
Editar o arquivo de configuração chamado docker-compose.yml dentro da pasta da API
Alterar as configurações do docker-compose.yml e remover as linhas - ./src/env.yml:/codechat/src/env.yml:ro e - DOCKER_ENV=true
Descomentar o bloco de configurações do environment
Retirar aspas do AUTHENTICATION_TYPE e AUTHENTICATION_API_KEY
Alterar o AUTHENTICATION_TYPE para apikey
Fazer outras alterações conforme necessidade
Pressionar Ctrl + S - Para salvar
Rodar a API com o comando: docker-compose up
Instalando a API no Linux com NPM/Yarn
[DEPRECIADO] - Baixar o repositório com o comando: git clone https://github.com/code-chat-br/whatsapp-api
- Baixar o repositório pelo comando: wget https://github.com/code-chat-br/whatsapp-api/archive/refs/tags/v1.2.8.zip
- Instalar o UNZIP com o comando: sudo apt install unzip
- Extrair o arquivo com o comando: sudo unzip v1.2.8.zip
- Entrar na pasta do código fonte com o comando: cd whatsapp-api-1.2.8
- Instalar o código fonte com o comando: yarn install
- Realizar uma cópia do arquivo dev-env.yml para env.yml dentro da pasta SRC com o comando: cp src/dev-env.yml src/env.yml
- Alterar as configurações do env.yml com o comando: sudo nano src/env.yml
- Pressionar Ctrl + S - Para salvar
- Pressionar Ctrl + X - Para sair
- Rodar a API com o comando: yarn start
Rodar a API como um serviço:
pm2 start 'yarn start' --name WhatsAppAPI
pm2 startup systemd
sudo env PATH=$PATH:/usr/local/bin /usr/local/lib/node_modules/pm2/bin/pm2 startup systemd -u ubuntu --hp /home/ubuntu
pm2 save
Listar Serviços PM2:
pm2 list
Pausar o serviço PM2:
pm2 stop (IDSERVIÇO)
Iniciar Novamente o Serviço do PM2:
pm2 start (IDSERVICO)
Extra: Rodar o ngrok para externalizar a API diretamente da sua máquina
- Abra o PowerShell e execute o comando: ngrok http http://localhost:8083
Instalando e Configurando o Postman
- Instalar o Postman
- Fazer o download pelo link: https://www.postman.com/downloads/
- Baixar a collection do Postman da API
[DEPRECIADO] - Fazer o download pelo link: https://github.com/code-chat-br/whatsapp-api/blob/...
- Entre no link: https://joindeveloper.com.br/v1.2.8.postman_collection.json
- Clique com o botão direito em qualquer lugar na página, e clique em SALVAR COMO...
- Salve o arquivo no seu computador e siga os próximos passos.
- Importar a collection no postman
- Clicar em Import
- Selecionar o arquivo postman.json
- Import
- Configurar as variáveis de ambiente da collection
- Configurando a ApiKey
- Configurando a URL e porta da API
- Configurando o nome da instância (em caso de apenas um número conectado)
- Configurando multiplas instâncias (em caso de diversos números conectados)
Como Conectar o Celular na API
- Usar o endpoint Create Instance para criar a instancia
- Usar o endpoint Connect Instance para criar o qrCode
- Fazer a decodificação do base64 para image no site: https://base64.guru/converter/decode/image
- Ler o QrCode no celular desejado
- OBS: é importante ler o qrCode o mais rápido possível, pois, tem um tempo curto de expiração do qrCode vide regras de negócio do WhatsApp .
- Celular conectado!
Como ler mensagens através do webhook
Acessar o site https://webhook.site/
Habilitar o webhook dentro do arquivo env.yml ou docker-compose.yml
Opções de configuração de Webhook
Configurar a URL no arquivo env.yml ou docker-compose.yml para webhook geral
Configurar a URL específica para uma instância (Número conectado a API)
Rodar a API
Enviar uma mensagem para o número cadastrado na API
Como configurar o webhook em meu sistema?
Pesquise por Como Ler Eventos Webhook em ...(linguagem de programação desejada)
Acrescente o código em seu sistema
Crie a inteligência para cada evento
Como Hospedar a API na Azure (12 meses gratuitos) - Ubuntu 22.04
- Abrir conta gratuita na Azure pelo link: https://azure.microsoft.com/pt-br/free
- Criar a máquina virtual com o sistema operacional Ubuntu 22.04
- Alterar configurações necessárias
- Revisar + Criar
- Acessar a Máquina Virtual via SSH pelo PowerShell
- Rodar todos os comandos da aula "Instalando a API no Linux"
- Liberar a porta da API na Rede da máquina virtual
- Acessar os recursos da API via IP + porta Públicos
- API pronta para usar!
IP:
Porta:
APIKEY:
OBS: Caso queira mais de 5000 dólares em cupons da Azure, entre para a comunidade Join Tech!
Aula Atualização v1.3.4
- Baixar código fonte atualizado: git clone https://github.com/code-chat-br/whatsapp-api.git
- Instalação Windows
- Instalação do postgres
- Link para Download: https://www.enterprisedb.com/downloads/postgres-postgresql-downloads
- Instalação do node versão 20
- Link para Download: https://nodejs.org/dist/v20.18.1/node-v20.18.1-x64.msi
- Instalar dependências do projeto
- npm install --force
- Deploy do banco de dados
- npx prisma migrate deploy
- npx prisma generate
- Rodar código fonte
- npm run start
- Instalação Ubuntu (recomendado)
- Instalação do postgres
- sudo apt install postgresql postgresql-contrib
- sudo -i -u postgres
- psql
- ALTER USER postgres PASSWORD 'teste';
- exit
- Instalação do NVM
- curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
- export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
- Instalação do node versão 20
- nvm install 20
- Instalar dependências do projeto
- npm install --force
- Configuração do .env
- cp .env.dev .env
- Deploy do banco de dados
- npx prisma migrate deploy
- npx prisma generate
- Rodar código fonte
- npm run start
- Link do postman: https://www.postman.com/codechat/codechat-api/collection/di65273/v1-3-4
Migração das instâncias para nova versão
- Local das informações na versão 1.2.8
- Armazenamento em arquivos
- pastadocodigofonte/store/auth/apikey
- Armazenamento no mongodb
- tabela Auth
COMUNIDADE JOIN TECH
O que terá na comunidade?
- Network de valor (DEVs e donos de negócios que solucionam dores reais no dia a dia)
- Cupons exclusivos. (AWS, Bubble, Notion, Azure e muito mais...)
- Acompanhamento exclusivo comigo em um grupo fechado para os membros no WhatsApp.
- Cursos específicos de ferramentas que ajudarão o seu negócio. (inclusive, com IA)
Link para compra: https://pay.hotmart.com/R96949570B?checkoutMode=10&bid=1733793221255&offDiscount=ALUNOSJOIN
CUPOM de 57% de desconto: ALUNOSJOIN
Até dia 10 de janeiro o cupom ficará válido.
O lançamento do primeiro curso será a partir do dia 15 de janeiro. Essa é uma oferta exclusiva para ser um early adopter da nossa comunidade!
Aprenda de forma simples e rápida a maneira mais eficiente de ter a sua própria API de integração com o WhatsApp..
Use o WhatsApp API para estabelecer comunicação com seu sistema e seus clientes através do WhatsApp.
Todas as chamadas são feitas através do protocolo API Rest. Métodos GET, POST.
Integre em seus negócios e ofereça mais valor aos seus clientes.
Você poderá usar essa API para: SESSÕES DO USUÁRIO*- Iniciar Sessã*
- Obter QrCode em base*4
- Status da Ses*ão
- Restaurar todas as Ses*ões
- Deletar S*ssão
- Sair da Sessao
M*NSAGENS
- Enviar Mensagem*de Texto
- Enviar Mensagem *om Imagem
- Enviar Mensage* com Video
- Enviar Mensag*m com Audio
- Enviar Mensag*m Documentos
- Enviar Mensagem com ar*uivos via url
- *nviar Contatos
- En*iar Localização
- Enviar Reaç*o a Uma Mensagem
-*Receber mensagens
- Deletar Mensagem Para T*dos
OUTROS RECURSOS
- Verificar se um núm*ro existe no WhatsApp
* Obter foto do usuário
- Obter status da mensagem (Lido, Ent*egue, Não Entregue*ETC)
- Arquivar c*nversa
- Atualizar a foto
- Busc*r todas as C*nversas
GRUPOS
- Criar *rupo
- Atualizar foto*do Grupo
- Informações do gru*o
- Obter Participante* do Grupo
- Criar link d* convite
- Revogar link de convite
- Atualizar participante (Adicionar, R*mover, Tornar Admin, Remover Admin)
- Sair do Grupo
A junção de todas as aulas juntas duram menos de 1 hora, e em menos de 1 dia você já conseguira usar a API para fazer testes e conhecer melhor como ela funciona!