Matrixly Matrixly Run locally

TWIL · SMS & Voice · Houston SMBs

ConnectForge

The first Twilio-powered agent on Matrixly. Send and receive SMS, keep conversation threads, place simple test calls, and keep humans in control with Test Mode + outbound approval — built for Houston home services, HVAC, contractors, real estate, and local retail.

Twilio FastAPI HITL Port 8802

Instant lead response

Text back HVAC and home-service leads in Katy / Energy Corridor within seconds — bilingual when needed.

Appointments

Confirmation and reminder SMS your customers actually read (HITL before anything leaves if you want).

Missed-call recovery

Turn a missed ring into a text thread — “Sorry we missed you — how can we help?”

Tools it connects to

  • Twilio — SMS, Conversations, basic Voice
  • Grok (xAI) — optional inbound reply intelligence (rules fallback)
  • Google Calendar — planned (appointment sync)

Deploy on this machine (port 8802)

Code: agents/connect-forge · Guide: agents/connect-forge/README.md

cd agents/connect-forge
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
copy .env.example .env
# Set TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, TWILIO_PHONE_NUMBER
# Set TWILIO_VERIFIED_NUMBERS=+1yourVerifiedMobile
python scripts/smoke_test.py
python -m src.cli serve

Dashboard: http://localhost:8802/

Test panel actions

  • Send test SMS — outbound to a verified number
  • Start conversation — Conversations API + first message
  • View recent messages — SIDs, status, direction
  • HITL toggle — approve outbound before send
  • Status — Mock / Trial / Live indicators
Trial tip: Twilio trial accounts can only message verified numbers. Keep CONNECTFORGE_TEST_MODE=true until you upgrade. Never commit Auth Tokens.

Inbound webhook

https://YOUR_PUBLIC_HOST/v1/webhooks/sms

Point your Twilio number’s Messaging webhook (HTTP POST) here. Use ngrok for local tests. Set PUBLIC_BASE_URL in .env.