List Docs with Coda API on New Number Created from Aircall API

Pipedream makes it easy to connect APIs for Coda, Aircall and 2,700+ other apps remarkably fast.

Trigger workflow on

New Number Created from the Aircall API

Next, do this

List Docs with the Coda API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a Aircall trigger and Coda action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Number Created trigger
1. Connect your Aircall account
Configure the List Docs action
1. Connect your Coda account
2. Optional- Select a Doc ID
3. Optional- Configure Workspace
4. Optional- Configure Folder ID
5. Optional- Configure Search Query
6. Optional- Configure Is Owner Docs
7. Optional- Configure Is Published Docs
8. Optional- Configure Is Starred Docs
9. Optional- Configure In Gallery Docs
10. Optional- Configure Max Items
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger#

New Number Created on Aircall

Description:Emit new event when a number is created

Version:0.0.2

Key:aircall-new-number-created

View on GitHub

Aircall Overview#

The Aircall API allows you to harness telephony features within your applications, enabling you to manage calls, contacts, users, and more programmatically. With Pipedream's capability to leverage this API, you can automate call logging, synchronize contact information across platforms, dynamically route calls based on business logic, and generate analytics and reports.

Trigger Code#

import common from "../common/common-webhook.mjs";

export default {
  ...common,
  key: "aircall-new-number-created",
  name: "New Number Created",
  description: "Emit new event when a number is created",
  version: "0.0.2",
  type: "source",
  dedupe: "unique",
  methods: {
    ...common.methods,
    async getHistoricalEvents() {
      // You may implement this if you want historical events for new numbers.
      // It depends on whether Aircall provides historical data for number creations.
      // If not, you can return an empty array or omit this method.
      return [];
    },
    getEventType() {
      return "number.created";
    },
    generateMeta(data) {
      return {
        id: `${data.id}`,
        summary: `New number created: ${data.name} (${data.digits})`,
        ts: data.created_at, // Convert created_at timestamp to a Date object
        additionalData: {
          direct_link: data.direct_link,
          country: data.country,
          time_zone: data.time_zone,
          open: data.open,
          availability_status: data.availability_status,
          is_ivr: data.is_ivr,
          live_recording_activated: data.live_recording_activated,
          users: data.users,
          priority: data.priority,
          messages: data.messages,
        },
      };
    },
  },
};

Trigger Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
Aircall	`aircall`	`app`	This component uses the Aircall app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
N/A	`http`	`$.interface.http`	This component uses `$.interface.http` to generate a unique URL when the component is first instantiated. Each request to the URL will trigger the `run()` method of the component.

Trigger Authentication#

Aircall uses OAuth authentication. When you connect your Aircall account, Pipedream will open a popup window where you can sign into Aircall and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Aircall API.

Pipedream requests the following authorization scopes when you connect your account:

About Aircall#

Call center software for customer-centric teams

Action#

List Docs on Coda

Description:Returns a list of docs accessible by the user. These are returned in the same order as on the docs page: reverse chronological by the latest event relevant to the user (last viewed, edited, or shared). [See docs](https://coda.io/developers/apis/v1#operation/listDocs)

Version:0.0.3

Key:coda-list-docs

View on GitHub

Coda Overview#

The Coda API enables you to interact with your Coda docs for both data retrieval and manipulation. By leveraging this API on Pipedream, you can automate document updates, synchronize data across different platforms, orchestrate complex workflows, and react to changes in real-time. Coda’s tables can act as dynamic databases that interconnect with various services, allowing you to streamline operations that depend on the timely and accurate exchange of information.

Action Code#

import coda from "../../coda.app.mjs";

export default {
  key: "coda-list-docs",
  name: "List Docs",
  description: "Returns a list of docs accessible by the user. These are returned in the same order as on the docs page: reverse chronological by the latest event relevant to the user (last viewed, edited, or shared). [See docs](https://coda.io/developers/apis/v1#operation/listDocs)",
  version: "0.0.3",
  type: "action",
  props: {
    coda,
    docId: {
      propDefinition: [
        coda,
        "docId",
      ],
      description: "Show only docs copied from the specified doc",
      optional: true,
    },
    workspaceId: {
      type: "string",
      label: "Workspace",
      description: "Show only docs belonging to the given workspace",
      optional: true,
    },
    folderId: {
      propDefinition: [
        coda,
        "folderId",
      ],
      description: "Show only docs belonging to the given folder",
    },
    query: {
      propDefinition: [
        coda,
        "query",
      ],
    },
    isOwner: {
      type: "boolean",
      label: "Is Owner Docs",
      description: "Show only docs owned by the user",
      optional: true,
    },
    isPublished: {
      type: "boolean",
      label: "Is Published Docs",
      description: "Show only published docs",
      optional: true,
    },
    isStarred: {
      type: "boolean",
      label: "Is Starred Docs",
      description: "If true, returns docs that are starred. If false, returns docs that are not starred",
      optional: true,
    },
    inGallery: {
      type: "boolean",
      label: "In Gallery Docs",
      description: "Show only docs visible within the gallery",
      optional: true,
    },
    max: {
      propDefinition: [
        coda,
        "max",
      ],
      label: "Max Items",
    },
  },
  async run({ $ }) {
    let params = {
      sourceDoc: this.docId,
      workspaceId: this.workspaceId,
      folderId: this.folderId,
      query: this.query,
      isOwner: this.isOwner,
      isPublished: this.isPublished,
      isStarred: this.isStarred,
      inGallery: this.inGallery,
    };

    let items = [];
    let response;
    do {
      response = await this.coda.listDocs($, params);
      items.push(...response.items);
      params.pageToken = response.nextPageToken;
    } while (params.pageToken && items.length < this.max);

    if (items.length > this.max) items.length = this.max;

    $.export("$summary", `Retrieved ${items.length} doc(s)`);

    return items;
  },
};

Action Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

Label	Prop	Type	Description
Coda	`coda`	`app`	This component uses the Coda app.
Doc ID	`docId`	`string`	Select a value from the drop down menu.
Workspace	`workspaceId`	`string`	Show only docs belonging to the given workspace
Folder ID	`folderId`	`string`	Show only docs belonging to the given folder
Search Query	`query`	`string`	Search term used to filter down results
Is Owner Docs	`isOwner`	`boolean`	Show only docs owned by the user
Is Published Docs	`isPublished`	`boolean`	Show only published docs
Is Starred Docs	`isStarred`	`boolean`	If true, returns docs that are starred. If false, returns docs that are not starred
In Gallery Docs	`inGallery`	`boolean`	Show only docs visible within the gallery
Max Items	`max`	`integer`	Maximum number of results to return in this query

List Docs with Coda API on New Number Created from Aircall API

Pipedream makes it easy to connect APIs for Coda, Aircall and 2,700+ other apps remarkably fast.

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

1-24of2,700+apps by most popular

1
-
24
of
2,700+
apps by most popular