Integration

Ringba

Connect Ringba call tracking and routing data to approved phone workflows.

Description

AIM AI can be configured to work with selected Ringba campaigns, calls, targets, numbers, and conversion events. Account boundaries and exact write permissions are confirmed before implementation.

Authentication

A Ringba API token is required.
Exact account access and approved actions are confirmed during workflow scoping.

Supported Actions (9)

These are the operations this integration can perform after the required credentials and permissions are approved.

List/get/update campaigns
Get/annotate calls
Get account info
Manage targets (get/create)
Manage numbers (create/get/delete)
Work with webhooks (list, get, create conversion)
Query call logs (columns, tags, detail, export)
Blacklist numbers
Raw API requests

Examples

Use these representative payloads as a technical starting point, then replace the sample values with the approved workflow data.

Ringba - Get Account Info

Representative workflow configuration for Ringba - Get Account Info.

JSON

{
  "automationType": "ringba",
  "nodeId": "ringba-get-account-info-001",
  "nodeParams": {
    "action": "get_account_info",
    "params": {
      "apiToken": "RINGBA_API_TOKEN"
    }
  }
}

Ringba - Update Campaign

Representative workflow configuration for Ringba - Update Campaign.

JSON

{
  "automationType": "ringba",
  "nodeId": "ringba-campaigns-update-001",
  "nodeParams": {
    "action": "campaigns_update",
    "params": {
      "apiToken": "RINGBA_API_TOKEN",
      "accountId": "YOUR_ACCOUNT_ID",
      "campaignId": "CAMPAIGN_ID",
      "body": {
        "userCampaignId": "API Demo Campaign"
      }
    }
  }
}

Ringba - Get Target

Representative workflow configuration for Ringba - Get Target.

JSON

{
  "automationType": "ringba",
  "nodeId": "ringba-targets-get-001",
  "nodeParams": {
    "action": "targets_get",
    "params": {
      "apiToken": "RINGBA_API_TOKEN",
      "accountId": "YOUR_ACCOUNT_ID",
      "targetId": "TARGET_ID"
    }
  }
}

Ringba - Get Number

Representative workflow configuration for Ringba - Get Number.

JSON

{
  "automationType": "ringba",
  "nodeId": "ringba-numbers-get-001",
  "nodeParams": {
    "action": "numbers_get",
    "params": {
      "apiToken": "RINGBA_API_TOKEN",
      "accountId": "YOUR_ACCOUNT_ID",
      "numberId": "NUMBER_ID"
    }
  }
}

Ringba - Get Single Webhook

Representative workflow configuration for Ringba - Get Single Webhook.

JSON

{
  "automationType": "ringba",
  "nodeId": "ringba-webhook-get-001",
  "nodeParams": {
    "action": "webhook_get",
    "params": {
      "apiToken": "RINGBA_API_TOKEN",
      "accountId": "YOUR_ACCOUNT_ID",
      "webHookId": "WHxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    }
  }
}

Ringba - Call Logs: Tags

Representative workflow configuration for Ringba - Call Logs: Tags.

JSON

{
  "automationType": "ringba",
  "nodeId": "ringba-calllogs-tags-001",
  "nodeParams": {
    "action": "calllogs_tags",
    "params": {
      "apiToken": "RINGBA_API_TOKEN",
      "accountId": "YOUR_ACCOUNT_ID"
    }
  }
}

Ringba - Call Logs: Export CSV (Create Job)

Representative workflow configuration for Ringba - Call Logs: Export CSV (Create Job).

JSON

{
  "automationType": "ringba",
  "nodeId": "ringba-calllogs-export-001",
  "nodeParams": {
    "action": "calllogs_export_csv",
    "params": {
      "apiToken": "RINGBA_API_TOKEN",
      "accountId": "YOUR_ACCOUNT_ID",
      "body": {
        "reportStart": "2025-01-01T00:00:00Z",
        "reportEnd": "2025-01-02T00:00:00Z"
      }
    }
  }
}

Ringba - Raw Request

Representative workflow configuration for Ringba - Raw Request.

JSON

{
  "automationType": "ringba",
  "nodeId": "ringba-raw-request-001",
  "nodeParams": {
    "action": "raw_request",
    "params": {
      "apiToken": "RINGBA_API_TOKEN",
      "accountId": "YOUR_ACCOUNT_ID",
      "method": "GET",
      "path": "/v2/YOUR_ACCOUNT_ID/campaigns"
    }
  }
}