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

# Zendesk Integration

> Connect BuildBetter with Zendesk to ingest and analyze data for product insights and enhanced support

Ingest all data from Zendesk platform and have it searchable and accessible to BuildBetter chat and documents.

Run signals over this data to get product insights, such as feature requests, bugs, issues, and complaints.

Use those signals or the raw data to generate reports or run workflows over them. This is great for support, customer success, and product teams.

The setup is pretty simple. All of them require a BuildBetter account and a plan that allows the specific integration. They are enabled for all organizations. Requires a Zendesk workspace with API credentials and access.

## Setup Guide

1. Navigate to [https://app.buildbetter.app/settings/org/integrations](https://app.buildbetter.app/settings/org/integrations)
2. Scroll to **Zendesk** integration.
3. Enter your Zendesk API key.
4. Configure shareability and settings (see screenshot).
5. Click **Connect**.

## Bulk Ingestion

<Callout type="info" emoji="🚀">
  **Bulk Ingestion**
  Bring in all past Zendesk tickets into BuildBetter for complete insights:

  * **Retroactive Import**: Import historical tickets up until today.
  * **Bulk API Import**: Use our GraphQL API to upload large datasets.

  Contact [support@buildbetter.app](mailto:support@buildbetter.app) to arrange your bulk ingestion.
</Callout>

## Settings & Options

<AccordionGroup>
  <Accordion title="Fetch conversations on close">
    Get the conversations when the conversation is closed in Zendesk.
    **Default**: Enabled
  </Accordion>

  <Accordion title="Fetch conversations on tag creation">
    Get the conversations when a tag selected is attached to a message in your conversation.
    **Default**: Disabled
  </Accordion>

  <Accordion title="Update open conversations every X days">
    Setting the days to 0 will stop the automatic update on reopened conversations or open conversations with selected tags.
    **Default**: 0 days
  </Accordion>
</AccordionGroup>