First-party app
WhatConverts

WhatConverts

Read and write call, form, chat and transaction leads from WhatConverts's conversion tracking and attribution platform.

stable MarketingAnalytics & BICustomer Relationship Management

About

WhatConverts ships in the w6w first-party pack. It declares 25 actions, 1 health check, and the host runs its code in a sandbox that never sees the credential.

App id
io.w6w.whatconverts
Version
0.1.0
Author
w6w
Licence
MIT
Categories
Marketing · Analytics & BI · Customer Relationship Management

Overview

WhatConverts tracks phone calls, web form submissions, chats, emails, transactions, appointments, text messages and custom events, attributing every one back to the marketing source, medium, campaign, content and keyword that produced it. WhatConverts calls all of these a “lead” — one resource with a lead_type field, rather than a resource per channel.

This app covers the full lead lifecycle a workflow needs: list and filter leads by type, status, date range, value and more; fetch a single lead’s full attribution and (on Elite plans) its AI-generated lead analysis and customer journey; create leads from another system; and edit a lead’s qualification (quotable) and dollar-value fields. A dedicated action downloads a phone call’s MP3 recording as bytes, for workflows that need the audio itself rather than just its playback URL.

On an agency plan, a Master Account Key additionally unlocks account and profile management (list, create, edit, delete), role and permission lookups, user invitation and access management, and tracking-number/web-form inventory and deletion — the full multi-client surface an agency automates on top of its clients’ lead data.

A health check tracks WhatConverts’s own status page; there is no quota check because the vendor documents its rate limits in prose and confirmed on the wire that no request — success or failure — carries a rate-limit header to read.

Build with WhatConverts

Three routes to the same 25 actions. The Workflow tab is generated from WhatConverts's own manifest and carries its real ids, so it is copy-pasteable; the Code and CLI examples are the same call for any action on any app, so every app-specific value in them is a blank you fill in.

Create Account

account-create

Create a new account. Requires a Master Account (agency) Key.

Delete Account

account-delete

Permanently delete an account, its profiles, numbers, leads and settings. Requires a Master Account (agency) Key. This cannot be undone.

Get Account

account-get

Get details for a single account. Requires a Master Account (agency) Key.

Update Account

account-update

Edit an account's name. Requires a Master Account (agency) Key.

List Accounts

accounts-list

Get a paginated list of accounts. Requires a Master Account (agency) Key.

Create Lead

lead-create

Create a new lead (call, form, chat, email, transaction, event, appointment or text message) in WhatConverts.

Get Lead

lead-get

Get details about a single lead.

Update Lead

lead-update

Edit qualification and value fields for a single lead.

List Leads

leads-list

Get a paginated list of leads — calls, forms, chats, emails, transactions, events, appointments and text messages.

Create Profile

profile-create

Create a new profile under an account. Requires a Master Account (agency) Key.

Delete Profile

profile-delete

Permanently delete a profile, its numbers, leads and settings. Requires a Master Account (agency) Key. This cannot be undone.

Get Profile

profile-get

Get details for a single profile. Requires a Master Account (agency) Key.

Update Profile

profile-update

Edit a profile's name. Requires a Master Account (agency) Key.

List Profiles

profiles-list

Get a paginated list of profiles under an account. Requires a Master Account (agency) Key.

Get Recording

recording-get

Download the MP3 call recording for a lead, base64-encoded.

Get Role

role-get

Get details and permissions for a single role. Requires a Master Account (agency) Key.

List Roles

roles-list

Get a paginated list of roles. Requires a Master Account (agency) Key.

Delete Tracking Form

tracking-form-delete

Permanently delete a tracked web form. This cannot be undone; submission tracking for this form stops immediately.

List Tracking Forms

tracking-forms-list

Get a paginated list of tracked web forms.

Delete Tracking Number

tracking-number-delete

Permanently delete a tracking phone number. This cannot be undone; call tracking for this number stops immediately.

List Tracking Numbers

tracking-numbers-list

Get a paginated list of tracking phone numbers.

Create User

user-create

Invite a new user. Requires a Master Account (agency) Key.

Get User

user-get

Get details for a single user. Requires a Master Account (agency) Key.

Update User

user-update

Edit an existing user's role and account access. Requires a Master Account (agency) Key.

List Users

users-list

Get a paginated list of users. Requires a Master Account (agency) Key.

A workflow step names the app and the action, and the editor fills in the connection when you pick one. This is the Step shape from the workflow spec, carrying WhatConverts's real ids.

{
  "manifestVersion": "2",
  "name": "whatconverts-example",
  "steps": [
    {
      "id": "account-create",
      "uses": {
        "app": "io.w6w.whatconverts",
        "action": "account-create",
        "connection": "conn_YOUR_CONNECTION_ID"
      },
      "with": {
        "accountName": "<accountName>"
      }
    }
  ]
}

Here are some of the things you can do

  • Create Account

    perform
    account-create
  • Get Account

    read
    account-get
  • Update Account

    perform
    account-update
  • List Accounts

    read
    accounts-list
  • Create Lead

    perform
    lead-create

+20 more actions available

Every app-specific value here is a blank you have to fill in. An app action is reached through the connection that authenticates it, so the address is a connection id, not the app id — and connections belong to your account, so a public page cannot know yours. Create one for WhatConverts, then fill in the three blanks: conn_YOUR_CONNECTION_ID, the action key, and the parameters that action declares. The call itself is real — the shape is transcribed from the studio's own snippet builder, which prints the same kind of blanks — but nothing in it is specific to WhatConverts. The Workflow tab is where this app's real ids are.

Install
npm install @w6w/sdk
yarn add @w6w/sdk
pnpm add @w6w/sdk
deno add npm:@w6w/sdk
Code
import { W6wClient, isActionRun } from "@w6w/sdk";

// Reads W6W_BASE_URL and W6W_TOKEN from the environment when omitted.
const client = new W6wClient();

const envelope = await client.run({
  urn: "conn_YOUR_CONNECTION_ID",
  action: "account-create",
  payload: {
    accountName: "<value>",
    // createProfile: "<value>",
  },
});

if (isActionRun(envelope)) console.log(envelope.value);
Install the CLI
npm install -g @w6w/cli
CLI
w6w run conn_YOUR_CONNECTION_ID --action account-create --payload '{"accountName":"<value>"}'

Give an AI agent WhatConverts — without giving it WhatConverts's credentials. One MCP endpoint exposes every app, function and workflow the caller is entitled to, as tools it can discover and run. Access is granted per team while we onboard.

One tool call
{
  "name": "w6w_invoke",
  "arguments": {
    "ref": "app:io.w6w.whatconverts#account-create",
    "input": {
      "accountName": "<accountName>"
    }
  }
}

Every tool names its target with a single ref. The app: form above doesn't name a connection at all — the host resolves which of the caller's WhatConverts connections to sign with, and refuses rather than guesses when the answer is ambiguous.

What the agent gets

Credentials it can't read

The token is attached host-side, at the moment of the call. It is never a tool argument, never in the model's context, and never in a transcript — so a prompt injection has nothing to exfiltrate.

A tool surface scoped to the caller

Tools are derived per end user from what that person has actually connected and is entitled to — not one shared bot identity carrying the union of everyone's access.

A durable workflow in one call

Multi-step work runs on the workflow engine and returns a run handle the agent can poll — retries, branching and state survive the conversation that started them.

Health-aware discovery

WhatConverts's declared health checks are on the surface too, so an agent can tell "the vendor is down" from "your credential expired" before it burns a retry on either.

The MCP surface is part of the hosted platform. WhatConverts itself is MIT, and the runtime that executes it is source-available (FSL).

Request MCP access

Health checks

WhatConverts declares its own checks, so its health is a property of the app rather than something the host guesses at.

service

WhatConverts platform status

Component status from status.whatconverts.com: Dashboard, API, Lead Processing, Call Routing, Website, System Outage and Notification Delivery.