Simple bridge to allow the use of a twilio phone number to be used for messaging using any XMPP client, such as Conversations.

The service is set up so you can have 1 phone number per each xmpp account.

To set up your phone number. You will need to get from Twilio:

• Account SID
• Phone Number

You will also need to authenticate to twilio, with either:

• API Key SID and API Key Secret

OR

• Auth token

Then message the admin bot ( COMPONENT_DOMAIN ) from your xmpp account with message 'help' to see command, or 'register' and follow the steps. Message 'cancel' or 'help' at any time to return to the help section.

This should be set up automatically by the bot or iq registration, if your API_HOST variable is set up correctly. If not, this can be changed manually:

1. Go to https://console.twilio.com
2. Go to Develop > Phone Numbers > Manage > Active Numbers
3. Click on the phone number you want to add
4. Go to the Configure tab
5. Scroll down to 'Messaging' and change 'A message Comes in' to the url you are hosting the web app on. For example: https://twilio.sgx.domain.tld/sms

Required:

• nodejs >= 14
• redis server
• xmpp server that supports components ( eg: prosody )

Installation:

1. Clone the Repo

git clone https://github.com/pesvut/sgx-twilio

2. Install the nodejs packages

cd ./sgx-twilio && npm install

3. Run the server with environmental variables

XMPP_ADMIN= COMPONENT_HOST= COMPONENT_DOMAIN= COMPONENT_SECRET= REDIS_URL= PORT= API_HOST= node server.js

An all-in one docker-compose file for running redis, xmpp and sgx-twilio behind an instance of nginx or apache. Note that E2E_POLICY_CHAT is set to none because the server needs to be able to read the messages to bridge them.

version: '3.7'
services:
  prosody:
    image: sarasmiseth/prosody:latest
    restart: unless-stopped
    ports:
      - "5000:5000"
      - "5222:5222"
      - "5223:5223"
      - "5347:5347"
      - "5269:5269"
      - "5280:5280"
      - "5281:5281"
    environment:
      DOMAIN: domain.tld
      COMPONENT_SECRET:
      E2E_POLICY_CHAT: none
      LOG_LEVEL: info
    volumes:
      - ./certs:/usr/local/etc/prosody/certs
      - ./data:/usr/local/var/lib/prosody
      - ./config:/usr/local/etc/prosody
    networks:
      - xmpp
 
  sgx-twilio:
    build: https://github.com/pesvut/sgx-twilio.git
    image: sgx-twilio
    restart: unless-stopped
    ports:
      - "5069:80"
    environment:
      COMPONENT_HOST: "xmpp://prosody:5347"
      COMPONENT_DOMAIN: twilio.sgx.domain.tld
      COMPONENT_SECRET: 
      REDIS_URL: "redis://redis-twilio"
      XMPP_ADMIN: admin@domain.tld
      API_HOST: "https://twilio.webhooks.domain.tld"
    networks:
      - xmpp
  redis-twilio:
    image: redis:latest
    restart: always
    networks:
      - xmpp
    volumes:
      - ./redis:/data
networks:
  xmpp:
    name: xmpp

You will need to also do the following:

• add cert folders to /certs for each of the following domains ( see https://github.com/SaraSmiseth/prosody for more information on setting up your xmpp )
  • conference.domain.tld
  • domain.tld
  • media.domain.tld
  • proxy.domain.tld
• add a configuration file for the new component, config/conf.d/06-components.cfg.lua:

local comp_secret = os.getenv("COMPONENT_SECRET")
Component "twilio.sgx.domain.tld"
    component_secret = comp_secret