@divyacon/piece-twilio 0.0.0-stage → 0.1.0

package/src/lib/trigger/new-call.ts

@@ -0,0 +1,156 @@
+import { createTrigger, TriggerStrategy, PiecePropValueSchema, AppConnectionValueForAuthProperty } from '@agnocon/pieces-framework';
+import { twilioAuth } from '../..';
+import { AuthenticationType, DedupeStrategy, httpClient, HttpMethod, Polling, pollingHelper } from '@agnocon/pieces-common';
+
+interface Call {
+    sid: string;
+    status: string;
+    direction: string;
+    from: string;
+    to: string;
+    start_time: string;
+    end_time: string;
+    duration: string;
+    price: string;
+    price_unit: string;
+    date_created:string
+}
+
+interface CallsResponse {
+    calls: Call[];
+          next_page_uri:string
+
+}
+
+
+const polling: Polling<
+  AppConnectionValueForAuthProperty<typeof twilioAuth>,
+  Record<string, unknown>
+> = {
+  strategy: DedupeStrategy.TIMEBASED,
+  async items({ auth, lastFetchEpochMS }) {
+    const isTest = lastFetchEpochMS === 0;
+    const account_sid = auth.username;
+    const auth_token = auth.password;
+
+    let currentUri:
+      | string
+      | null = `/2010-04-01/Accounts/${account_sid}/Calls.json?PageSize=${
+      isTest ? 1 : 1000
+    }`;
+
+    const results = [];
+    let stop = false;
+
+    do {
+      const response: any = await httpClient.sendRequest({
+        method: HttpMethod.GET,
+        url: `https://api.twilio.com${currentUri}`,
+        authentication: {
+          type: AuthenticationType.BASIC,
+          username: account_sid,
+          password: auth_token,
+        },
+      });
+
+      const payload = response.body as CallsResponse;
+
+      const calls = payload.calls ?? [];
+
+      for (const call of calls) {
+        const ts = new Date(call.date_created).getTime();
+
+        if(call.status !== 'completed') continue;
+
+        if (isTest || ts > lastFetchEpochMS) {
+          results.push(call);
+        } else {
+          stop = true;
+          break;
+        }
+      }
+
+      if (isTest) break;
+      currentUri = payload?.next_page_uri ?? null;
+    } while (currentUri && !stop);
+
+    return results.map((call) => {
+      return {
+        epochMilliSeconds: new Date(call.date_created).getTime(),
+        data: call,
+      };
+    });
+  },
+};
+
+export const twilioNewCall = createTrigger({
+    auth: twilioAuth,
+    name: 'new_call',
+    displayName: 'New Call',
+    description: 'Triggers when a call completes (incoming or outgoing).',
+    aiMetadata: {
+      description: 'Fires when a voice call reaches completed status on the Twilio account, for both inbound and outbound calls. Each event represents one finished call with its direction, participants, duration, and status.',
+    },
+    props: {},
+    sampleData:{
+      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "answered_by": "machine_start",
+      "api_version": "2010-04-01",
+      "caller_name": "callerid1",
+      "date_created": "Fri, 18 Oct 2019 17:00:00 +0000",
+      "date_updated": "Fri, 18 Oct 2019 17:01:00 +0000",
+      "direction": "outbound-api",
+      "duration": "4",
+      "end_time": "Fri, 18 Oct 2019 17:03:00 +0000",
+      "forwarded_from": "calledvia1",
+      "from": "+13051416799",
+      "from_formatted": "(305) 141-6799",
+      "group_sid": "GPdeadbeefdeadbeefdeadbeefdeadbeef",
+      "parent_call_sid": "CAdeadbeefdeadbeefdeadbeefdeadbeef",
+      "phone_number_sid": "PNdeadbeefdeadbeefdeadbeefdeadbeef",
+      "price": "-0.200",
+      "price_unit": "USD",
+      "sid": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "start_time": "Fri, 18 Oct 2019 17:02:00 +0000",
+      "status": "completed",
+      "subresource_uris": {
+        "notifications": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Notifications.json",
+        "recordings": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Recordings.json",
+        "payments": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Payments.json",
+        "events": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Events.json",
+        "siprec": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Siprec.json",
+        "streams": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Streams.json",
+        "transcriptions": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Transcriptions.json",
+        "user_defined_message_subscriptions": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/UserDefinedMessageSubscriptions.json",
+        "user_defined_messages": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/UserDefinedMessages.json"
+      },
+      "to": "+13051913581",
+      "to_formatted": "(305) 191-3581",
+      "trunk_sid": "TKdeadbeefdeadbeefdeadbeefdeadbeef",
+      "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json",
+      "queue_time": "1000"
+    },
+    type: TriggerStrategy.POLLING,
+
+
+  async onEnable(context) {
+    await pollingHelper.onEnable(polling, {
+      auth: context.auth,
+      store: context.store,
+      propsValue: context.propsValue,
+    });
+  },
+  async onDisable(context) {
+    await pollingHelper.onDisable(polling, {
+      auth: context.auth,
+      store: context.store,
+      propsValue: context.propsValue,
+    });
+  },
+  async test(context) {
+    return await pollingHelper.test(polling, context);
+  },
+  async run(context) {
+    return await pollingHelper.poll(polling, context);
+  },
+});

package/src/lib/trigger/new-incoming-sms.ts

@@ -0,0 +1,123 @@
+import { createTrigger, TriggerStrategy } from '@agnocon/pieces-framework';
+import {
+  HttpMethod,
+  HttpResponse,
+  httpClient,
+  AuthenticationType,
+} from '@agnocon/pieces-common';
+import { callTwilioApi, twilioCommon } from '../common';
+import { twilioAuth } from '../..';
+
+export const twilioNewIncomingSms = createTrigger({
+  auth: twilioAuth,
+  name: 'new_incoming_sms',
+  displayName: 'New Incoming SMS',
+  description: 'Triggers when a new SMS message is received',
+  aiMetadata: {
+    description: 'Fires when an inbound SMS message is received on the specified Twilio phone number. Each event represents one incoming text message with its sender, body, and metadata.',
+  },
+  props: {
+    phone_number: twilioCommon.phone_number,
+  },
+  sampleData: {
+    body: 'Hello',
+    num_segments: '1',
+    direction: 'inbound',
+    from: '+12184191735',
+    date_updated: 'Wed, 08 Feb 2023 01:40:51 +0000',
+    price: null,
+    error_message: null,
+    uri: '/2010-04-01/Accounts/ACc0ea1238d61fe90d78a69a3de71d45619/Messages/SM8c3920d3f2ac481ba83e639a69dadd63.json',
+    account_sid: 'ACc0ea716d61fe90d78a123a3de71d45619',
+    num_media: '0',
+    to: '+12184191735',
+    date_created: 'Wed, 08 Feb 2023 01:40:50 +0000',
+    status: 'failed',
+    sid: 'SM8c3920d3f2ac481ba83e639a69dadd63',
+    date_sent: 'Wed, 08 Feb 2023 01:40:51 +0000',
+    messaging_service_sid: 'MG88e323e6a88ce67ba3bf12e1bcb7e0b8',
+    error_code: 21211,
+    price_unit: 'USD',
+    api_version: '2010-04-01',
+    subresource_uris: {
+      media:
+        '/2010-04-01/Accounts/ACc0ea716d61fe90d78a69a3de71d45619/Messages/SM8c3920d3f2ac481ba83e639a69dadd63/Media.json',
+      feedback:
+        '/2010-04-01/Accounts/ACc0ea716d61fe90d78a69a3de71d45619/Messages/SM8c3920d3f2ac481ba83e639a69dadd63/Feedback.json',
+    },
+  },
+  // Twilio API only allows one webhook per phone number, so we need to poll
+  type: TriggerStrategy.POLLING,
+  async onEnable(context) {
+    const { phone_number } = context.propsValue;
+    const account_sid = context.auth.username;
+    const auth_token = context.auth.password;
+    const response = await callTwilioApi<MessagePaginationResponse>(
+      HttpMethod.GET,
+      `Messages.json?PageSize=20&To=${phone_number}`,
+      { account_sid, auth_token },
+      {}
+    );
+    await context.store.put<LastMessage>('_new_incoming_sms_trigger', {
+      lastMessageId:
+        response.body.messages.length === 0
+          ? null
+          : response.body.messages[0].sid,
+    });
+  },
+  async onDisable(context) {
+    await context.store.put('_new_incoming_sms_trigger', null);
+  },
+  async run(context) {
+    const account_sid = context.auth.username;
+    const auth_token = context.auth.password;
+    const newMessages: unknown[] = [];
+    const lastMessage = await context.store.get<LastMessage>(
+      '_new_incoming_sms_trigger'
+    );
+    let currentUri:
+      | string
+      | null = `2010-04-01/Accounts/${account_sid}/Messages.json?PageSize=20&To=${context.propsValue.phone_number}`;
+    let firstMessageId = undefined;
+    while (currentUri !== undefined && currentUri !== null) {
+      const res: HttpResponse<MessagePaginationResponse> =
+        await httpClient.sendRequest<MessagePaginationResponse>({
+          method: HttpMethod.GET,
+          url: `https://api.twilio.com/${currentUri}`,
+          authentication: {
+            type: AuthenticationType.BASIC,
+            username: account_sid,
+            password: auth_token,
+          },
+        });
+      const messages = res.body.messages;
+      if (!firstMessageId && messages.length > 0) {
+        firstMessageId = messages[0].sid;
+      }
+      currentUri = res.body.next_page_uri;
+      for (let i = 0; i < messages.length; i++) {
+        const message = messages[i];
+        if (message.sid === lastMessage?.lastMessageId) {
+          currentUri = null;
+          break;
+        }
+        if (message.direction === 'inbound') {
+          newMessages.push(message);
+        }
+      }
+    }
+    await context.store.put<LastMessage>('_new_incoming_sms_trigger', {
+      lastMessageId: firstMessageId ?? lastMessage!.lastMessageId,
+    });
+    return newMessages;
+  },
+});
+
+interface LastMessage {
+  lastMessageId: string | null;
+}
+
+interface MessagePaginationResponse {
+  messages: { sid: string; to: string; status: string; direction: string }[];
+  next_page_uri: string;
+}

package/src/lib/trigger/new-phone-number.ts

@@ -0,0 +1,149 @@
+import {
+  AppConnectionValueForAuthProperty,
+  createTrigger,
+  PiecePropValueSchema,
+  TriggerStrategy,
+} from '@agnocon/pieces-framework';
+import {
+  AuthenticationType,
+  DedupeStrategy,
+  httpClient,
+  HttpMethod,
+  Polling,
+  pollingHelper,
+} from '@agnocon/pieces-common';
+import { twilioAuth } from '../..';
+
+// The full structure of an IncomingPhoneNumber object from the Twilio API
+interface TwilioPhoneNumber {
+  sid: string;
+  account_sid: string;
+  friendly_name: string;
+  phone_number: string;
+  voice_url: string;
+  voice_method: string;
+  sms_url: string;
+  sms_method: string;
+  date_created: string;
+  date_updated: string;
+  capabilities: {
+    voice: boolean;
+    sms: boolean;
+    mms: boolean;
+  };
+  uri: string;
+}
+
+interface IncomingPhoneNumbersResponse {
+  incoming_phone_numbers: TwilioPhoneNumber[];
+  next_page_uri:string
+}
+
+const polling: Polling<
+  AppConnectionValueForAuthProperty<typeof twilioAuth>,
+  Record<string, unknown>
+> = {
+  strategy: DedupeStrategy.TIMEBASED,
+  async items({ auth, lastFetchEpochMS }) {
+    const isTest = lastFetchEpochMS === 0;
+    const account_sid = auth.username;
+    const auth_token = auth.password;
+
+    let currentUri:
+      | string
+      | null = `/2010-04-01/Accounts/${account_sid}/IncomingPhoneNumbers.json?PageSize=${
+      isTest ? 10 : 1000
+    }`;
+
+    const results = [];
+    let stop = false;
+
+    do {
+      const response: any = await httpClient.sendRequest({
+        method: HttpMethod.GET,
+        url: `https://api.twilio.com${currentUri}`,
+        authentication: {
+          type: AuthenticationType.BASIC,
+          username: account_sid,
+          password: auth_token,
+        },
+      });
+
+      const payload = response.body as IncomingPhoneNumbersResponse;
+
+      const numbers = payload.incoming_phone_numbers ?? [];
+
+      for (const num of numbers) {
+        const ts = new Date(num.date_created).getTime();
+
+        if (isTest || ts > lastFetchEpochMS) {
+          results.push(num);
+        } else {
+          stop = true;
+          break;
+        }
+      }
+
+      if (isTest) break;
+      currentUri = payload?.next_page_uri ?? null;
+    } while (currentUri && !stop);
+
+    return results.map((num) => {
+      return {
+        epochMilliSeconds: new Date(num.date_created).getTime(),
+        data: num,
+      };
+    });
+  },
+};
+
+export const twilioNewPhoneNumber = createTrigger({
+  auth: twilioAuth,
+  name: 'new_phone_number',
+  displayName: 'New Phone Number',
+  description: 'Triggers when you add a new phone number to your account.',
+  aiMetadata: {
+    description: 'Fires when a new phone number is provisioned on the Twilio account. Each event represents one newly added incoming phone number with its capabilities and configuration.',
+  },
+  props: {},
+  sampleData: {
+    sid: 'PNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX',
+    account_sid: 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX',
+    friendly_name: '(555) 123-4567',
+    phone_number: '+15551234567',
+    voice_url: 'https://demo.twilio.com/welcome/voice/',
+    voice_method: 'POST',
+    sms_url: 'https://demo.twilio.com/welcome/sms/',
+    sms_method: 'POST',
+    date_created: '2025-08-28T11:44:10+00:00',
+    date_updated: '2025-08-28T11:44:10+00:00',
+    capabilities: {
+      voice: true,
+      sms: true,
+      mms: true,
+    },
+    uri: '/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/IncomingPhoneNumbers/PNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.json',
+  },
+  type: TriggerStrategy.POLLING,
+
+  async onEnable(context) {
+    await pollingHelper.onEnable(polling, {
+      auth: context.auth,
+      store: context.store,
+      propsValue: context.propsValue,
+    });
+  },
+  async onDisable(context) {
+    await pollingHelper.onDisable(polling, {
+      auth: context.auth,
+      store: context.store,
+      propsValue: context.propsValue,
+    });
+  },
+  async test(context) {
+    return await pollingHelper.test(polling, context);
+  },
+  async run(context) {
+    return await pollingHelper.poll(polling, context);
+  },
+});

package/src/lib/trigger/new-recording.ts

@@ -0,0 +1,140 @@
+import { AppConnectionValueForAuthProperty, createTrigger, PiecePropValueSchema, TriggerStrategy } from '@agnocon/pieces-framework';
+import { AuthenticationType, DedupeStrategy, httpClient, HttpMethod, Polling, pollingHelper } from '@agnocon/pieces-common';
+import { twilioAuth } from '../..';
+
+interface Recording {
+    sid: string;
+    status: string;
+    date_created: string;
+    call_sid: string;
+    duration: string;
+    source: string;
+    price: string;
+    price_unit: string;
+}
+
+interface RecordingsResponse {
+    recordings: Recording[];
+      next_page_uri:string
+
+}
+
+
+const polling: Polling<
+  AppConnectionValueForAuthProperty<typeof twilioAuth>,
+  Record<string, unknown>
+> = {
+  strategy: DedupeStrategy.TIMEBASED,
+  async items({ auth, lastFetchEpochMS }) {
+    const isTest = lastFetchEpochMS === 0;
+    const account_sid = auth.username;
+    const auth_token = auth.password;
+
+    let currentUri:
+      | string
+      | null = `/2010-04-01/Accounts/${account_sid}/Recordings.json?PageSize=${
+      isTest ? 10 : 1000
+    }`;
+
+    const results = [];
+    let stop = false;
+
+    do {
+      const response: any = await httpClient.sendRequest({
+        method: HttpMethod.GET,
+        url: `https://api.twilio.com${currentUri}`,
+        authentication: {
+          type: AuthenticationType.BASIC,
+          username: account_sid,
+          password: auth_token,
+        },
+      });
+
+      const payload = response.body as RecordingsResponse;
+
+      const recordings = payload.recordings ?? [];
+
+      for (const recording of recordings) {
+        const ts = new Date(recording.date_created).getTime();
+
+        if (isTest || ts > lastFetchEpochMS) {
+          results.push(recording);
+        } else {
+          stop = true;
+          break;
+        }
+      }
+
+      if (isTest) break;
+      currentUri = payload?.next_page_uri ?? null;
+    } while (currentUri && !stop);
+
+    return results.map((recording) => {
+      return {
+        epochMilliSeconds: new Date(recording.date_created).getTime(),
+        data: recording,
+      };
+    });
+  },
+};
+
+export const twilioNewRecording = createTrigger({
+    auth: twilioAuth,
+    name: 'new_recording',
+    displayName: 'New Recording',
+    description: 'Triggers when a new call recording is completed and available.',
+    aiMetadata: {
+      description: 'Fires when a new call recording becomes available on the Twilio account. Each event represents one completed recording, including its call SID, duration, and status.',
+    },
+    props: {},
+    sampleData: {
+      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "api_version": "2010-04-01",
+      "call_sid": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "conference_sid": "CFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "channels": 1,
+      "date_created": "Fri, 14 Oct 2016 21:56:34 +0000",
+      "date_updated": "Fri, 14 Oct 2016 21:56:38 +0000",
+      "start_time": "Fri, 14 Oct 2016 21:56:34 +0000",
+      "price": "0.04",
+      "price_unit": "USD",
+      "duration": "4",
+      "sid": "REaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "source": "StartConferenceRecordingAPI",
+      "status": "completed",
+      "error_code": null,
+      "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Recordings/REaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json",
+      "subresource_uris": {
+        "add_on_results": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Recordings/REaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AddOnResults.json",
+        "transcriptions": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Recordings/REaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Transcriptions.json"
+      },
+      "encryption_details": {
+        "encryption_public_key_sid": "CRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+        "encryption_cek": "OV4h6zrsxMIW7h0Zfqwfn6TI2GCNl54KALlg8wn8YB8KYZhXt6HlgvBWAmQTlfYVeLWydMiCewY0YkDDT1xmNe5huEo9vjuKBS5OmYK4CZkSx1NVv3XOGrZHpd2Pl/5WJHVhUK//AUO87uh5qnUP2E0KoLh1nyCLeGcEkXU0RfpPn/6nxjof/n6m6OzZOyeIRK4Oed5+rEtjqFDfqT0EVKjs6JAxv+f0DCc1xYRHl2yV8bahUPVKs+bHYdy4PVszFKa76M/Uae4jFA9Lv233JqWcxj+K2UoghuGhAFbV/JQIIswY2CBYI8JlVSifSqNEl9vvsTJ8bkVMm3MKbG2P7Q==",
+        "encryption_iv": "8I2hhNIYNTrwxfHk"
+      },
+      "media_url": "http://api.twilio.com/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Recordings/REaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+    },
+    type: TriggerStrategy.POLLING,
+
+  async onEnable(context) {
+    await pollingHelper.onEnable(polling, {
+      auth: context.auth,
+      store: context.store,
+      propsValue: context.propsValue,
+    });
+  },
+  async onDisable(context) {
+    await pollingHelper.onDisable(polling, {
+      auth: context.auth,
+      store: context.store,
+      propsValue: context.propsValue,
+    });
+  },
+  async test(context) {
+    return await pollingHelper.test(polling, context);
+  },
+  async run(context) {
+    return await pollingHelper.poll(polling, context);
+  },
+});