> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/bots/website-mobile-app-bot/3rd-party-integrations/botpenguin-integrations/integrate-botpenguin-with-zendesk-crm.md).

# Integrate BotPenguin with Zendesk CRM

{% embed url="<https://youtu.be/n_OF6nYW5_w?feature=shared>" %}

***

### What is Zendesk Integration?

Zendesk Integration is a third-party connection inside BotPenguin that automatically pushes chatbot conversation data to Zendesk as support tickets. The moment a user finishes a chat flow, their details — name, email, and any other captured information — get stored as a ticket in Zendesk without any manual effort.

***

### When Should You Use This?

* You want to automatically send chatbot leads to Zendesk as support tickets the moment a user completes a conversation.
* You need your support team to follow up on chatbot inquiries without switching between tools.
* You are trying to centralize all customer data captured by your website bot into one ticketing system.

***

### Expected Outcome

After setting this up:

* Every user who completes the chatbot flow will appear as a new ticket in Zendesk.
* The support team will receive lead details (name, email, phone, etc.) automatically.
* You will no longer need to manually transfer leads to Zendesk.

***

### How to Use Zendesk Integration

> ⚠️ **Prerequisites:** An active Zendesk account, and a chat flow for the bot in BotPenguin that collects the user details you want to send (e.g. name, email, phone).

***

#### Part A: Set Up Your Chat Flow in BotPenguin

1. From the left sidebar, click **Chatbot → Chat Flows**. Select the flow you want to connect to Zendesk and choose your website bot from the dropdown.

<figure><img src="/files/mBmFfYY1GvtrMEnCy3It" alt=""><figcaption></figcaption></figure>

2. Enable the **Default Flow** and **Revisit Flow** toggles for the selected flow so it activates when a user lands on your bot.

<figure><img src="/files/LEQsRVmvoByMzziZSEdx" alt=""><figcaption></figcaption></figure>

3. Ensure the flow contains questions that capture user details (e.g. name, email, phone number).

<figure><img src="/files/S4OM4rlxnX0Fs6U2XNd0" alt=""><figcaption></figcaption></figure>

***

#### Part B: Connect Zendesk in BotPenguin

4. From the left sidebar under **Chatbot**, click **Third Party Integration**.

<figure><img src="/files/XiuQ3QZINXOhyUijEic7" alt=""><figcaption></figcaption></figure>

5. In the search bar, type **Zendesk** and click **Connect** next to the result.

<figure><img src="/files/n92jIAhz5bGfk5gJU86I" alt=""><figcaption></figcaption></figure>

6. On the Zendesk integration detail page, click **Connect** to begin the setup.

<figure><img src="/files/U1mTKyqAsyU8emkChhXt" alt=""><figcaption></figcaption></figure>

***

#### Part C: Generate Your API Token in Zendesk

7. Log in to your Zendesk account.

<figure><img src="/files/uiNuoAsEPOpcB6cdYi5C" alt=""><figcaption></figcaption></figure>

8. Click the **Support** dropdown at the top left and select **Admin Center**.

<figure><img src="/files/oY7vuazk9d7RAz8XjkGc" alt=""><figcaption></figcaption></figure>

9. In Admin Center, navigate to **Apps and Integrations → APIs → API Tokens**. If you see an **"API token access is off"** warning, click **View token access configuration**.

<figure><img src="/files/n2b3dt7wvcBXDFBA1a40" alt=""><figcaption></figcaption></figure>

10. On the **API Configuration** page, check the **Allow API token access** checkbox and click **Save**.

<figure><img src="/files/XGSByoJZmX9lou3AMniG" alt=""><figcaption></figcaption></figure>

11. Go back to **API Tokens** and click **Add API Token**. Enter a description (e.g. "BotPenguin Integration") and click **Save**.

<figure><img src="/files/s2ODWN2uT6K3BeOGlfhF" alt=""><figcaption></figcaption></figure>

12. The token will be generated. Click **Copy** to copy it immediately.

> ⚠️ **Important:** Copy and store this token as soon as it is generated. Zendesk will not display it again after you leave this page.

<figure><img src="/files/wMXihmgH1BMs2SL3Z6vn" alt=""><figcaption></figcaption></figure>

***

#### Part D: Map Fields and Save in BotPenguin

13. Back on the Zendesk integration page in BotPenguin, map your chatbot questions to Zendesk parameters using the **Question** mapping fields. Click **+ Add Parameters** to map additional fields.

* Example: **"What is your email?"** → **Email**
* Example: **"Please provide your name"** → **Name**

<figure><img src="/files/mi4KjOroGw5XZpx4dvD4" alt=""><figcaption></figcaption></figure>

14. Click **Save** to complete the integration.

<figure><img src="/files/BTJW9coNaTi634ceXM0w" alt=""><figcaption></figcaption></figure>

***

#### Part E: Test the Integration

15. From the left sidebar, click **Install Your Chatbot**.

<figure><img src="/files/86rbR4jQQ2BFCVrwpwH7" alt=""><figcaption></figcaption></figure>

16. Select the **Landing Page Bot** tab and click **Test** to open the chatbot.

<figure><img src="/files/wNxHlJ0OfP7bDz7Gnk9u" alt=""><figcaption></figcaption></figure>

17. Complete the conversation as a user would — enter your name, email, and any other details the flow collects.
18. Open your Zendesk dashboard and check **Tickets** — the lead will appear as a new ticket with all details from the chatbot conversation.

<figure><img src="/files/PwYiIUeI8Tsuar1E06gy" alt=""><figcaption></figcaption></figure>

***

### Best Practices

1. Map at minimum **Email** and **Name** fields so Zendesk tickets have enough context for your team to act on immediately.
2. Copy and store your Zendesk API token right after generating it — it cannot be retrieved once you leave the page.
3. Always run a test conversation after saving the integration before pointing real users to the bot.
4. Use a clear token description (e.g. "BotPenguin Integration") so you can identify and manage it easily inside Zendesk Admin Center.

***

### Troubleshooting

<details>

<summary>The chatbot conversation is completing but no ticket is appearing in Zendesk.</summary>

Confirm the **Default Flow** toggle is ON for your selected chat flow, and that the integration is saved with at least one field mapped (e.g. Email). If the toggles and mapping are correct, re-save the integration and run a fresh test.

</details>

<details>

<summary>I see an "API token access is off" warning in Zendesk.</summary>

Go to **Admin Center → Apps and Integrations → APIs → API Configuration**, check **Allow API token access**, and click **Save** before generating your token.

</details>

<details>

<summary>I lost my Zendesk API token before copying it.</summary>

Zendesk does not allow re-displaying a generated token. Go to **Admin Center → API Tokens**, delete the old token, click **Add API Token** to generate a new one, and update the connection in BotPenguin with the new token.

</details>

<details>

<summary>The Zendesk ticket is created but the name or email fields are empty.</summary>

Check that you have mapped the correct chatbot questions to the right Zendesk parameters in the **Question Mapping** section. Re-save the integration after correcting the mapping and run a test conversation.

</details>

***

### FAQs

<details>

<summary>What is Zendesk Integration in BotPenguin?</summary>

It connects your BotPenguin chatbot to Zendesk so that every completed conversation is automatically sent to Zendesk as a support ticket — no manual work required.

</details>

<details>

<summary>Which BotPenguin plan supports Zendesk Integration?</summary>

Zendesk Integration is currently supported on the **Little**, **King**, and **Emperor** plans.

</details>

<details>

<summary>Do I need a Zendesk account to use this?</summary>

Yes. You need an active Zendesk account with Admin Center access to generate the API token required for the connection.

</details>

<details>

<summary>Which chatbot platforms support Zendesk Integration?</summary>

Zendesk Integration is currently available for the **Website** chatbot in BotPenguin.

</details>

<details>

<summary>What data gets sent to Zendesk?</summary>

Only the data you explicitly map in the integration settings is sent — for example, name, email, or phone number collected during the chatbot conversation. Unmapped fields are not transferred.

</details>

<details>

<summary>Can I map custom chatbot questions to Zendesk?</summary>

Yes. Use the **Custom Attribute** mapping section below the **Question Mapping** area to send additional fields that are not standard Zendesk parameters.

</details>

<details>

<summary>What happens if a user drops off mid-conversation?</summary>

Only completed chatbot flows trigger Zendesk ticket creation. If a user exits before finishing the flow, no ticket is sent to Zendesk.

</details>

<details>

<summary>Can I connect the same Zendesk account to multiple bots?</summary>

Yes. You can use the same Zendesk API token across multiple bots by setting up the integration separately for each bot under **Third Party Integration**.

</details>

<details>

<summary>Is there a way to test if the integration is working before going live?</summary>

Yes. Use the **Test** button under **Install Your Chatbot → Landing Page Bot** to run a live test conversation. Then check your Zendesk tickets to confirm the lead arrived correctly.

</details>

***

If everything is correct and you are still unable to move forward, write to us at <support@botpenguin.com>. We will respond back within 48 business hours.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.botpenguin.com/bots/website-mobile-app-bot/3rd-party-integrations/botpenguin-integrations/integrate-botpenguin-with-zendesk-crm.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.