Zignal

A bridge service for Edge Support to bridge messages in Signal to Zendesk.

It has two main scripts:

• main.py — takes Signal messages and puts them in Zendesk
• webhook.py — takes Zendesk replies and sends back through Signal

---

Setup

Install the necessary environment dependencies:

1. Install Python3
2. Install pip

For Ubuntu, installation script is the following:

sudo apt update
sudo apt install python3
sudo apt install python3-pip
sudo apt install python3.12-venv

Install the package dependencies:

python3 -m venv venv
source venv/bin/activate
python -m pip install -r requirements.txt

Copy the .env.sample to .env and edit .env with the appropriate the ENV configuration.

cp .env.sample .env

Run the signal-cli service

Run the signal-cli docker container:

1. Build and start the container:

docker-compose up -d

2. Register your phone number (replace +1234567890 with your number):

docker exec -it signal-cli signal-cli -a +1234567890 register

3. Verify your number with the code received via SMS:

docker exec -it signal-cli signal-cli -a +1234567890 verify CODE

4. The Signal CLI daemon will be running and accessible at http://localhost:8090

Run the Zignal service

source venv/bin/activate
python3 main.py