> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adriel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to connect

> How to connect the WhatConverts data source to Adriel: generate an API token and secret, select an account, and import individual lead records.

WhatConverts is a lead and conversion tracking platform that captures calls, form submissions, chats, transactions, and other lead types alongside the source, medium, and campaign that drove them. Connecting it brings individual lead records into Adriel dashboards, each with attributes such as lead type, source, contact details, sales value, call recording, transcription, and spotted keywords available as both metrics and breakdowns.

## Before you connect

The following are required:

* A WhatConverts account in good standing.
* An **API Token** and **API Secret** issued from the WhatConverts account or agency settings. Both are sent together as HTTP Basic auth credentials.
* The WhatConverts account that owns the leads to be imported. Agency-key holders see a list of profile-scoped accounts at connection time.
* Lead tracking already configured in WhatConverts. Only leads recorded by the platform will appear in dashboards.

## Connect WhatConverts

<Steps>
  <Step title="Obtain the WhatConverts API credentials">
    Sign in to the WhatConverts dashboard. Open the account or agency settings and generate or copy the **API Token** and **API Secret** pair.
  </Step>

  <Step title="Select the data source">
    On the **Data Sources** page, search for **WhatConverts** and select it.
  </Step>

  <Step title="Enter the API credentials">
    Enter the **API Token** and **API Secret** into the corresponding fields.
  </Step>

  <Step title="Select the account">
    Choose the **Account** to connect from the list of accounts the credentials can access. Each account becomes a separate data source.
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. The initial sync pulls the last **390 days** of historical lead data and runs in the background; initial data availability can take up to one business day.
  </Step>
</Steps>

## What gets imported

The connector imports individual lead records — one row per lead — including date created and last updated, lead type (phone call, text message, web form, email, chat, appointment, event, transaction, other), lead status and state, source, medium, campaign, and content, sales and quote value, contact and caller details, call duration and status, call recording, call transcription, spotted keywords, profile, tracking and destination numbers, and the spam flag. Country values are normalized to ISO 3166-1 alpha-2 codes during ingestion, and records are deduplicated by lead ID.

For the complete list of metrics, breakdowns, and field semantics, see the [WhatConverts data reference](/data-sources/o-z/whatconverts/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="The connection is disconnected with an 'Invalid credentials' error">
    A WhatConverts HTTP 401 response is mapped to `INVALID_CREDENTIALS` and automatically disconnects the data source. Reconnect via Connections → WhatConverts → Reconnect after regenerating or correcting the API Token and API Secret in WhatConverts.
  </Accordion>

  <Accordion title="Lead recordings show but cannot be played">
    The recording cell renders an audio URL built from the account and lead identifiers. If playback fails, confirm that the call recording exists in WhatConverts itself; only leads with a populated recording produce a playable cell.
  </Accordion>

  <Accordion title="Lead Summary is empty">
    Lead Summary is extracted from the AI summary field on each lead. When the dashboard breakdown is set to **All**, Lead Summary is intentionally returned as empty because it is a per-lead attribute. Switch to a per-lead breakdown to see it.
  </Accordion>

  <Accordion title="Country values do not match the WhatConverts UI">
    The connector normalizes country values to ISO 3166-1 alpha-2 codes (for example, `US`, `KR`, `GB`). Already-valid two-letter uppercase codes pass through unchanged; unrecognized values are returned as-is.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="WhatConverts data reference" href="/data-sources/o-z/whatconverts/data-reference">
    Metrics, breakdowns, field semantics, and limits for WhatConverts.
  </Card>

  <Card title="WhatConverts FAQs" href="/data-sources/o-z/whatconverts/faqs">
    Common questions and expected behaviors for the WhatConverts data source.
  </Card>

  <Card title="How to connect CallRail" href="/data-sources/a-f/callrail/how-to-connect">
    Connect call tracking and lead attribution from CallRail.
  </Card>

  <Card title="How to connect ActiveCampaign" href="/data-sources/a-f/active-campaign/how-to-connect">
    Connect marketing automation and CRM data from ActiveCampaign.
  </Card>
</CardGroup>