> 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.