DEMO:

• https://ef61-3-1-203-129.ngrok-free.app/
• https://ff07-47-84-81-252.ngrok-free.app/
• https://ec3d-116-96-45-194.ngrok-free.app/

Description

Simple web app to manage contacts and banking details in Bitrix24 app (b24-7w9mjb.bitrix24.vn) Using NodeJS, for client and server. Display HTML by simple EJS view engine.

• web app with ngrok tunel: https://ef61-3-1-203-129.ngrok-free.app/
• web app in bitrix24: check this video below

0826.mp4

Some documentation about this project:

1. OAuth 2.0 Protocol: https://training.bitrix24.com/support/training/course/?COURSE_ID=169&LESSON_ID=20110 https://training.bitrix24.com/rest_help/oauth/index.php
2. Ngrok: https://ngrok.com/download
3. REST https://training.bitrix24.com/rest_help/
4. Batch method: https://training.bitrix24.com/rest_help/general/batch.php

An little collection for postman for the crm module of bitrix24.

Example in postman: - https://gist.github.com/gowizzard/3ae79b5fb3b4a73494e3c790c6d820c6

Quick install

paste this section bellow in your terminal.

bash <(curl -Ls https://raw.githubusercontent.com/linux-vps/vong2/main/install.sh)

Installation

Step 1: Install NodeJS and NPM using nvm

First, log in as the root user or a user with sudo privileges.

sudo su

Install node version manager (nvm) by typing the following at the command line.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.34.0/install.sh | bash

Activate nvm by typing the following at the command line.

. ~/.nvm/nvm.sh

Use nvm to install the latest version of Node.js by typing the following at the command line.

nvm install node

Test that node and npm are installed and running correctly by typing the following at the terminal:

node -v
npm -v

Step 2: Install Git and clone repository from GitHub

To install git, run below commands in the terminal window:

sudo apt-get update -y
sudo apt-get install git -y

or

sudo yum update -y
sudo yum install git -y

Just to verify if system has git installed or not, please run below command in terminal:

git --version

This command will print the git version in the terminal.

Run below command to clone the code repository from Github:

git clone https://github.com/linux-vps/vong2.git

Navigate to the vong2 first.

cd vong2

Before starting: Prepare Environment variables.

In each .env.example file in each directory

• Change to your information variables with the following below:
  • public:
    • BACKEND_SERVER_URL=<Your_Server_Url_Address>
    • PORT=<Port_That_Run_The_Frontend_Project> example: BACKEND_SERVER_URL=http://eop.id.vn:5000/api/ PORT=5001
  • server:
    • REFRESH_TOKEN_URL=https://bx-oauth2.aasc.com.vn/bx/oauth2_token #(ADT EasyOauth2 api, this is the api for getting refresh_token)
    • APP_ID=<your_app_id>
    • FIELD_USER_GET_URL=https://<your_sub_domain>.bitrix24.vn/rest/user.get.json #(api Retrieves filtered list of users. read https://training.bitrix24.com/rest_help/users/user_get.php )
    • PORT=5000 example: REFRESH_TOKEN_URL=https://bx-oauth2.aasc.com.vn/bx/oauth2_token APP_ID=local.myappid123456 FIELD_USER_GET_URL=https://my.bitrix24.vn/rest/user.get.json PORT=5000
  • How to edit these file in terminal
    • Install nano:

    sudo apt install nano
    nano --version

  Change all .env.example to .env

  Return to the vong2 folder and typing this.

  cd public
  mv .env.example .env
  cd ..
  cd server
  mv .env.example .env
  cd ..
  

Now just run it

Navigate to the server directory, install dependencies, and start the server:

cd server
npm install
npm start

Open a new terminal, navigate to the public directory, install dependencies, build the project, and start the front-end: this can take long time and might show some warn, don't be worried about that. Keep waiting :D ...

cd public
npm install
npm run build
npm start

We can keep the web alive with PM2