@pipedream/twilio 0.3.11 → 0.5.0

package/README.md

@@ -1,14 +1,11 @@
 # Overview
 
-With the Twilio API, you can build telephone applications that make and receive
-phone calls, as well astext messaging applications that send and receive text
-messages.
-
-Some examples of applications you could build include:
-
-- A phone call application that allows you to make and receive phone calls over
-  the internet
-- A text messaging application that allows you to send and receive text
-  messages over the internet
-- A voicemail application that allows you to leave and receive voicemails over
-  the internet
+Twilio's API on Pipedream opens up a multitude of communication capabilities, allowing you to build robust, scalable, and automated workflows. With Twilio, you can send and receive SMS and MMS messages, make voice calls, and perform other communication functions programmatically. Leveraging Pipedream's seamless integration, you can connect these communications features with hundreds of other services to automate notifications, streamline customer interactions, and enhance operational efficiency.
+
+# Example Use Cases
+
+- **SMS Alert System for eCommerce Order Updates**: Connect Twilio with Shopify to send SMS updates to customers when their order status changes. Apply conditions to trigger messages for order confirmation, shipment tracking, and delivery notifications, adding a personal touch to the online shopping experience.
+
+- **Automated Customer Support Ticketing**: Use Twilio with Zendesk to create a support ticket when a customer sends a text message to your Twilio number. This workflow automates the ticket generation process, ensuring that customer issues are promptly recorded and queued for support staff attention without manual entry.
+
+- **Two-Factor Authentication (2FA) for App Security**: Integrate Twilio with your custom app's authentication system to send a one-time passcode via SMS for 2FA. Enhance security by incorporating an extra verification step, making it tougher for unauthorized users to gain access to sensitive information or accounts.

package/actions/check-verification-token/check-verification-token.mjs

@@ -1,11 +1,12 @@
 import app from "../../twilio.app.mjs";
+import { ConfigurationError } from "@pipedream/platform";
 
 export default {
   key: "twilio-check-verification-token",
   name: "Check Verification Token",
-  description: "Check if user-provided token is correct. [See the documentation](https://www.twilio.com/docs/verify/api) for more information",
+  description: "Check if user-provided token is correct. [See the documentation](https://www.twilio.com/docs/verify/api)",
   type: "action",
-  version: "0.0.1",
+  version: "0.0.2",
   props: {
     app,
     serviceSid: {
@@ -27,12 +28,21 @@ export default {
     },
   },
   async run({ $ }) {
-    const res = await this.app.checkVerificationToken(
-      this.serviceSid,
-      this.to,
-      this.code,
-    );
-    $.export("$summary", `Successfully fetched SMS verification of "${this.to}"`);
-    return res;
+    try {
+      const res = await this.app.checkVerificationToken(
+        this.serviceSid,
+        this.to,
+        this.code,
+      );
+      $.export("$summary", `Verification code is ${res.valid
+        ? ""
+        : "not"} valid`);
+      return res;
+    } catch (e) {
+      if (e.status === 404) {
+        throw new ConfigurationError("Verification ID not found. Twilio deletes the verification SID once it's expired (10 minutes), approved, or the max attempts to check a code have been reached.");
+      }
+      throw new ConfigurationError(JSON.stringify(e));
+    }
   },
 };

package/actions/create-verification-service/create-verification-service.mjs

@@ -0,0 +1,24 @@
+import twilio from "../../twilio.app.mjs";
+
+export default {
+  key: "twilio-create-verification-service",
+  name: "Create Verification Service",
+  description: "Create a verification service for sending SMS verifications. [See the documentation](https://www.twilio.com/docs/verify/api/service#create-a-verification-service)",
+  type: "action",
+  version: "0.0.1",
+  props: {
+    twilio,
+    friendlyName: {
+      type: "string",
+      label: "Friendly Name",
+      description: "The name of the new verification service",
+    },
+  },
+  async run({ $ }) {
+    const response = await this.twilio.createVerificationService({
+      friendlyName: this.friendlyName,
+    });
+    $.export("$summary", `Successfully created verification service with SID: ${response.sid}"`);
+    return response;
+  },
+};

package/actions/delete-call/delete-call.mjs

@@ -3,8 +3,8 @@ import twilio from "../../twilio.app.mjs";
 export default {
   key: "twilio-delete-call",
   name: "Delete Call",
-  description: "Remove a call record from your account. [See the docs](https://www.twilio.com/docs/voice/api/call-resource#delete-a-call-resource) for more information",
-  version: "0.1.2",
+  description: "Remove a call record from your account. [See the documentation](https://www.twilio.com/docs/voice/api/call-resource#delete-a-call-resource)",
+  version: "0.1.3",
   type: "action",
   props: {
     twilio,
@@ -13,6 +13,7 @@ export default {
         twilio,
         "sid",
       ],
+      optional: false,
     },
   },
   async run({ $ }) {

package/actions/delete-message/delete-message.mjs

@@ -3,8 +3,8 @@ import twilio from "../../twilio.app.mjs";
 export default {
   key: "twilio-delete-message",
   name: "Delete Message",
-  description: "Delete a message record from your account. [See the docs](https://www.twilio.com/docs/sms/api/message-resource#delete-a-message-resource) for more information",
-  version: "0.1.2",
+  description: "Delete a message record from your account. [See the documentation](https://www.twilio.com/docs/sms/api/message-resource#delete-a-message-resource)",
+  version: "0.1.3",
   type: "action",
   props: {
     twilio,
@@ -13,6 +13,7 @@ export default {
         twilio,
         "messageId",
       ],
+      optional: false,
     },
   },
   async run({ $ }) {

package/actions/download-recording-media/download-recording-media.mjs

@@ -1,14 +1,14 @@
 import twilio from "../../twilio.app.mjs";
-import got from "got@12.4.1";
 import stream from "stream";
 import { promisify } from "util";
 import fs from "fs";
+import { axios } from "@pipedream/platform";
 
 export default {
   key: "twilio-download-recording-media",
   name: "Download Recording Media",
-  description: "Download a recording media file. [See the docs](https://www.twilio.com/docs/voice/api/recording#fetch-a-recording-media-file) for more information",
-  version: "0.1.3",
+  description: "Download a recording media file. [See the documentation](https://www.twilio.com/docs/voice/api/recording#fetch-a-recording-media-file)",
+  version: "0.1.5",
   type: "action",
   props: {
     twilio,
@@ -27,7 +27,21 @@ export default {
     filePath: {
       type: "string",
       label: "File Path",
-      description: "The destination path in [`/tmp`](https://pipedream.com/docs/workflows/steps/code/nodejs/working-with-files/#the-tmp-directory) for the downloaded the file (e.g., `/tmp/myFile.mp3`)",
+      description: "The destination path in [`/tmp`](https://pipedream.com/docs/workflows/steps/code/nodejs/working-with-files/#the-tmp-directory) for the downloaded the file (e.g., `/tmp/myFile.mp3`). Make sure to include the file extension.",
+    },
+  },
+  methods: {
+    getFileStream({
+      $, downloadUrl,
+    }) {
+      return axios($, {
+        url: downloadUrl,
+        auth: {
+          username: `${this.twilio.$auth.AccountSid}`,
+          password: `${this.twilio.$auth.AuthToken}`,
+        },
+        responseType: "stream",
+      });
     },
   },
   async run({ $ }) {
@@ -39,10 +53,16 @@ export default {
     // Add chosen download format extension (e.g. ".mp3"), as specified in the Twilio API docs:
     // https://www.twilio.com/docs/voice/api/recording#fetch-a-recording-media-file
     const downloadUrl = uri + this.format;
+    const fileStream = await this.getFileStream({
+      $,
+      downloadUrl,
+    });
     const pipeline = promisify(stream.pipeline);
     const resp = await pipeline(
-      got.stream(downloadUrl),
-      fs.createWriteStream(this.filePath),
+      fileStream,
+      fs.createWriteStream(this.filePath.includes("/tmp")
+        ? this.filePath
+        : `/tmp/${this.filePath}`),
     );
     $.export("$summary", `Successfully downloaded the recording media file to "${this.filePath}"`);
     return resp;

package/actions/get-call/get-call.mjs

@@ -4,8 +4,8 @@ import { callToString } from "../../common/utils.mjs";
 export default {
   key: "twilio-get-call",
   name: "Get Call",
-  description: "Return call resource of an individual call. [See the docs](https://www.twilio.com/docs/voice/api/call-resource#fetch-a-call-resource) for more information",
-  version: "0.1.2",
+  description: "Return call resource of an individual call. [See the documentation](https://www.twilio.com/docs/voice/api/call-resource#fetch-a-call-resource)",
+  version: "0.1.3",
   type: "action",
   props: {
     twilio,
@@ -14,6 +14,7 @@ export default {
         twilio,
         "sid",
       ],
+      optional: false,
     },
   },
   async run({ $ }) {

package/actions/get-message/get-message.mjs

@@ -4,8 +4,8 @@ import { messageToString } from "../../common/utils.mjs";
 export default {
   key: "twilio-get-message",
   name: "Get Message",
-  description: "Return details of a message. [See the docs](https://www.twilio.com/docs/sms/api/message-resource#fetch-a-message-resource) for more information",
-  version: "0.1.2",
+  description: "Return details of a message. [See the documentation](https://www.twilio.com/docs/sms/api/message-resource#fetch-a-message-resource)",
+  version: "0.1.3",
   type: "action",
   props: {
     twilio,
@@ -14,6 +14,7 @@ export default {
         twilio,
         "messageId",
       ],
+      optional: false,
     },
   },
   async run({ $ }) {

package/actions/list-calls/list-calls.mjs

@@ -4,8 +4,8 @@ import { omitEmptyStringValues } from "../../common/utils.mjs";
 export default {
   key: "twilio-list-calls",
   name: "List Calls",
-  description: "Return a list of calls associated with your account. [See the docs](https://www.twilio.com/docs/voice/api/call-resource#read-multiple-call-resources) for more information",
-  version: "0.1.2",
+  description: "Return a list of calls associated with your account. [See the documentation](https://www.twilio.com/docs/voice/api/call-resource#read-multiple-call-resources)",
+  version: "0.1.3",
   type: "action",
   props: {
     twilio,

package/actions/list-message-media/list-message-media.mjs

@@ -4,8 +4,8 @@ import { omitEmptyStringValues } from "../../common/utils.mjs";
 export default {
   key: "twilio-list-message-media",
   name: "List Message Media",
-  description: "Return a list of media associated with your message. [See the docs](https://www.twilio.com/docs/sms/api/media-resource#read-multiple-media-resources) for more information",
-  version: "0.1.2",
+  description: "Return a list of media associated with your message. [See the documentation](https://www.twilio.com/docs/sms/api/media-resource#read-multiple-media-resources)",
+  version: "0.1.3",
   type: "action",
   props: {
     twilio,
@@ -14,6 +14,7 @@ export default {
         twilio,
         "messageId",
       ],
+      optional: false,
     },
     limit: {
       propDefinition: [

package/actions/list-messages/list-messages.mjs

@@ -5,8 +5,8 @@ import { omitEmptyStringValues } from "../../common/utils.mjs";
 export default {
   key: "twilio-list-messages",
   name: "List Messages",
-  description: "Return a list of messages associated with your account. [See the docs](https://www.twilio.com/docs/sms/api/message-resource#read-multiple-message-resources) for more information",
-  version: "0.1.3",
+  description: "Return a list of messages associated with your account. [See the documentation](https://www.twilio.com/docs/sms/api/message-resource#read-multiple-message-resources)",
+  version: "0.1.4",
   type: "action",
   props: {
     twilio,

package/actions/list-transcripts/list-transcripts.mjs

@@ -0,0 +1,51 @@
+import twilio from "../../twilio.app.mjs";
+import { omitEmptyStringValues } from "../../common/utils.mjs";
+
+export default {
+  key: "twilio-list-transcripts",
+  name: "List Transcripts",
+  description: "Return a list of transcripts. [See the documentation](https://www.twilio.com/docs/voice/intelligence/api/transcript-resource#fetch-multiple-transcripts)",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    twilio,
+    includeTranscriptText: {
+      propDefinition: [
+        twilio,
+        "includeTranscriptText",
+      ],
+    },
+    limit: {
+      propDefinition: [
+        twilio,
+        "limit",
+      ],
+    },
+  },
+  async run({ $ }) {
+    let results = await this.twilio.listTranscripts(
+      omitEmptyStringValues({
+        limit: this.limit,
+      }),
+    );
+    if (this.includeTranscriptText) {
+      const transcripts = [];
+      for (const result of results) {
+        const {
+          sentences, transcript,
+        } = await this.twilio.getSentences(result.sid);
+        transcripts.push({
+          ...result,
+          _version: undefined,
+          sentences,
+          transcript,
+        });
+      }
+      results = transcripts;
+    }
+    $.export("$summary", `Successfully fetched ${results.length} transcript${results.length === 1
+      ? ""
+      : "s"}`);
+    return results;
+  },
+};

package/actions/make-phone-call/make-phone-call.mjs

@@ -5,8 +5,8 @@ import { callToString } from "../../common/utils.mjs";
 export default {
   key: "twilio-make-phone-call",
   name: "Make a Phone Call",
-  description: "Make a phone call, passing text that Twilio will speak to the recipient of the call. [See the docs](https://www.twilio.com/docs/voice/api/call-resource#create-a-call-resource) for more information",
-  version: "0.1.3",
+  description: "Make a phone call passing text, a URL, or an application that Twilio will use to handle the call. [See the documentation](https://www.twilio.com/docs/voice/api/call-resource#create-a-call-resource)",
+  version: "0.1.4",
   type: "action",
   props: {
     twilio,
@@ -22,11 +22,94 @@ export default {
         "to",
       ],
     },
+    callType: {
+      type: "string",
+      label: "Call Type",
+      description: "Whether to use `text`, a `URL`, or an `application` to handle the call",
+      options: [
+        {
+          label: "Enter text for Twilio to speak when the user picks up the phone",
+          value: "text",
+        },
+        {
+          label: "Enter a URL that returns the TwiML instructions for the call",
+          value: "url",
+        },
+        {
+          label: "Enter the SID of an Application resource that will handle the call",
+          value: "application",
+        },
+      ],
+      reloadProps: true,
+    },
     text: {
       label: "Text",
       type: "string",
       description: "The text you'd like Twilio to speak to the user when they pick up the phone.",
+      hidden: true,
     },
+    url: {
+      type: "string",
+      label: "URL",
+      description: "The absolute URL that returns the TwiML instructions for the call",
+      hidden: true,
+    },
+    applicationSid: {
+      propDefinition: [
+        twilio,
+        "applicationSid",
+      ],
+      hidden: true,
+    },
+    timeout: {
+      type: "integer",
+      label: "Timeout",
+      description: "The integer number of seconds that we should allow the phone to ring before assuming there is no answer. The default is `60` seconds and the maximum is `600` seconds.",
+      optional: true,
+    },
+    record: {
+      type: "boolean",
+      label: "Record",
+      description: "Whether to record the call",
+      optional: true,
+      reloadProps: true,
+    },
+  },
+  async additionalProps(existingProps) {
+    const props = {};
+    existingProps.text.hidden = !(this.callType === "text");
+    existingProps.url.hidden = !(this.callType === "url");
+    existingProps.applicationSid.hidden = !(this.callType === "application");
+    if (this.record) {
+      props.trim = {
+        type: "string",
+        label: "Trim",
+        description: "Whether to trim any leading and trailing silence from the recording",
+        options: [
+          "trim-silence",
+          "do-not-trim",
+        ],
+        optional: true,
+      };
+      props.recordingTrack = {
+        type: "string",
+        label: "Recording Track",
+        description: "The audio track to record for the call. Default is `both`.",
+        options: [
+          "inbound",
+          "outbound",
+          "both",
+        ],
+        optional: true,
+      };
+      props.recordingCallbackUrl = {
+        type: "string",
+        label: "Recording Callback URL",
+        description: "The URL that we call when the recording is available to be accessed",
+        optional: true,
+      };
+    }
+    return props;
   },
   async run({ $ }) {
     // Parse the given number into its E.164 equivalent
@@ -47,7 +130,14 @@ export default {
     const data = {
       to: toParsed.phoneNumber,
       from: fromParsed.phoneNumber,
-      twiml: `<Response><Say>${this.text}</Say></Response>`,
+      twiml: this.text && `<Response><Say>${this.text}</Say></Response>`,
+      url: this.url,
+      applicationSid: this.applicationSid,
+      timeout: this.timeout,
+      record: this.record,
+      trim: this.trim,
+      recordingTrack: this.recordingTrack,
+      recordingStatusCallback: this.recordingCallbackUrl,
     };
 
     const resp = await this.twilio.getClient().calls.create(data);

package/actions/phone-number-lookup/phone-number-lookup.mjs

@@ -0,0 +1,41 @@
+import app from "../../twilio.app.mjs";
+
+export default {
+  key: "twilio-phone-number-lookup",
+  name: "Phone Number Lookup",
+  description: "Lookup information about a phone number. [See the documentation](https://www.twilio.com/docs/lookup/v2-api/line-type-intelligence) for more information",
+  type: "action",
+  version: "0.0.1",
+  props: {
+    app,
+    sid: {
+      type: "string",
+      label: "Phone Number",
+      description: "The phone number to lookup",
+    },
+  },
+  methods: {
+    lineTypeLookup(sid) {
+      const client = this.app.getClient();
+      return client.lookups.v2.phoneNumbers(sid).fetch({
+        fields: "line_type_intelligence",
+      });
+    },
+  },
+  async run({ $ }) {
+    const {
+      lineTypeLookup,
+      sid,
+    } = this;
+
+    const response = await lineTypeLookup(sid);
+
+    if (response.validationErrors?.length) {
+      $.export("$summary", `Failed to fetch phone number lookup: \`${JSON.stringify(response.validationErrors, null, 2)}\`.`);
+    } else {
+      $.export("$summary", `Successfully fetched phone number lookup of \`${sid}\``);
+    }
+
+    return response;
+  },
+};

package/actions/{send-mms/send-mms.mjs → send-message/send-message.mjs}

@@ -3,11 +3,11 @@ import twilio from "../../twilio.app.mjs";
 import { messageToString } from "../../common/utils.mjs";
 
 export default {
-  key: "twilio-send-mms",
-  name: "Send MMS",
-  description: "Send an SMS with text and media files. [See the docs](https://www.twilio.com/docs/sms/api/message-resource#create-a-message-resource) for more information",
+  key: "twilio-send-message",
+  name: "Send Message",
+  description: "Send an SMS text with optional media files. [See the documentation](https://www.twilio.com/docs/sms/api/message-resource#create-a-message-resource)",
   type: "action",
-  version: "0.1.3",
+  version: "0.0.1",
   props: {
     twilio,
     from: {
@@ -58,7 +58,7 @@ export default {
     };
 
     const resp = await this.twilio.getClient().messages.create(data);
-    $.export("$summary", `Successfully sent a new MMS, "${messageToString(resp)}"`);
+    $.export("$summary", `Successfully sent a new message, "${messageToString(resp)}"`);
     return resp;
   },
 };

package/actions/send-sms-verification/send-sms-verification.mjs

@@ -3,9 +3,9 @@ import app from "../../twilio.app.mjs";
 export default {
   key: "twilio-send-sms-verification",
   name: "Send SMS Verification",
-  description: "Send an SMS verification to a phone number. [See the documentation](https://www.twilio.com/docs/verify/api) for more information",
+  description: "Send an SMS verification to a phone number. [See the documentation](https://www.twilio.com/docs/verify/api)",
   type: "action",
-  version: "0.0.1",
+  version: "0.0.2",
   props: {
     app,
     serviceSid: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/twilio",
-  "version": "0.3.11",
+  "version": "0.5.0",
   "description": "Pipedream Twilio Components",
   "main": "twilio.app.mjs",
   "keywords": [
@@ -10,8 +10,10 @@
   "homepage": "https://pipedream.com/apps/twilio",
   "author": "Pipedream <support@pipedream.com> (https://pipedream.com/)",
   "dependencies": {
-    "@pipedream/platform": "^1.2.0",
-    "phone": "^3.1.29",
+    "@pipedream/platform": "^3.0.0",
+    "got": "^13.0.0",
+    "phone": "^3.1.49",
+    "stream": "^0.0.3",
     "twilio": "^3.54.2"
   },
   "gitHead": "e12480b94cc03bed4808ebc6b13e7fdb3a1ba535",

package/sources/{common-polling.mjs → common/common-polling.mjs}

@@ -1,4 +1,4 @@
-import twilio from "../twilio.app.mjs";
+import twilio from "../../twilio.app.mjs";
 import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";
 
 export default {
@@ -23,23 +23,28 @@ export default {
     },
     emitEvent(result) {
       const meta = this.generateMeta(result);
+      delete result._version;
       this.$emit(result, meta);
     },
   },
   async run() {
-    let dateCreatedAfter = this._getCreatedAfter();
-    const params = {
+    const dateCreatedAfter = this._getCreatedAfter();
+    let newDateCreatedAfter = dateCreatedAfter;
+
+    const results = await this.listResults({
       dateCreatedAfter,
-    };
-    const results = await this.listResults(params);
+    });
+
     for (const result of results) {
-      this.emitEvent(result);
-      if (
-        !dateCreatedAfter ||
-        Date.parse(result.dateCreated) > Date.parse(dateCreatedAfter)
-      )
-        dateCreatedAfter = result.dateCreated;
+      const dateCreated = result.dateCreated;
+      const ts = Date.parse(dateCreated);
+      if ( !dateCreatedAfter || ts > Date.parse(dateCreatedAfter) ) {
+        this.emitEvent(result);
+        if (!dateCreatedAfter || ts > Date.parse(newDateCreatedAfter)) {
+          newDateCreatedAfter = dateCreated;
+        }
+      }
     }
-    this._setCreatedAfter(dateCreatedAfter);
+    this._setCreatedAfter(newDateCreatedAfter);
   },
 };

package/sources/{common-webhook.mjs → common/common-webhook.mjs}

@@ -1,4 +1,4 @@
-import twilio from "../twilio.app.mjs";
+import twilio from "../../twilio.app.mjs";
 
 export default {
   props: {
@@ -9,12 +9,6 @@ export default {
         "incomingPhoneNumber",
       ],
     },
-    authToken: {
-      propDefinition: [
-        twilio,
-        "authToken",
-      ],
-    },
     http: {
       label: "HTTP Responder",
       description: "Exposes a `respond()` method that lets the source issue HTTP responses",
@@ -93,7 +87,6 @@ export default {
       signature,
       url: `${this.http.endpoint}/`,
       params: body,
-      authToken: this.authToken,
     });
 
     if (!isRequestValid) {

package/sources/new-call/new-call.mjs

@@ -1,4 +1,4 @@
-import common from "../common-webhook.mjs";
+import common from "../common/common-webhook.mjs";
 import constants from "../../common/constants.mjs";
 
 export default {
@@ -6,7 +6,7 @@ export default {
   key: "twilio-new-call",
   name: "New Call (Instant)",
   description: "Emit new event each time a call to the phone number is completed. Configures a webhook in Twilio, tied to a phone number.",
-  version: "0.1.3",
+  version: "0.1.4",
   type: "source",
   dedupe: "unique",
   methods: {

package/sources/new-incoming-sms/new-incoming-sms.mjs

@@ -1,5 +1,5 @@
 import twilio from "twilio";
-import common from "../common-webhook.mjs";
+import common from "../common/common-webhook.mjs";
 import constants from "../../common/constants.mjs";
 
 const MessagingResponse = twilio.twiml.MessagingResponse;
@@ -9,7 +9,7 @@ export default {
   key: "twilio-new-incoming-sms",
   name: "New Incoming SMS (Instant)",
   description: "Emit new event every time an SMS is sent to the phone number set. Configures a webhook in Twilio, tied to an incoming phone number.",
-  version: "0.1.3",
+  version: "0.1.4",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/new-phone-number/new-phone-number.mjs

@@ -1,11 +1,11 @@
-import common from "../common-polling.mjs";
+import common from "../common/common-polling.mjs";
 
 export default {
   ...common,
   key: "twilio-new-phone-number",
   name: "New Phone Number",
   description: "Emit new event when you add a new phone number to your account",
-  version: "0.1.4",
+  version: "0.1.5",
   type: "source",
   dedupe: "unique",
   methods: {

package/sources/new-recording/new-recording.mjs

@@ -1,11 +1,11 @@
-import common from "../common-polling.mjs";
+import common from "../common/common-polling.mjs";
 
 export default {
   ...common,
   key: "twilio-new-recording",
   name: "New Recording",
   description: "Emit new event when a new call recording is created",
-  version: "0.1.4",
+  version: "0.1.5",
   type: "source",
   dedupe: "unique",
   methods: {

package/sources/new-transcript-created/new-transcript-created.mjs

@@ -0,0 +1,52 @@
+import common from "../common/common-polling.mjs";
+
+export default {
+  ...common,
+  key: "twilio-new-transcript-created",
+  name: "New Transcript Created",
+  description: "Emit new event when a new call transcript is created",
+  version: "0.0.1",
+  type: "source",
+  dedupe: "unique",
+  props: {
+    ...common.props,
+    includeTranscriptText: {
+      propDefinition: [
+        common.props.twilio,
+        "includeTranscriptText",
+      ],
+    },
+  },
+  methods: {
+    ...common.methods,
+    async listResults(...args) {
+      const results = await this.twilio.listTranscripts(...args);
+      if (!this.includeTranscriptText) {
+        return results;
+      }
+      const transcripts = [];
+      for (const result of results) {
+        const {
+          sentences, transcript,
+        } = await this.twilio.getSentences(result.sid);
+        transcripts.push({
+          ...result,
+          sentences,
+          transcript,
+        });
+      }
+      return transcripts;
+    },
+    generateMeta(transcript) {
+      const {
+        sid: id,
+        dateCreated,
+      } = transcript;
+      return {
+        id,
+        summary: `New transcript ${id}`,
+        ts: Date.parse(dateCreated),
+      };
+    },
+  },
+};

package/twilio.app.mjs

@@ -10,13 +10,6 @@ export default {
   type: "app",
   app: "twilio",
   propDefinitions: {
-    authToken: {
-      type: "string",
-      secret: true,
-      label: "Twilio Auth Token",
-      description:
-        "Your Twilio auth token, found [in your Twilio console](https://www.twilio.com/console). Required for validating Twilio events.",
-    },
     body: {
       type: "string",
       label: "Message Body",
@@ -72,7 +65,7 @@ export default {
     limit: {
       type: "integer",
       label: "Limit",
-      description: "The maximum number of results to be worked with during one execution cycle.",
+      description: "The maximum number of results to retrieve",
       optional: true,
       default: 50,
     },
@@ -166,10 +159,28 @@ export default {
         }));
       },
     },
+    includeTranscriptText: {
+      type: "boolean",
+      label: "Include Transcript Text?",
+      description: "Set to `true` to include the transcript sentences in the response",
+      optional: true,
+    },
+    applicationSid: {
+      type: "string",
+      label: "Application SID",
+      description: "The SID of the Application resource",
+      async options() {
+        const applications = await this.listApplications();
+        return applications?.map((application) => ({
+          label: application.friendly_name,
+          value: application.sid,
+        })) || [];
+      },
+    },
   },
   methods: {
     validateRequest({
-      signature, url, params, authToken = this.$auth.authToken,
+      signature, url, params, authToken = this.$auth.AuthToken,
     } = {}) {
       // See https://www.twilio.com/docs/usage/webhooks/webhooks-security
       return twilio.validateRequest(
@@ -240,6 +251,32 @@ export default {
       const client = this.getClient();
       return client.transcriptions.list(params);
     },
+    listTranscripts(params) {
+      const client = this.getClient();
+      return client.intelligence.v2.transcripts.list(params);
+    },
+    listTranscriptSentences(transcriptId, params = {}) {
+      const client = this.getClient();
+      return client.intelligence.v2.transcripts(transcriptId).sentences.list(params);
+    },
+    async getSentences(transcriptId) {
+      const sentences = await this.listTranscriptSentences(transcriptId, {
+        limit: 1000,
+      });
+      const transcriptParts = sentences.map((sentence) => `Speaker ${sentence.mediaChannel} (Sentence ${sentence.sentenceIndex}):\n${sentence.transcript}\nConfidence: ${sentence.confidence}\n`);
+      return {
+        sentences,
+        transcript: transcriptParts.join("\n"),
+      };
+    },
+    listApplications(params) {
+      const client = this.getClient();
+      return client.applications.list(params);
+    },
+    createVerificationService(params) {
+      const client = this.getClient();
+      return client.verify.v2.services.create(params);
+    },
     /**
      * Returns a list of messages associated with your account. When getting the
      * list of all messages, results will be sorted on the DateSent field with

package/actions/list-recording-transcriptions/list-recording-transcriptions.mjs

@@ -1,37 +0,0 @@
-import twilio from "../../twilio.app.mjs";
-import { omitEmptyStringValues } from "../../common/utils.mjs";
-
-export default {
-  key: "twilio-list-recording-transcriptions",
-  name: "List Recording Transcriptions",
-  description: "Return a set of transcriptions available for a recording. [See the docs](https://www.twilio.com/docs/voice/api/recording#fetch-a-recordings-transcriptions) for more information",
-  version: "0.1.2",
-  type: "action",
-  props: {
-    twilio,
-    recordingID: {
-      propDefinition: [
-        twilio,
-        "recordingID",
-      ],
-    },
-    limit: {
-      propDefinition: [
-        twilio,
-        "limit",
-      ],
-    },
-  },
-  async run({ $ }) {
-    const resp = await this.twilio.listRecordingTranscriptions(
-      this.recordingID,
-      omitEmptyStringValues({
-        limit: this.limit,
-      }),
-    );
-    $.export("$summary", `Successfully fetched ${resp.length} recording transcription${resp.length === 1
-      ? ""
-      : "s"} for the recording, "${this.recordingID}"`);
-    return resp;
-  },
-};

package/actions/send-sms/send-sms.mjs

@@ -1,57 +0,0 @@
-import { phone } from "phone";
-import twilio from "../../twilio.app.mjs";
-import { messageToString } from "../../common/utils.mjs";
-
-export default {
-  key: "twilio-send-sms",
-  name: "Send SMS",
-  description: "Send a simple text-only SMS. [See the docs](https://www.twilio.com/docs/sms/api/message-resource#create-a-message-resource) for more information",
-  type: "action",
-  version: "0.1.3",
-  props: {
-    twilio,
-    from: {
-      propDefinition: [
-        twilio,
-        "from",
-      ],
-    },
-    to: {
-      propDefinition: [
-        twilio,
-        "to",
-      ],
-    },
-    body: {
-      propDefinition: [
-        twilio,
-        "body",
-      ],
-    },
-  },
-  async run({ $ }) {
-    // Parse the given number into its E.164 equivalent
-    // The E.164 phone number will be included in the first element
-    // of the array, but the array will be empty if parsing fails.
-    // See https://www.npmjs.com/package/phone
-    const toParsed = phone(this.to);
-    if (!toParsed || !toParsed.phoneNumber) {
-      throw new Error(`Phone number ${this.to} could not be parsed as a valid number.`);
-    }
-
-    const fromParsed = phone(this.from);
-    if (!fromParsed || !fromParsed.phoneNumber) {
-      throw new Error(`Phone number ${this.from} could not be parsed as a valid number.`);
-    }
-
-    const data = {
-      to: toParsed.phoneNumber,
-      from: fromParsed.phoneNumber,
-      body: this.body,
-    };
-
-    const resp = await this.twilio.getClient().messages.create(data);
-    $.export("$summary", `Successfully sent a new SMS, "${messageToString(resp)}"`);
-    return resp;
-  },
-};

package/sources/new-transcription/new-transcription.mjs

@@ -1,28 +0,0 @@
-import common from "../common-polling.mjs";
-
-export default {
-  ...common,
-  key: "twilio-new-transcription",
-  name: "New Transcription",
-  description: "Emit new event when a new call transcription is created",
-  version: "0.1.4",
-  type: "source",
-  dedupe: "unique",
-  methods: {
-    ...common.methods,
-    async listResults(...args) {
-      return await this.twilio.listTranscriptions(...args);
-    },
-    generateMeta(transcription) {
-      const {
-        sid: id,
-        dateCreated,
-      } = transcription;
-      return {
-        id,
-        summary: `New transcription ${id}`,
-        ts: Date.parse(dateCreated),
-      };
-    },
-  },
-};