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

# Kustomer

> Ingest Kustomer Conversations

<Frame>
  <img src="https://mintcdn.com/montereyai/tK6qGM7BVTTtFhts/kustomer.png?fit=max&auto=format&n=tK6qGM7BVTTtFhts&q=85&s=090445539a5165bb3b5fbe0758e07b38" style={{ width:"100%" }} width="3168" height="792" data-path="kustomer.png" />
</Frame>

### Overview

Kustomer is a customer service platform that helps businesses deliver exceptional customer service. By connecting Reforge Insights with Kustomer, you can go deeper, getting the insights your teams need to provide better service, support, and product.

### Requirements

* You will require a Kustomer account on the Professional, Business, Enterprise, or Ultimate plan levels.
* You will need a user in Kustomer with admin permissions.

### Get Started

First, you will need to generate an API key in Kustomer.com.

<Steps>
  <Step title="Go to &#x22;Settings&#x22;" />

  <Step title="Click &#x22;Security&#x22; in the navigation menu" />

  <Step title="Click &#x22;API Keys&#x22;" />

  <Step title="Click &#x22;Add API Key&#x22;" />

  <Step title="Enter &#x22;Reforge Insights&#x22; for the &#x22;Name&#x22; attribute" />

  <Step title="Apply the following roles for the API Key: `org.permission.conversation.read`, `org.permission.message.read`, `org.permission.customer.read`, and `org.permission.tag.read`." />

  <Step title="Click &#x22;Create&#x22;" />

  <Step title="Copy the generated &#x22;Token&#x22; value and save for later." />
</Steps>

Now that you have an API key, you can find the Kustomer integration in Reforge Insights at **[integration settings page](https://insights.reforge.com/w/default/settings/integrations/kustomer)**.
Note that the link will take you to the first workspace you have access to, so you may need to change it using the Workspace selector at the top left of the screen.

<Steps>
  <Step title="Go to &#x22;Settings&#x22;" />

  <Step title="Click &#x22;Integrations&#x22; in the navigation menu" />

  <Step title="Click &#x22;Kustomer&#x22;" />

  <Step title="Pase the API Key that you created in Kustomer" />

  <Step title="Click &#x22;Save&#x22; and the system will validate the API key and confirm it has necessary roles." />

  <Step title="Once confirmed, you will be returned to Reforge Insights, where you can toggle on ticket ingestion" />

  <Step title="[Optional] You can also enable each comment on the Kustomer tickets to be ingested" />
</Steps>

### Data Collected

Once Reforge Insights and Kustomer are connected successfully, new conversations will be pulled in periodically. The first time Reforge Insights loads data, it will look back 1 week. After that, it will ingest all new data up to your plan's feedback volume limit.

Each conversation and associated messages that is accessible will be ingested.

The following data attributes are loaded from Kustomer and utilized in Reforge Insights for analysis:

* Conversation Messages
  * ID
  * Created Time
  * Updated Time
  * Description (text, "preview" attribute)
  * Status
  * Channel
  * App
  * Direction
* Customers
  * ID
  * Created Time
  * Updated Time
  * Name (or display name attribute)
  * Email
  * External ID
  * Locale
  * Gender
  * Verified
  * Timezone
  * Rev

### Pricing Volume Impact

| Entity Type  | Volume Impact |
| :----------- | :-----------: |
| Conversation |     **1x**    |

<Info>
  View the [pricing page](/pricing/volume-calculation) for more information on how we calculate volume usage.
</Info>