@agent-comm/piece-agent-comms 0.1.0

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@agent-comm/piece-agent-comms",
+  "version": "0.1.0",
+  "description": "Agent Comms — voice-agent communications. Triggers on calls, appointments and chats; place outbound calls, upsert contacts and send SMS.",
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "files": [
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@activepieces/pieces-common": "0.12.4",
+    "@activepieces/pieces-framework": "0.30.0",
+    "@activepieces/shared": "0.92.0",
+    "tslib": "2.6.2"
+  },
+  "devDependencies": {
+    "typescript": "5.4.5"
+  }
+}

package/src/index.d.ts

@@ -0,0 +1 @@
+export declare const agentComms: import("@activepieces/pieces-framework").Piece<import("@activepieces/pieces-framework").SecretTextProperty<true>>;

package/src/index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentComms = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const shared_1 = require("@activepieces/shared");
+const auth_1 = require("./lib/auth");
+const call_completed_1 = require("./lib/triggers/call-completed");
+const appointment_created_1 = require("./lib/triggers/appointment-created");
+const chat_completed_1 = require("./lib/triggers/chat-completed");
+const make_outbound_call_1 = require("./lib/actions/make-outbound-call");
+const upsert_contact_1 = require("./lib/actions/upsert-contact");
+const send_sms_1 = require("./lib/actions/send-sms");
+// Agent Comms — voice-agent communications. Neutral white-label name (NOT the platform's brand) so
+// resellers' customers never see who powers it. One opaque API key per workspace scopes every
+// trigger and action to that org server-side; the piece itself holds no org identity.
+// TODO before install: upload a neutral logo to the agent-comms-logo.png path below.
+exports.agentComms = (0, pieces_framework_1.createPiece)({
+    displayName: 'Agent Comms',
+    description: 'Agent communications. Trigger flows on completed calls, new appointments and finished chats; place outbound calls, upsert CRM contacts, and send SMS.',
+    auth: auth_1.bellvoxAuth,
+    minimumSupportedRelease: '0.36.1',
+    logoUrl: 'https://ajhcthysvaaqunjvqlgy.supabase.co/storage/v1/object/public/public/agent-comms-logo.png',
+    categories: [shared_1.PieceCategory.COMMUNICATION, shared_1.PieceCategory.SALES_AND_CRM],
+    authors: ['agent-comms'],
+    triggers: [call_completed_1.callCompleted, appointment_created_1.appointmentCreated, chat_completed_1.chatCompleted],
+    actions: [make_outbound_call_1.makeOutboundCall, upsert_contact_1.upsertContact, send_sms_1.sendSms],
+});

package/src/index.ts

@@ -0,0 +1,26 @@
+import { createPiece } from '@activepieces/pieces-framework';
+import { PieceCategory } from '@activepieces/shared';
+import { bellvoxAuth } from './lib/auth';
+import { callCompleted } from './lib/triggers/call-completed';
+import { appointmentCreated } from './lib/triggers/appointment-created';
+import { chatCompleted } from './lib/triggers/chat-completed';
+import { makeOutboundCall } from './lib/actions/make-outbound-call';
+import { upsertContact } from './lib/actions/upsert-contact';
+import { sendSms } from './lib/actions/send-sms';
+
+// Agent Comms — voice-agent communications. Neutral white-label name (NOT the platform's brand) so
+// resellers' customers never see who powers it. One opaque API key per workspace scopes every
+// trigger and action to that org server-side; the piece itself holds no org identity.
+// TODO before install: upload a neutral logo to the agent-comms-logo.png path below.
+export const agentComms = createPiece({
+  displayName: 'Agent Comms',
+  description:
+    'Agent communications. Trigger flows on completed calls, new appointments and finished chats; place outbound calls, upsert CRM contacts, and send SMS.',
+  auth: bellvoxAuth,
+  minimumSupportedRelease: '0.36.1',
+  logoUrl: 'https://ajhcthysvaaqunjvqlgy.supabase.co/storage/v1/object/public/public/agent-comms-logo.png',
+  categories: [PieceCategory.COMMUNICATION, PieceCategory.SALES_AND_CRM],
+  authors: ['agent-comms'],
+  triggers: [callCompleted, appointmentCreated, chatCompleted],
+  actions: [makeOutboundCall, upsertContact, sendSms],
+});

package/src/lib/actions/make-outbound-call.d.ts

@@ -0,0 +1,4 @@
+export declare const makeOutboundCall: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").SecretTextProperty<true>, {
+    assistant_id: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    to_number: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+}>;

package/src/lib/actions/make-outbound-call.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeOutboundCall = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const pieces_common_1 = require("@activepieces/pieces-common");
+const auth_1 = require("../auth");
+const common_1 = require("../common");
+// Place an outbound AI call. The edge fn verifies the assistant belongs to the key's org
+// before dialing — we never trust the assistant_id alone.
+exports.makeOutboundCall = (0, pieces_framework_1.createAction)({
+    auth: auth_1.bellvoxAuth,
+    name: 'make_outbound_call',
+    displayName: 'Make Outbound Call',
+    description: 'Have a Bellvox assistant place an outbound phone call.',
+    props: {
+        assistant_id: pieces_framework_1.Property.ShortText({
+            displayName: 'Assistant ID',
+            description: 'The Bellvox assistant that should place the call.',
+            required: true,
+        }),
+        to_number: pieces_framework_1.Property.ShortText({
+            displayName: 'To Number',
+            description: 'Destination phone number in E.164 format, e.g. +15557654321.',
+            required: true,
+        }),
+    },
+    async run(context) {
+        const res = await pieces_common_1.httpClient.sendRequest({
+            method: pieces_common_1.HttpMethod.POST,
+            url: `${common_1.BELLVOX_API}/ap-actions?do=make_outbound_call`,
+            headers: { 'x-bellvox-key': (0, common_1.authKey)(context.auth) },
+            body: {
+                assistant_id: context.propsValue.assistant_id,
+                to_number: context.propsValue.to_number,
+            },
+        });
+        return res.body;
+    },
+});

package/src/lib/actions/make-outbound-call.ts

@@ -0,0 +1,37 @@
+import { createAction, Property } from '@activepieces/pieces-framework';
+import { httpClient, HttpMethod } from '@activepieces/pieces-common';
+import { bellvoxAuth } from '../auth';
+import { BELLVOX_API, authKey } from '../common';
+
+// Place an outbound AI call. The edge fn verifies the assistant belongs to the key's org
+// before dialing — we never trust the assistant_id alone.
+export const makeOutboundCall = createAction({
+  auth: bellvoxAuth,
+  name: 'make_outbound_call',
+  displayName: 'Make Outbound Call',
+  description: 'Have a Bellvox assistant place an outbound phone call.',
+  props: {
+    assistant_id: Property.ShortText({
+      displayName: 'Assistant ID',
+      description: 'The Bellvox assistant that should place the call.',
+      required: true,
+    }),
+    to_number: Property.ShortText({
+      displayName: 'To Number',
+      description: 'Destination phone number in E.164 format, e.g. +15557654321.',
+      required: true,
+    }),
+  },
+  async run(context) {
+    const res = await httpClient.sendRequest({
+      method: HttpMethod.POST,
+      url: `${BELLVOX_API}/ap-actions?do=make_outbound_call`,
+      headers: { 'x-bellvox-key': authKey(context.auth) },
+      body: {
+        assistant_id: context.propsValue.assistant_id,
+        to_number: context.propsValue.to_number,
+      },
+    });
+    return res.body;
+  },
+});

package/src/lib/actions/send-sms.d.ts

@@ -0,0 +1,4 @@
+export declare const sendSms: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").SecretTextProperty<true>, {
+    to: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    body: import("@activepieces/pieces-framework").LongTextProperty<true>;
+}>;

package/src/lib/actions/send-sms.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendSms = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const pieces_common_1 = require("@activepieces/pieces-common");
+const auth_1 = require("../auth");
+const common_1 = require("../common");
+// Send an SMS from the org's active number. Sender selection + carrier auth happen server-side.
+exports.sendSms = (0, pieces_framework_1.createAction)({
+    auth: auth_1.bellvoxAuth,
+    name: 'send_sms',
+    displayName: 'Send SMS',
+    description: 'Send a text message from your Bellvox number.',
+    props: {
+        to: pieces_framework_1.Property.ShortText({
+            displayName: 'To',
+            description: 'Destination phone number in E.164 format, e.g. +15557654321.',
+            required: true,
+        }),
+        body: pieces_framework_1.Property.LongText({
+            displayName: 'Message',
+            description: 'The text message body.',
+            required: true,
+        }),
+    },
+    async run(context) {
+        const res = await pieces_common_1.httpClient.sendRequest({
+            method: pieces_common_1.HttpMethod.POST,
+            url: `${common_1.BELLVOX_API}/ap-actions?do=send_sms`,
+            headers: { 'x-bellvox-key': (0, common_1.authKey)(context.auth) },
+            body: {
+                to: context.propsValue.to,
+                body: context.propsValue.body,
+            },
+        });
+        return res.body;
+    },
+});

package/src/lib/actions/send-sms.ts

@@ -0,0 +1,36 @@
+import { createAction, Property } from '@activepieces/pieces-framework';
+import { httpClient, HttpMethod } from '@activepieces/pieces-common';
+import { bellvoxAuth } from '../auth';
+import { BELLVOX_API, authKey } from '../common';
+
+// Send an SMS from the org's active number. Sender selection + carrier auth happen server-side.
+export const sendSms = createAction({
+  auth: bellvoxAuth,
+  name: 'send_sms',
+  displayName: 'Send SMS',
+  description: 'Send a text message from your Bellvox number.',
+  props: {
+    to: Property.ShortText({
+      displayName: 'To',
+      description: 'Destination phone number in E.164 format, e.g. +15557654321.',
+      required: true,
+    }),
+    body: Property.LongText({
+      displayName: 'Message',
+      description: 'The text message body.',
+      required: true,
+    }),
+  },
+  async run(context) {
+    const res = await httpClient.sendRequest({
+      method: HttpMethod.POST,
+      url: `${BELLVOX_API}/ap-actions?do=send_sms`,
+      headers: { 'x-bellvox-key': authKey(context.auth) },
+      body: {
+        to: context.propsValue.to,
+        body: context.propsValue.body,
+      },
+    });
+    return res.body;
+  },
+});

package/src/lib/actions/upsert-contact.d.ts

@@ -0,0 +1,7 @@
+export declare const upsertContact: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").SecretTextProperty<true>, {
+    name: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    phone: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    email: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    status: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    tags: import("@activepieces/pieces-framework").ArrayProperty<false>;
+}>;

package/src/lib/actions/upsert-contact.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.upsertContact = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const pieces_common_1 = require("@activepieces/pieces-common");
+const auth_1 = require("../auth");
+const common_1 = require("../common");
+// Create or update a CRM contact in the key's org. org_id is derived server-side from the key.
+exports.upsertContact = (0, pieces_framework_1.createAction)({
+    auth: auth_1.bellvoxAuth,
+    name: 'upsert_contact',
+    displayName: 'Upsert Contact',
+    description: 'Create or update a contact in the Bellvox CRM.',
+    props: {
+        name: pieces_framework_1.Property.ShortText({
+            displayName: 'Name',
+            required: false,
+        }),
+        phone: pieces_framework_1.Property.ShortText({
+            displayName: 'Phone',
+            description: 'Phone number in E.164 format. Used as the match key for upserts.',
+            required: false,
+        }),
+        email: pieces_framework_1.Property.ShortText({
+            displayName: 'Email',
+            required: false,
+        }),
+        status: pieces_framework_1.Property.ShortText({
+            displayName: 'Status',
+            description: "Pipeline status, e.g. 'lead', 'customer'. Defaults to 'lead' on the server.",
+            required: false,
+        }),
+        tags: pieces_framework_1.Property.Array({
+            displayName: 'Tags',
+            required: false,
+        }),
+    },
+    async run(context) {
+        const res = await pieces_common_1.httpClient.sendRequest({
+            method: pieces_common_1.HttpMethod.POST,
+            url: `${common_1.BELLVOX_API}/ap-actions?do=upsert_contact`,
+            headers: { 'x-bellvox-key': (0, common_1.authKey)(context.auth) },
+            body: {
+                name: context.propsValue.name,
+                phone: context.propsValue.phone,
+                email: context.propsValue.email,
+                status: context.propsValue.status,
+                tags: context.propsValue.tags,
+            },
+        });
+        return res.body;
+    },
+});

package/src/lib/actions/upsert-contact.ts

@@ -0,0 +1,51 @@
+import { createAction, Property } from '@activepieces/pieces-framework';
+import { httpClient, HttpMethod } from '@activepieces/pieces-common';
+import { bellvoxAuth } from '../auth';
+import { BELLVOX_API, authKey } from '../common';
+
+// Create or update a CRM contact in the key's org. org_id is derived server-side from the key.
+export const upsertContact = createAction({
+  auth: bellvoxAuth,
+  name: 'upsert_contact',
+  displayName: 'Upsert Contact',
+  description: 'Create or update a contact in the Bellvox CRM.',
+  props: {
+    name: Property.ShortText({
+      displayName: 'Name',
+      required: false,
+    }),
+    phone: Property.ShortText({
+      displayName: 'Phone',
+      description: 'Phone number in E.164 format. Used as the match key for upserts.',
+      required: false,
+    }),
+    email: Property.ShortText({
+      displayName: 'Email',
+      required: false,
+    }),
+    status: Property.ShortText({
+      displayName: 'Status',
+      description: "Pipeline status, e.g. 'lead', 'customer'. Defaults to 'lead' on the server.",
+      required: false,
+    }),
+    tags: Property.Array({
+      displayName: 'Tags',
+      required: false,
+    }),
+  },
+  async run(context) {
+    const res = await httpClient.sendRequest({
+      method: HttpMethod.POST,
+      url: `${BELLVOX_API}/ap-actions?do=upsert_contact`,
+      headers: { 'x-bellvox-key': authKey(context.auth) },
+      body: {
+        name: context.propsValue.name,
+        phone: context.propsValue.phone,
+        email: context.propsValue.email,
+        status: context.propsValue.status,
+        tags: context.propsValue.tags,
+      },
+    });
+    return res.body;
+  },
+});

package/src/lib/auth.d.ts

@@ -0,0 +1 @@
+export declare const bellvoxAuth: import("@activepieces/pieces-framework").SecretTextProperty<true>;

package/src/lib/auth.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bellvoxAuth = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const pieces_common_1 = require("@activepieces/pieces-common");
+const common_1 = require("./common");
+const MARKDOWN = `
+Paste your **API Key** to connect.
+
+1. Sign in to your workspace.
+2. Open the **Automations** page and click **Generate key** (or **Regenerate**).
+3. Copy the \`bvx_…\` key shown once and paste it here.
+
+The key scopes every flow to *your* workspace only.
+`;
+// Secret API key. validate() round-trips the key against ap-credentials?action=whoami:
+// a 200 with { ok:true, org_id } means the key resolves to a real org; anything else is invalid.
+// NOTE: the wire header (x-bellvox-key) + endpoints are the fixed server contract — not shown to
+// users — so they stay; only the displayed labels/copy are brand-neutral ("Agent Comms").
+exports.bellvoxAuth = pieces_framework_1.PieceAuth.SecretText({
+    displayName: 'API Key',
+    description: MARKDOWN,
+    required: true,
+    validate: async ({ auth }) => {
+        try {
+            const res = await pieces_common_1.httpClient.sendRequest({
+                method: pieces_common_1.HttpMethod.GET,
+                url: `${common_1.BELLVOX_API}/ap-credentials?action=whoami`,
+                // In a SecretText validate the arg is { auth }, where `auth` is the raw secret string.
+                headers: { 'x-bellvox-key': auth },
+            });
+            if (res.status === 200 && res.body?.ok && res.body?.org_id) {
+                return { valid: true };
+            }
+            return { valid: false, error: 'That API key was not recognized.' };
+        }
+        catch (e) {
+            return {
+                valid: false,
+                error: 'Could not validate the API key. Check the key and try again.',
+            };
+        }
+    },
+});

package/src/lib/auth.ts

@@ -0,0 +1,42 @@
+import { PieceAuth } from '@activepieces/pieces-framework';
+import { httpClient, HttpMethod } from '@activepieces/pieces-common';
+import { BELLVOX_API } from './common';
+
+const MARKDOWN = `
+Paste your **API Key** to connect.
+
+1. Sign in to your workspace.
+2. Open the **Automations** page and click **Generate key** (or **Regenerate**).
+3. Copy the \`bvx_…\` key shown once and paste it here.
+
+The key scopes every flow to *your* workspace only.
+`;
+
+// Secret API key. validate() round-trips the key against ap-credentials?action=whoami:
+// a 200 with { ok:true, org_id } means the key resolves to a real org; anything else is invalid.
+// NOTE: the wire header (x-bellvox-key) + endpoints are the fixed server contract — not shown to
+// users — so they stay; only the displayed labels/copy are brand-neutral ("Agent Comms").
+export const bellvoxAuth = PieceAuth.SecretText({
+  displayName: 'API Key',
+  description: MARKDOWN,
+  required: true,
+  validate: async ({ auth }) => {
+    try {
+      const res = await httpClient.sendRequest<{ ok?: boolean; org_id?: string }>({
+        method: HttpMethod.GET,
+        url: `${BELLVOX_API}/ap-credentials?action=whoami`,
+        // In a SecretText validate the arg is { auth }, where `auth` is the raw secret string.
+        headers: { 'x-bellvox-key': auth },
+      });
+      if (res.status === 200 && res.body?.ok && res.body?.org_id) {
+        return { valid: true };
+      }
+      return { valid: false, error: 'That API key was not recognized.' };
+    } catch (e) {
+      return {
+        valid: false,
+        error: 'Could not validate the API key. Check the key and try again.',
+      };
+    }
+  },
+});

package/src/lib/common.d.ts

@@ -0,0 +1,2 @@
+export declare const BELLVOX_API = "https://ajhcthysvaaqunjvqlgy.supabase.co/functions/v1";
+export declare function authKey(auth: unknown): string;

package/src/lib/common.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.authKey = exports.BELLVOX_API = void 0;
+// Shared constants for the Bellvox piece.
+//
+// Every action/trigger talks to Bellvox's Supabase edge functions. Auth is a single opaque
+// API key ("bvx_..." + 40 hex) presented in the x-bellvox-key header. The edge function
+// resolves that key -> the caller's org and scopes everything to it (the key is the ONLY
+// source of org identity — request bodies never carry an org/assistant we trust blindly).
+exports.BELLVOX_API = 'https://ajhcthysvaaqunjvqlgy.supabase.co/functions/v1';
+// AP resolves SecretText auth to the raw "bvx_..." string at runtime, but the framework types it as
+// a { type, secret_text } connection object. Read it defensively so the x-bellvox-key header is the
+// plain key string whichever shape a given AP version hands the action/trigger.
+function authKey(auth) {
+    if (auth && typeof auth === 'object' && 'secret_text' in auth) {
+        return String(auth.secret_text);
+    }
+    return String(auth ?? '');
+}
+exports.authKey = authKey;

package/src/lib/common.ts

@@ -0,0 +1,17 @@
+// Shared constants for the Bellvox piece.
+//
+// Every action/trigger talks to Bellvox's Supabase edge functions. Auth is a single opaque
+// API key ("bvx_..." + 40 hex) presented in the x-bellvox-key header. The edge function
+// resolves that key -> the caller's org and scopes everything to it (the key is the ONLY
+// source of org identity — request bodies never carry an org/assistant we trust blindly).
+export const BELLVOX_API = 'https://ajhcthysvaaqunjvqlgy.supabase.co/functions/v1';
+
+// AP resolves SecretText auth to the raw "bvx_..." string at runtime, but the framework types it as
+// a { type, secret_text } connection object. Read it defensively so the x-bellvox-key header is the
+// plain key string whichever shape a given AP version hands the action/trigger.
+export function authKey(auth: unknown): string {
+  if (auth && typeof auth === 'object' && 'secret_text' in auth) {
+    return String((auth as { secret_text: unknown }).secret_text);
+  }
+  return String(auth ?? '');
+}

package/src/lib/triggers/appointment-created.d.ts

@@ -0,0 +1,2 @@
+import { TriggerStrategy } from '@activepieces/pieces-framework';
+export declare const appointmentCreated: import("@activepieces/pieces-framework").ITrigger<TriggerStrategy.WEBHOOK, import("@activepieces/pieces-framework").SecretTextProperty<true>, {}> | import("@activepieces/pieces-framework").ITrigger<TriggerStrategy.POLLING, import("@activepieces/pieces-framework").SecretTextProperty<true>, {}> | import("@activepieces/pieces-framework").ITrigger<TriggerStrategy.MANUAL, import("@activepieces/pieces-framework").SecretTextProperty<true>, {}> | import("@activepieces/pieces-framework").ITrigger<TriggerStrategy.APP_WEBHOOK, import("@activepieces/pieces-framework").SecretTextProperty<true>, {}>;

package/src/lib/triggers/appointment-created.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appointmentCreated = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const pieces_common_1 = require("@activepieces/pieces-common");
+const auth_1 = require("../auth");
+const common_1 = require("../common");
+// Fires when a Bellvox assistant books an appointment. Registration is identical to the other
+// triggers — only the trigger_event differs, which is what Bellvox uses to route fan-out.
+exports.appointmentCreated = (0, pieces_framework_1.createTrigger)({
+    auth: auth_1.bellvoxAuth,
+    name: 'appointment_created',
+    displayName: 'Appointment Created',
+    description: 'Fires when a Bellvox assistant books a new appointment.',
+    props: {},
+    type: pieces_framework_1.TriggerStrategy.WEBHOOK,
+    sampleData: {
+        appointment_id: 'b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e',
+        assistant_id: 'a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d',
+        assistant_name: 'Front Desk',
+        call_id: '8f3c2b1a-0d4e-4a9b-9c1f-2e6d7a8b9c0d',
+        contact_name: 'Jane Doe',
+        contact_phone: '+15557654321',
+        contact_email: 'jane.doe@example.com',
+        title: 'Consultation',
+        notes: 'New patient, prefers mornings.',
+        starts_at: '2026-06-29T14:00:00.000Z',
+        ends_at: '2026-06-29T14:30:00.000Z',
+        status: 'scheduled',
+        created_at: '2026-06-24T15:06:30.000Z',
+    },
+    async onEnable(context) {
+        const res = await pieces_common_1.httpClient.sendRequest({
+            method: pieces_common_1.HttpMethod.POST,
+            url: `${common_1.BELLVOX_API}/ap-credentials?action=register-webhook`,
+            headers: { 'x-bellvox-key': (0, common_1.authKey)(context.auth) },
+            body: {
+                event: 'appointment_created',
+                webhook_url: context.webhookUrl,
+                flow_name: 'Appointment Created',
+            },
+        });
+        await context.store.put('_bellvox_flow_id', res.body.id);
+    },
+    async onDisable(context) {
+        const id = await context.store.get('_bellvox_flow_id');
+        if (id) {
+            await pieces_common_1.httpClient.sendRequest({
+                method: pieces_common_1.HttpMethod.POST,
+                url: `${common_1.BELLVOX_API}/ap-credentials?action=unregister-webhook&id=${encodeURIComponent(id)}`,
+                headers: { 'x-bellvox-key': (0, common_1.authKey)(context.auth) },
+            });
+        }
+    },
+    async run(context) {
+        return [context.payload.body];
+    },
+});

package/src/lib/triggers/appointment-created.ts

@@ -0,0 +1,56 @@
+import { createTrigger, TriggerStrategy } from '@activepieces/pieces-framework';
+import { httpClient, HttpMethod } from '@activepieces/pieces-common';
+import { bellvoxAuth } from '../auth';
+import { BELLVOX_API, authKey } from '../common';
+
+// Fires when a Bellvox assistant books an appointment. Registration is identical to the other
+// triggers — only the trigger_event differs, which is what Bellvox uses to route fan-out.
+export const appointmentCreated = createTrigger({
+  auth: bellvoxAuth,
+  name: 'appointment_created',
+  displayName: 'Appointment Created',
+  description: 'Fires when a Bellvox assistant books a new appointment.',
+  props: {},
+  type: TriggerStrategy.WEBHOOK,
+  sampleData: {
+    appointment_id: 'b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e',
+    assistant_id: 'a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d',
+    assistant_name: 'Front Desk',
+    call_id: '8f3c2b1a-0d4e-4a9b-9c1f-2e6d7a8b9c0d',
+    contact_name: 'Jane Doe',
+    contact_phone: '+15557654321',
+    contact_email: 'jane.doe@example.com',
+    title: 'Consultation',
+    notes: 'New patient, prefers mornings.',
+    starts_at: '2026-06-29T14:00:00.000Z',
+    ends_at: '2026-06-29T14:30:00.000Z',
+    status: 'scheduled',
+    created_at: '2026-06-24T15:06:30.000Z',
+  },
+  async onEnable(context) {
+    const res = await httpClient.sendRequest<{ id: string }>({
+      method: HttpMethod.POST,
+      url: `${BELLVOX_API}/ap-credentials?action=register-webhook`,
+      headers: { 'x-bellvox-key': authKey(context.auth) },
+      body: {
+        event: 'appointment_created',
+        webhook_url: context.webhookUrl,
+        flow_name: 'Appointment Created',
+      },
+    });
+    await context.store.put('_bellvox_flow_id', res.body.id);
+  },
+  async onDisable(context) {
+    const id = await context.store.get<string>('_bellvox_flow_id');
+    if (id) {
+      await httpClient.sendRequest({
+        method: HttpMethod.POST,
+        url: `${BELLVOX_API}/ap-credentials?action=unregister-webhook&id=${encodeURIComponent(id)}`,
+        headers: { 'x-bellvox-key': authKey(context.auth) },
+      });
+    }
+  },
+  async run(context) {
+    return [context.payload.body];
+  },
+});

package/src/lib/triggers/call-completed.d.ts

@@ -0,0 +1,2 @@
+import { TriggerStrategy } from '@activepieces/pieces-framework';
+export declare const callCompleted: import("@activepieces/pieces-framework").ITrigger<TriggerStrategy.WEBHOOK, import("@activepieces/pieces-framework").SecretTextProperty<true>, {}> | import("@activepieces/pieces-framework").ITrigger<TriggerStrategy.POLLING, import("@activepieces/pieces-framework").SecretTextProperty<true>, {}> | import("@activepieces/pieces-framework").ITrigger<TriggerStrategy.MANUAL, import("@activepieces/pieces-framework").SecretTextProperty<true>, {}> | import("@activepieces/pieces-framework").ITrigger<TriggerStrategy.APP_WEBHOOK, import("@activepieces/pieces-framework").SecretTextProperty<true>, {}>;

package/src/lib/triggers/call-completed.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.callCompleted = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const pieces_common_1 = require("@activepieces/pieces-common");
+const auth_1 = require("../auth");
+const common_1 = require("../common");
+// Bellvox delivers a webhook to AP when a phone call wraps up. onEnable registers AP's
+// generated webhook URL with Bellvox (keyed to the caller's org via the API key); Bellvox
+// then POSTs the payload here on every completed call. We stash the returned flow row id so
+// onDisable can unregister precisely.
+exports.callCompleted = (0, pieces_framework_1.createTrigger)({
+    auth: auth_1.bellvoxAuth,
+    name: 'call_completed',
+    displayName: 'Call Completed',
+    description: 'Fires when a Bellvox voice call finishes (with transcript, summary and extracted data).',
+    props: {},
+    type: pieces_framework_1.TriggerStrategy.WEBHOOK,
+    sampleData: {
+        call_id: '8f3c2b1a-0d4e-4a9b-9c1f-2e6d7a8b9c0d',
+        assistant_id: 'a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d',
+        assistant_name: 'Front Desk',
+        from_number: '+15551230001',
+        to_number: '+15557654321',
+        direction: 'inbound',
+        number: '+15557654321',
+        duration_sec: 142,
+        transcript: 'Assistant: Thanks for calling Acme Clinic, how can I help?\nCaller: I need to reschedule my appointment...',
+        summary: 'Caller asked to reschedule their Thursday appointment to next Monday.',
+        extracted_data: {
+            patient_name: 'Jane Doe',
+            reason: 'reschedule',
+            requested_date: '2026-06-29',
+        },
+        recording_url: 'https://ajhcthysvaaqunjvqlgy.supabase.co/storage/v1/object/recordings/8f3c2b1a.mp3',
+        started_at: '2026-06-24T15:04:00.000Z',
+        ended_at: '2026-06-24T15:06:22.000Z',
+        status: 'completed',
+    },
+    async onEnable(context) {
+        const res = await pieces_common_1.httpClient.sendRequest({
+            method: pieces_common_1.HttpMethod.POST,
+            url: `${common_1.BELLVOX_API}/ap-credentials?action=register-webhook`,
+            headers: { 'x-bellvox-key': (0, common_1.authKey)(context.auth) },
+            body: {
+                event: 'call_completed',
+                webhook_url: context.webhookUrl,
+                flow_name: 'Call Completed',
+            },
+        });
+        await context.store.put('_bellvox_flow_id', res.body.id);
+    },
+    async onDisable(context) {
+        const id = await context.store.get('_bellvox_flow_id');
+        if (id) {
+            await pieces_common_1.httpClient.sendRequest({
+                method: pieces_common_1.HttpMethod.POST,
+                url: `${common_1.BELLVOX_API}/ap-credentials?action=unregister-webhook&id=${encodeURIComponent(id)}`,
+                headers: { 'x-bellvox-key': (0, common_1.authKey)(context.auth) },
+            });
+        }
+    },
+    async run(context) {
+        return [context.payload.body];
+    },
+});

package/src/lib/triggers/call-completed.ts

@@ -0,0 +1,65 @@
+import { createTrigger, TriggerStrategy } from '@activepieces/pieces-framework';
+import { httpClient, HttpMethod } from '@activepieces/pieces-common';
+import { bellvoxAuth } from '../auth';
+import { BELLVOX_API, authKey } from '../common';
+
+// Bellvox delivers a webhook to AP when a phone call wraps up. onEnable registers AP's
+// generated webhook URL with Bellvox (keyed to the caller's org via the API key); Bellvox
+// then POSTs the payload here on every completed call. We stash the returned flow row id so
+// onDisable can unregister precisely.
+export const callCompleted = createTrigger({
+  auth: bellvoxAuth,
+  name: 'call_completed',
+  displayName: 'Call Completed',
+  description: 'Fires when a Bellvox voice call finishes (with transcript, summary and extracted data).',
+  props: {},
+  type: TriggerStrategy.WEBHOOK,
+  sampleData: {
+    call_id: '8f3c2b1a-0d4e-4a9b-9c1f-2e6d7a8b9c0d',
+    assistant_id: 'a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d',
+    assistant_name: 'Front Desk',
+    from_number: '+15551230001',
+    to_number: '+15557654321',
+    direction: 'inbound',
+    number: '+15557654321',
+    duration_sec: 142,
+    transcript:
+      'Assistant: Thanks for calling Acme Clinic, how can I help?\nCaller: I need to reschedule my appointment...',
+    summary: 'Caller asked to reschedule their Thursday appointment to next Monday.',
+    extracted_data: {
+      patient_name: 'Jane Doe',
+      reason: 'reschedule',
+      requested_date: '2026-06-29',
+    },
+    recording_url: 'https://ajhcthysvaaqunjvqlgy.supabase.co/storage/v1/object/recordings/8f3c2b1a.mp3',
+    started_at: '2026-06-24T15:04:00.000Z',
+    ended_at: '2026-06-24T15:06:22.000Z',
+    status: 'completed',
+  },
+  async onEnable(context) {
+    const res = await httpClient.sendRequest<{ id: string }>({
+      method: HttpMethod.POST,
+      url: `${BELLVOX_API}/ap-credentials?action=register-webhook`,
+      headers: { 'x-bellvox-key': authKey(context.auth) },
+      body: {
+        event: 'call_completed',
+        webhook_url: context.webhookUrl,
+        flow_name: 'Call Completed',
+      },
+    });
+    await context.store.put('_bellvox_flow_id', res.body.id);
+  },
+  async onDisable(context) {
+    const id = await context.store.get<string>('_bellvox_flow_id');
+    if (id) {
+      await httpClient.sendRequest({
+        method: HttpMethod.POST,
+        url: `${BELLVOX_API}/ap-credentials?action=unregister-webhook&id=${encodeURIComponent(id)}`,
+        headers: { 'x-bellvox-key': authKey(context.auth) },
+      });
+    }
+  },
+  async run(context) {
+    return [context.payload.body];
+  },
+});

package/src/lib/triggers/chat-completed.d.ts

@@ -0,0 +1,2 @@
+import { TriggerStrategy } from '@activepieces/pieces-framework';
+export declare const chatCompleted: import("@activepieces/pieces-framework").ITrigger<TriggerStrategy.WEBHOOK, import("@activepieces/pieces-framework").SecretTextProperty<true>, {}> | import("@activepieces/pieces-framework").ITrigger<TriggerStrategy.POLLING, import("@activepieces/pieces-framework").SecretTextProperty<true>, {}> | import("@activepieces/pieces-framework").ITrigger<TriggerStrategy.MANUAL, import("@activepieces/pieces-framework").SecretTextProperty<true>, {}> | import("@activepieces/pieces-framework").ITrigger<TriggerStrategy.APP_WEBHOOK, import("@activepieces/pieces-framework").SecretTextProperty<true>, {}>;

package/src/lib/triggers/chat-completed.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chatCompleted = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const pieces_common_1 = require("@activepieces/pieces-common");
+const auth_1 = require("../auth");
+const common_1 = require("../common");
+// Fires when a Bellvox web-chat conversation ends. Same registration handshake as the other
+// triggers; trigger_event = chat_completed.
+exports.chatCompleted = (0, pieces_framework_1.createTrigger)({
+    auth: auth_1.bellvoxAuth,
+    name: 'chat_completed',
+    displayName: 'Chat Completed',
+    description: 'Fires when a Bellvox web-chat conversation ends (with transcript and summary).',
+    props: {},
+    type: pieces_framework_1.TriggerStrategy.WEBHOOK,
+    sampleData: {
+        chat_id: 'c3d4e5f6-a7b8-4c9d-0e1f-2a3b4c5d6e7f',
+        assistant_id: 'a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d',
+        assistant_name: 'Website Concierge',
+        visitor_id: 'v_9f8e7d6c',
+        contact_name: 'Jane Doe',
+        contact_email: 'jane.doe@example.com',
+        message_count: 8,
+        transcript: 'Visitor: Do you carry CPAP supplies?\nAssistant: Yes — we stock masks, tubing and filters...',
+        summary: 'Visitor asked about CPAP supplies and store hours; provided email for follow-up.',
+        extracted_data: { intent: 'product_inquiry', product: 'CPAP supplies' },
+        started_at: '2026-06-24T15:00:00.000Z',
+        ended_at: '2026-06-24T15:03:40.000Z',
+        status: 'completed',
+    },
+    async onEnable(context) {
+        const res = await pieces_common_1.httpClient.sendRequest({
+            method: pieces_common_1.HttpMethod.POST,
+            url: `${common_1.BELLVOX_API}/ap-credentials?action=register-webhook`,
+            headers: { 'x-bellvox-key': (0, common_1.authKey)(context.auth) },
+            body: {
+                event: 'chat_completed',
+                webhook_url: context.webhookUrl,
+                flow_name: 'Chat Completed',
+            },
+        });
+        await context.store.put('_bellvox_flow_id', res.body.id);
+    },
+    async onDisable(context) {
+        const id = await context.store.get('_bellvox_flow_id');
+        if (id) {
+            await pieces_common_1.httpClient.sendRequest({
+                method: pieces_common_1.HttpMethod.POST,
+                url: `${common_1.BELLVOX_API}/ap-credentials?action=unregister-webhook&id=${encodeURIComponent(id)}`,
+                headers: { 'x-bellvox-key': (0, common_1.authKey)(context.auth) },
+            });
+        }
+    },
+    async run(context) {
+        return [context.payload.body];
+    },
+});

package/src/lib/triggers/chat-completed.ts

@@ -0,0 +1,57 @@
+import { createTrigger, TriggerStrategy } from '@activepieces/pieces-framework';
+import { httpClient, HttpMethod } from '@activepieces/pieces-common';
+import { bellvoxAuth } from '../auth';
+import { BELLVOX_API, authKey } from '../common';
+
+// Fires when a Bellvox web-chat conversation ends. Same registration handshake as the other
+// triggers; trigger_event = chat_completed.
+export const chatCompleted = createTrigger({
+  auth: bellvoxAuth,
+  name: 'chat_completed',
+  displayName: 'Chat Completed',
+  description: 'Fires when a Bellvox web-chat conversation ends (with transcript and summary).',
+  props: {},
+  type: TriggerStrategy.WEBHOOK,
+  sampleData: {
+    chat_id: 'c3d4e5f6-a7b8-4c9d-0e1f-2a3b4c5d6e7f',
+    assistant_id: 'a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d',
+    assistant_name: 'Website Concierge',
+    visitor_id: 'v_9f8e7d6c',
+    contact_name: 'Jane Doe',
+    contact_email: 'jane.doe@example.com',
+    message_count: 8,
+    transcript:
+      'Visitor: Do you carry CPAP supplies?\nAssistant: Yes — we stock masks, tubing and filters...',
+    summary: 'Visitor asked about CPAP supplies and store hours; provided email for follow-up.',
+    extracted_data: { intent: 'product_inquiry', product: 'CPAP supplies' },
+    started_at: '2026-06-24T15:00:00.000Z',
+    ended_at: '2026-06-24T15:03:40.000Z',
+    status: 'completed',
+  },
+  async onEnable(context) {
+    const res = await httpClient.sendRequest<{ id: string }>({
+      method: HttpMethod.POST,
+      url: `${BELLVOX_API}/ap-credentials?action=register-webhook`,
+      headers: { 'x-bellvox-key': authKey(context.auth) },
+      body: {
+        event: 'chat_completed',
+        webhook_url: context.webhookUrl,
+        flow_name: 'Chat Completed',
+      },
+    });
+    await context.store.put('_bellvox_flow_id', res.body.id);
+  },
+  async onDisable(context) {
+    const id = await context.store.get<string>('_bellvox_flow_id');
+    if (id) {
+      await httpClient.sendRequest({
+        method: HttpMethod.POST,
+        url: `${BELLVOX_API}/ap-credentials?action=unregister-webhook&id=${encodeURIComponent(id)}`,
+        headers: { 'x-bellvox-key': authKey(context.auth) },
+      });
+    }
+  },
+  async run(context) {
+    return [context.payload.body];
+  },
+});