Twilio - Get Transcript & update Get Call (#14700)

* get-transcripts & updated get-call

* versions

Author: michelle0927

components/twilio/actions/check-verification-token/check-verification-token.mjs

@@ -6,7 +6,7 @@ export default {
   name: "Check Verification Token",
   description: "Check if user-provided token is correct. [See the documentation](https://www.twilio.com/docs/verify/api)",
   type: "action",
-  version: "0.0.2",
+  version: "0.0.3",
   props: {
     app,
     serviceSid: {

components/twilio/actions/create-verification-service/create-verification-service.mjs

@@ -5,7 +5,7 @@ export default {
   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",
+  version: "0.0.2",
   props: {
     twilio,
     friendlyName: {

components/twilio/actions/delete-call/delete-call.mjs

@@ -4,7 +4,7 @@ export default {
   key: "twilio-delete-call",
   name: "Delete Call",
   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",
+  version: "0.1.4",
   type: "action",
   props: {
     twilio,

components/twilio/actions/delete-message/delete-message.mjs

@@ -4,7 +4,7 @@ export default {
   key: "twilio-delete-message",
   name: "Delete Message",
   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",
+  version: "0.1.4",
   type: "action",
   props: {
     twilio,

components/twilio/actions/download-recording-media/download-recording-media.mjs

@@ -8,7 +8,7 @@ export default {
   key: "twilio-download-recording-media",
   name: "Download Recording Media",
   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",
+  version: "0.1.6",
   type: "action",
   props: {
     twilio,

components/twilio/actions/get-call/get-call.mjs

@@ -5,7 +5,7 @@ export default {
   key: "twilio-get-call",
   name: "Get Call",
   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",
+  version: "0.1.4",
   type: "action",
   props: {
     twilio,
@@ -16,9 +16,60 @@ export default {
       ],
       optional: false,
     },
+    includeTranscripts: {
+      type: "boolean",
+      label: "Include Transcripts",
+      description: "Set to `true` to include recording transcript(s) if available",
+      optional: true,
+    },
+  },
+  methods: {
+    async getTranscripts(callSid) {
+      const transcripts = [];
+      const recordings = await this.twilio.listRecordings({
+        callSid,
+      });
+      for (const recording of recordings) {
+        const recordingTranscripts = await this.getRecordingTranscripts(recording.sid);
+        if (recordingTranscripts?.length) {
+          transcripts.push(...recordingTranscripts);
+        }
+      }
+      return transcripts;
+    },
+    async getRecordingTranscripts(sourceSid) {
+      const transcripts = await this.twilio.listTranscripts({
+        sourceSid,
+      });
+      const results = [];
+      for (const transcript of transcripts) {
+        const {
+          sentences, transcript: fullTranscript,
+        } = await this.twilio.getSentences(transcript.sid);
+        results.push({
+          ...transcript,
+          _version: undefined,
+          sentences,
+          transcript: fullTranscript,
+        });
+      }
+      return results;
+    },
   },
   async run({ $ }) {
-    const resp = await this.twilio.getCall(this.sid);
+    let resp = await this.twilio.getCall(this.sid);
+
+    if (this.includeTranscripts) {
+      const transcripts = await this.getTranscripts(this.sid);
+      if (transcripts?.length) {
+        resp = {
+          ...resp,
+          _version: undefined,
+          transcripts,
+        };
+      }
+    }
+
     $.export("$summary", `Successfully fetched the call, "${callToString(resp)}"`);
     return resp;
   },

components/twilio/actions/get-message/get-message.mjs

@@ -5,7 +5,7 @@ export default {
   key: "twilio-get-message",
   name: "Get Message",
   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",
+  version: "0.1.4",
   type: "action",
   props: {
     twilio,

components/twilio/actions/get-transcripts/get-transcripts.mjs

@@ -0,0 +1,40 @@
+import twilio from "../../twilio.app.mjs";
+
+export default {
+  key: "twilio-get-transcripts",
+  name: "Get Transcripts",
+  description: "Retrieves full transcripts for the specified transcript SIDs. [See the documentation](https://www.twilio.com/docs/voice/intelligence/api/transcript-sentence-resource#get-transcript-sentences)",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    twilio,
+    transcriptSids: {
+      propDefinition: [
+        twilio,
+        "transcriptSids",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const transcripts = [];
+    for (const sid of this.transcriptSids) {
+      transcripts.push(await this.twilio.getTranscript(sid));
+    }
+    const results = [];
+    for (const transcript of transcripts) {
+      const {
+        sentences, transcript: fullTranscript,
+      } = await this.twilio.getSentences(transcript.sid);
+      results.push({
+        ...transcript,
+        _version: undefined,
+        sentences,
+        transcript: fullTranscript,
+      });
+    }
+    $.export("$summary", `Successfully fetched ${results.length} transcript${results.length === 1
+      ? ""
+      : "s"}`);
+    return results;
+  },
+};

components/twilio/actions/list-calls/list-calls.mjs

@@ -5,7 +5,7 @@ export default {
   key: "twilio-list-calls",
   name: "List Calls",
   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",
+  version: "0.1.4",
   type: "action",
   props: {
     twilio,

components/twilio/actions/list-message-media/list-message-media.mjs

@@ -5,7 +5,7 @@ export default {
   key: "twilio-list-message-media",
   name: "List Message Media",
   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",
+  version: "0.1.4",
   type: "action",
   props: {
     twilio,