feat: add Twilio and Telfon communications integration #54

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

marcusquinn merged 1 commit into main from feature/twilio-telefon-integration

Jan 11, 2026

+2,123 −1

.agent/AGENTS.md

-Original file line number
+Diff line change
@@ Expand Up @@
     | `tools/wordpress/` | WordPress ecosystem - local dev, fleet management, plugin curation, custom fields | wp-dev, wp-admin, localwp, mainwp, wp-preferred, scf |
     | `services/hosting/` | Hosting providers - DNS, domains, cloud servers, managed WordPress | hostinger, hetzner, cloudflare, cloudron, closte, 101domains, spaceship |
     | `services/email/` | Email services - transactional email, deliverability | ses |
+    | `services/communications/` | Communications platform - SMS, voice, WhatsApp, verify, recordings | twilio, telfon |
     | `services/accounting/` | Accounting integration - invoicing, expenses, financial reports | quickfile |
     | `workflows/` | Development processes - branching, releases, PR reviews, quality gates | git-workflow, plans, release, version-bump, pr, preflight, postflight, ralph-loop, session-review |
     | `templates/` | Document templates - PRDs, task lists, planning documents | prd-template, tasks-template, plans-template, todo-template |
@@ Expand Down @@

.agent/aidevops/api-integrations.md

-Original file line number
+Diff line change
@@ Expand Up @@
     - **Helper Script**: `.agent/scripts/ses-helper.sh`
     - **Key Features**: Email sending, bounce tracking, reputation monitoring
+    ### **Twilio API**
+    - **Purpose**: SMS, voice calls, WhatsApp, phone verification, call recording
+    - **Authentication**: Account SID + Auth Token
+    - **Configuration**: `configs/twilio-config.json`
+    - **Helper Script**: `.agent/scripts/twilio-helper.sh`
+    - **Key Features**: SMS/MMS, voice calls, WhatsApp Business, Verify (2FA), Lookup, recordings, transcriptions
+    - **AUP Compliance**: Must follow Twilio Acceptable Use Policy
+    - **Recommended Client**: Telfon app for end-user interface (https://mytelfon.com/)
     ### **MainWP API**
     - **Purpose**: WordPress site management, updates, monitoring
@@ Expand Down @@

.agent/aidevops/services.md

-Original file line number
+Diff line change
@@ Expand Up / @@ -210,7 +210,30 @@ tools: @@
     - **Use Cases**: Transactional emails, marketing emails, email monitoring
     - **Helper**: `ses-helper.sh`
     - **Config**: `ses-config.json`
-    - **Docs**: `.agent/ses.md`
+    - **Docs**: `.agent/services/email/ses.md`
+    ## Communications Services (2 Services)
+    ### Twilio
+    - **Type**: Cloud communications platform (CPaaS)
+    - **Strengths**: Global coverage, comprehensive APIs, multi-channel (SMS, Voice, WhatsApp)
+    - **API**: REST API for messaging, voice, verify, lookup
+    - **Use Cases**: SMS notifications, voice calls, 2FA/OTP, WhatsApp Business, call recording
+    - **Helper**: `twilio-helper.sh`
+    - **Config**: `twilio-config.json`
+    - **Docs**: `.agent/services/communications/twilio.md`
+    - **AUP**: Must comply with Twilio Acceptable Use Policy
+    ### Telfon
+    - **Type**: Twilio-powered cloud phone system with mobile/desktop apps
+    - **Strengths**: User-friendly interface, mobile apps, WhatsApp integration, call recording
+    - **Website**: https://mytelfon.com/
+    - **Use Cases**: Sales teams, customer support, remote teams needing softphone
+    - **Apps**: iOS, Android, Chrome Extension, Edge Add-on
+    - **Docs**: `.agent/services/communications/telfon.md`
+    - **Note**: Recommended for end users who need a calling/SMS interface
     ## Domain & DNS (5 Services)
@@ Expand Down @@

Provide feedback