Migration guide · Zendesk to Pengo

Switch from Zendesk, keep what your team knows

Connect Zendesk with an API token and Pengo Intelligence learns from your solved tickets and help center articles directly. Bring your users over as a CSV, swap one snippet, and your team is answering chats in Pengo the same day.

A day for most teamsKeep your old widget until you swapFree forever plan

Animation: moving Kettlewell Outdoor from Zendesk to Pengo. Contacts and conversations come out of Zendesk, into Pengo through Settings, Workspace, Import. Pengo Intelligence drafts an answer from the old chats for the team to approve, and the widget goes live with one snippet swap.

  1. How it works
  2. How it works
  3. How it works
  4. How it works

How do I switch from Zendesk to Pengo?

Connect Zendesk in Pengo with an agent’s email and API token, so Pengo Intelligence reads your help center and the public replies on your solved tickets, with no export file. Then upload your users as a CSV with Generic CSV / JSON in Settings → Workspace → Import, and replace the Zendesk web widget with Pengo’s snippet.

Time
A day, most of it waiting on exports
Help center
Read through the Zendesk connection
Solved tickets
Read directly to train the AI
Users
CSV, through Generic CSV / JSON
01 Export

What to take out of Zendesk

Each file goes into Pengo through Generic CSV / JSON, which reads Zendesk’s column names as they are.

  1. 01

    Create a Zendesk API token

    In Zendesk, open Admin Center → Apps and integrations → Zendesk API and add a token. Paste it into Pengo with an agent’s email, and Pengo reads your help center and solved tickets directly.

  2. 02

    Turn on data exports

    Zendesk exports are not enabled by default: the account owner asks Zendesk Support to switch them on. On Team plans the export tools are not available, so users come out through the Zendesk REST API instead.

  3. 03

    Export your users

    With exports on, go to Admin Center → Account → Tools → Reports and export users as CSV. Upload the file to Generic CSV / JSON in Pengo; name, email, phone and company are matched for you.

  4. 04

    Export tickets for your records (optional)

    A ticket CSV leaves out comments and descriptions; the JSON export includes comments unless a ticket is over 1 MB. Pengo Intelligence does not need either file, because it reads your tickets through the connection.

02 Mapping

Where everything lands in Pengo

Help center articles Pengo Intelligence knowledge, read through the Zendesk connection
Solved and closed tickets Suggested answers Pengo Intelligence drafts from the public replies, for you to approve; internal notes are never read
Users (CSV) Pengo contacts through Generic CSV / JSON, with extra columns kept as custom attributes
Macros Saved replies, with variables like the customer’s first name
Agents Pengo seats (5 included on Growth), with viewers free
Groups and triggers Teams and routing rules (round robin, least busy, by team)
SLA policies SLA targets for first reply, next reply and resolution, per priority
Brands Websites in one workspace (3 on Growth), each with its own widget and AI knowledge
Web widget The Pengo widget, one snippet on every page

Imports run in Settings → Workspace → Import, one website at a time.

03 Learn from past chats

Pengo Intelligence reads your Zendesk tickets directly

Connect Zendesk and Pengo reads your solved and closed tickets from the last 6 months (up to 24 if you choose), using only public comments: the requester’s are the customer’s, everyone else’s your team’s, and internal notes are never read. It drafts answers from your best replies for you to approve. Starter reads up to 500 conversations an import, Growth 2,000 and Scale 10,000.

  1. Connect Zendesk

    Pengo reads your past Zendesk conversations directly.

  2. Pengo drafts the answers

    It finds the questions your team answers again and again and writes each answer from your best replies.

  3. You approve, it learns

    Approve, edit or skip each draft. Only what you approve trains Pengo Intelligence.

04 How long it takes

A day, start to finish

  1. First 15 minutes

    Create your Pengo workspace, add a Zendesk API token and connect your help center.

  2. First hour

    Pengo learns from your solved tickets and drafts answers. Approve the ones that sound like your team.

  3. Once exports are on

    Export users as CSV, upload them, invite your team and recreate your top macros as saved replies.

  4. Same day

    Set up routing and SLA targets, test Pengo on a staging page, then replace the Zendesk widget snippet.

05 Go live

Your go-live checklist

  1. 1 Create your Pengo workspace and copy your property ID.
  2. 2 Paste the snippet before </body> on every page, or use the WordPress, Shopify, Webflow or Google Tag Manager guide.
  3. 3 Set your widget colors, welcome message and office hours in the widget studio.
  4. 4 Invite your team: 5 seats are included on Growth and viewers are free.
  5. 5 Add your website and help center as knowledge sources, then run the readiness check.
  6. 6 Connect email, and Slack for alerts, so nothing waits on a browser tab.

Paste before </body> on every page.

<!-- Pengo -->
<script>
  (function () {
    window.pengo = window.pengo || function () { (window.pengo.q = window.pengo.q || []).push(arguments); };
    window.pengo.propertyId = 'YOUR_PROPERTY_ID';
    var s = document.createElement('script');
    s.async = true;
    s.src = 'https://app.pengo.chat/embed.js?v=2';
    document.head.appendChild(s);
  })();
</script>

Using WordPress, Shopify, Webflow or GTM? Platform install guides →

Ready to move from Zendesk?

Start free, set Pengo up on a staging page, and swap the snippet when you are ready.

06 Questions

Switching from Zendesk: your questions

Do I need Zendesk Support to enable exports before I switch?
Only for the users CSV. Pengo Intelligence reads your help center and solved tickets through the API token connection, so the AI starts learning straight away. If you are on a Zendesk Team plan, pull users with the REST API instead.
Does Pengo read internal notes on my Zendesk tickets?
No. Pengo reads only the public comments on solved and closed tickets. The token is stored sealed, Pengo never writes to Zendesk, and you can disconnect it at any time.
How long does the move from Zendesk take?
Most teams are answering in Pengo within a day. The AI connection and widget take minutes; the longest step is usually waiting for Zendesk to switch on exports for the users CSV.
What happens to my Zendesk triggers and SLA policies?
Recreate them as Pengo routing rules and SLA targets. Routing assigns by round robin, least busy or team, and SLA targets cover first reply, next reply and resolution per priority, which is usually a short list once tickets become conversations.

Bring your Zendesk history to Pengo

Install in five minutes. Your AI agent is answering before your coffee cools.

Free plan forever · 14-day Growth trial · Cancel anytime

Start free