feat(twilio): new Twilio SMS/voice alerting integration

Twilio REST API, 5 commands: send SMS, make voice call (TwiML), get/list messages. HTTP Basic auth, stdlib-only. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-12 00:57:23 +02:00
parent fe7dae8bd3
commit d06ea406d3
6 changed files with 387 additions and 0 deletions
@@ -0,0 +1,73 @@
+id: twilio
+name: Twilio
+version: 1.0.0
+description: "Twilio (REST API) — SOC out-of-band alerting: send SMS messages, place voice calls, and read message status/history. HTTP Basic authentication; stdlib-only, no extra Python dependencies."
+changelog: "1.0.0 — Initial release: send SMS, make call, get/list messages."
+category: notification
+
+# Per-instance configuration. HTTP Basic auth with the Account SID + Auth Token.
+config_schema:
+  properties:
+    account_sid:
+      type: string
+      description: "Twilio Account SID"
+    auth_token:
+      type: string
+      description: "Twilio Auth Token"
+      x-soar-sensitive: true
+    from_number:
+      type: string
+      description: "Default sender number (E.164, e.g. +15551234567)"
+  required:
+    - account_sid
+    - auth_token
+
+commands:
+  - id: send_sms
+    name: twilio-send-sms
+    description: "Send an SMS message."
+    inputs_schema:
+      properties:
+        to: { type: string, description: "Recipient number (E.164)" }
+        body: { type: string, description: "Message text" }
+        from_number: { type: string, description: "Sender number (overrides the configured default)" }
+      required: [to, body]
+    outputs_schema: { properties: {} }
+  - id: make_call
+    name: twilio-make-call
+    description: "Place a voice call that plays TwiML."
+    inputs_schema:
+      properties:
+        to: { type: string, description: "Recipient number (E.164)" }
+        from_number: { type: string, description: "Caller number (overrides the configured default)" }
+        twiml: { type: string, description: "TwiML to execute (provide this or url)" }
+        url: { type: string, description: "URL returning TwiML (provide this or twiml)" }
+      required: [to]
+    outputs_schema: { properties: {} }
+  - id: get_message
+    name: twilio-get-message
+    description: "Get a message's status and details by SID."
+    risk: read
+    inputs_schema:
+      properties:
+        message_sid: { type: string, description: "Message SID" }
+      required: [message_sid]
+    outputs_schema: { properties: {} }
+  - id: list_messages
+    name: twilio-list-messages
+    description: "List recent messages."
+    risk: read
+    inputs_schema:
+      properties:
+        page_size: { type: number, description: "Max messages (default 20)" }
+      required: []
+    outputs_schema: { properties: {} }
+
+  - id: test_connection
+    name: twilio-test-connection
+    description: "Verify connectivity and credentials (used by the Test button)."
+    risk: read
+    inputs_schema:
+      properties: {}
+      required: []
+    outputs_schema: { properties: {} }