Using Zendesk Support APIs to Automate Lead Conversion Workflow

Introduction / Problem statement
You receive support tickets from prospects and want to turn those into leads automatically in Sell. Using the Zendesk Support API, you can build integrations that convert certain tickets into leads or deals. This article walks you through a basic workflow and example code.

Steps / Example Implementation

1. Define your trigger condition

   • For example: when ticket tag = prospect and status changes to “solved”.

2. Create a Support webhook / trigger

   • In Zendesk Support, go to Admin → Business Rules → Triggers.

   • Create a new Trigger: Condition “Ticket: Tags includes prospect” + “Ticket: Status is Changed to Solved.”

   • Action: call a webhook to your integration endpoint, passing ticket data (e.g. requester, subject, custom fields).

3. Implement the API integration endpoint

   • In your server (e.g. Node.js / Python), capture the webhook payload.

   • Use Zendesk Sell Contacts API to:
     a. Check if a contact exists for the requester email
     b. If not, create a new contact
     c. Create a new deal record if needed, or update existing one

4. Error handling and idempotency

   • Use unique identifiers and timestamps to prevent duplicate leads.

   • Log API failures and implement retries or alerts.

Best practices / reminders

• Always validate incoming webhook payloads (e.g. signature verification).

• Rate-limit your API calls to respect Zendesk quotas.

• Keep your integration idempotent to handle retries gracefully.