Automating support ticket creation over the phone can reduce after-hours backlog and keep requests moving without forcing customers into a web form. This article explains how to build an AI support agent that interacts with Zendesk using SignalWire AI Gateway (SWAIG), including creating, updating, and closing tickets, adding comments, and authenticating callers with a support PIN before allowing any ticket operations.

How to provide 24/7 support without breaking the bank

Global organizations, industries requiring around-the-clock service, or anyone looking to expand their customer support coverage can greatly benefit from this integration of SignalWire AI Agents with Zendesk. This code walkthrough demonstrates how to build an AI agent that is always on duty, answering support calls and handling simple tasks outside regular business hours.

The AI agent will be capable of creating, updating, and closing tickets, adding comments, and authenticating users via phone using a support PIN. For more complex queries, the agent queues the ticket for escalation to human agents during business hours.

About SignalWire AI Gateway (SWAIG)

This guide provides a comprehensive walkthrough for implementing an AI agent that uses the SignalWire AI Gateway (SWAIG) to interact with the Zendesk Support API.

SWAIG functions are serverless, declarative functions defined in SignalWire Markup Language (SWML). In this example, SWAIG functions map to Zendesk API endpoints, performing simple tasks like creating, updating, or closing tickets. They act as connectors between SignalWire's infrastructure and external systems like Zendesk, handling most routine tasks.

Enhancing security with support PINs

In industries like finance, healthcare, or insurance, safeguarding customer data is non-negotiable. This system secures customer interactions using Support PINs, so that only verified users can access or modify sensitive data.

The AI agent prompts callers for their PIN and validates it against Zendesk records before proceeding with any operation. This simple mechanism enhances security and compliance with stringent data protection regulations.

Prerequisites​

• A Zendesk account with admin access

• A free SignalWire account

• Python and basic Python knowledge

View the project and clone it to your development environment to get started.

Step 1: Set up Zendesk API access​

Create an API token​

1. Log in to Zendesk.

2. Navigate to Admin Center > Apps and integrations > Zendesk API > Zendesk API Settings.

3. Enable Token Access.

4. Click Add API Token.

5. Enter a description and click Create.

6. Copy the generated token and store it securely.

Create custom user fields (support PIN)​

1. Navigate to Admin Center > People > Configuration > User Fields.

2. Click Add Field.

3. Configure the field:

   • Type: Text (or Numeric if the PIN is digits only)

   • Title: Support PIN

   • Key: support_pin

4. Save the new custom field.

Step 2: Set up SWML script and SWAIG functions​

1. Navigate to the SWML Scripts pane of the RELAY/SWML tab of your SignalWire Dashboard.

2. Paste the SWML script into the browser SWML editor.

Step 3: Set up your Python environment​

1. Clone the GitHub repository.

2. Install the required Python libraries using pip:

pip install -r requirements.txt

pip install -r requirements.txt

pip install -r requirements.txt

pip install -r requirements.txt

Enter your credentials in the .env file.

• Rename env.example to .env and open it in a text editor.

• Enter your Zendesk subdomain, email, API token, and HTTP basic auth credentials, following the below pattern:

ZENDESK_SUBDOMAIN=Your Zendesk subdomain
ZENDESK_EMAIL=Your Zendesk account email address
ZENDESK_API_TOKEN=Your Zendesk API token
HTTP_USERNAME=Username for HTTP Basic Authentication
HTTP_PASSWORD=Password for HTTP Basic Authentication

Step 4: Implement support PIN authentication​

Generate and assign support PINs​

Use a secure method to generate unique PINs for users.

Example in Python:

import secrets

def generate_support_pin(length=6):
    return ''.join([str(secrets.randbelow(10)) for _ in range(length)])

import secrets

def generate_support_pin(length=6):
    return ''.join([str(secrets.randbelow(10)) for _ in range(length)])

import secrets

def generate_support_pin(length=6):
    return ''.join([str(secrets.randbelow(10)) for _ in range(length)])

import secrets

def generate_support_pin(length=6):
    return ''.join([str(secrets.randbelow(10)) for _ in range(length)])

Assign the PIN to the user during registration or onboarding.

Update the user's profile with the support PIN using the Zendesk API.

API Endpoint: PUT /api/v2/users/{user_id}.json

Python Function:

def update_user_support_pin(user_id, support_pin):
    url = f'https://{ZENDESK_SUBDOMAIN}.zendesk.com/api/v2/users/{user_id}.json'
    data = {
        "user": {
            "user_fields": {
                "support_pin": support_pin
            }
        }
    }
    response = requests.put(
        url,
        json=data,
        auth=HTTPBasicAuth(f'{ZENDESK_EMAIL}/token', ZENDESK_API_TOKEN)
    )
    return response.json()

def update_user_support_pin(user_id, support_pin):
    url = f'https://{ZENDESK_SUBDOMAIN}.zendesk.com/api/v2/users/{user_id}.json'
    data = {
        "user": {
            "user_fields": {
                "support_pin": support_pin
            }
        }
    }
    response = requests.put(
        url,
        json=data,
        auth=HTTPBasicAuth(f'{ZENDESK_EMAIL}/token', ZENDESK_API_TOKEN)
    )
    return response.json()

def update_user_support_pin(user_id, support_pin):
    url = f'https://{ZENDESK_SUBDOMAIN}.zendesk.com/api/v2/users/{user_id}.json'
    data = {
        "user": {
            "user_fields": {
                "support_pin": support_pin
            }
        }
    }
    response = requests.put(
        url,
        json=data,
        auth=HTTPBasicAuth(f'{ZENDESK_EMAIL}/token', ZENDESK_API_TOKEN)
    )
    return response.json()

def update_user_support_pin(user_id, support_pin):
    url = f'https://{ZENDESK_SUBDOMAIN}.zendesk.com/api/v2/users/{user_id}.json'
    data = {
        "user": {
            "user_fields": {
                "support_pin": support_pin
            }
        }
    }
    response = requests.put(
        url,
        json=data,
        auth=HTTPBasicAuth(f'{ZENDESK_EMAIL}/token', ZENDESK_API_TOKEN)
    )
    return response.json()

Step 5: Complete argument mappings​

Ensure all SWAIG function arguments map correctly to Zendesk API parameters.

Example: create_ticket Argument Mapping​

• SWAIG Function Arguments:

  • subject

  • comment_body

  • requester_name

  • requester_email

  • priority

• Zendesk API Payload:

{
  "ticket": {
    "subject": "subject",
    "comment": {
      "body": "comment_body"
    },
    "requester": {
      "name": "requester_name",
      "email": "requester_email"
    },
    "priority": "priority"
  }
}

{
  "ticket": {
    "subject": "subject",
    "comment": {
      "body": "comment_body"
    },
    "requester": {
      "name": "requester_name",
      "email": "requester_email"
    },
    "priority": "priority"
  }
}

{
  "ticket": {
    "subject": "subject",
    "comment": {
      "body": "comment_body"
    },
    "requester": {
      "name": "requester_name",
      "email": "requester_email"
    },
    "priority": "priority"
  }
}

{
  "ticket": {
    "subject": "subject",
    "comment": {
      "body": "comment_body"
    },
    "requester": {
      "name": "requester_name",
      "email": "requester_email"
    },
    "priority": "priority"
  }
}

Example: update_ticket Argument Mapping​

• SWAIG Function Arguments:

  • ticket_id

  • status

  • priority

  • comment_body

  • public

• Zendesk API Payload:

{
  "ticket": {
    "status": "status",
    "priority": "priority",
    "comment": {
      "body": "comment_body",
      "public": "public"
    }
  }
}

{
  "ticket": {
    "status": "status",
    "priority": "priority",
    "comment": {
      "body": "comment_body",
      "public": "public"
    }
  }
}

{
  "ticket": {
    "status": "status",
    "priority": "priority",
    "comment": {
      "body": "comment_body",
      "public": "public"
    }
  }
}

{
  "ticket": {
    "status": "status",
    "priority": "priority",
    "comment": {
      "body": "comment_body",
      "public": "public"
    }
  }
}

Example: close_ticket Argument Mapping​

• SWAIG Function Arguments:

  • ticket_id

• Zendesk API Payload:

{
  "ticket": {
    "status": "closed"
  }
}

{
  "ticket": {
    "status": "closed"
  }
}

{
  "ticket": {
    "status": "closed"
  }
}

{
  "ticket": {
    "status": "closed"
  }
}

Example: add_comment Argument Mapping​

• SWAIG Function Arguments:

  • ticket_id

  • comment_body

  • public

• Zendesk API Payload:

{
  "ticket": {
    "comment": {
      "body": "comment_body",
      "public": "public"
    }
  }
}

{
  "ticket": {
    "comment": {
      "body": "comment_body",
      "public": "public"
    }
  }
}

{
  "ticket": {
    "comment": {
      "body": "comment_body",
      "public": "public"
    }
  }
}

{
  "ticket": {
    "comment": {
      "body": "comment_body",
      "public": "public"
    }
  }
}

Example: get_ticket Argument Mapping​

• SWAIG Function Arguments:

  • ticket_id

• Zendesk API Endpoint: GET /api/v2/tickets/{ticket_id}.json

Example: verify_support_pin Argument Mapping​

• SWAIG Function Arguments:

  • caller_phone_number

  • entered_pin

• Zendesk API Endpoint: GET /api/v2/search.json

Example: get_current_user_tickets Argument Mapping​

• SWAIG Function Arguments:

  • caller_phone_number

  • status

  • priority

• Zendesk API Endpoint: GET /api/v2/users/{user_id}/tickets/requested.json

Code walkthrough

PIN authentication​

SWAIG verifies the caller's support PIN before executing any ticket operations.

Example Workflow:

1. User Calls Support.

2. AI Agent Prompts for PIN.

3. User Enters PIN.

4. SWAIG Calls the verify_support_pin function.

   • If verification succeeds, proceed.

   • If verification fails, handle accordingly.

5. Execute Requested SWAIG Function.

SWAIG functions​

SWAIG functions are defined by the SWAIG method within the SWML script. Each SWAIG function maps to a Zendesk API endpoint. In the below examples, you’ll see the SWAIG definitions. For more complex logic, view the Python functions.

create_ticket​

Opens a new support ticket in Zendesk using the POST /api/v2/tickets.json Zendesk API endpoint:

{
  "name": "create_ticket",
  "description": "Creates a new support ticket in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "subject": {
        "type": "string",
        "description": "The subject or title of the ticket."
      },
      "comment_body": {
        "type": "string",
        "description": "The initial comment or description of the ticket."
      },
      "requester_name": {
        "type": "string",
        "description": "Name of the requester."
      },
      "requester_email": {
        "type": "string",
        "description": "Email of the requester."
      },
      "priority": {
        "type": "string",
        "description": "Priority level of the ticket.",
        "enum": ["low", "normal", "high", "urgent"],
        "nullable": true
      }
    },
    "required": ["subject", "comment_body", "requester_name", "requester_email"]
  }
}

{
  "name": "create_ticket",
  "description": "Creates a new support ticket in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "subject": {
        "type": "string",
        "description": "The subject or title of the ticket."
      },
      "comment_body": {
        "type": "string",
        "description": "The initial comment or description of the ticket."
      },
      "requester_name": {
        "type": "string",
        "description": "Name of the requester."
      },
      "requester_email": {
        "type": "string",
        "description": "Email of the requester."
      },
      "priority": {
        "type": "string",
        "description": "Priority level of the ticket.",
        "enum": ["low", "normal", "high", "urgent"],
        "nullable": true
      }
    },
    "required": ["subject", "comment_body", "requester_name", "requester_email"]
  }
}

{
  "name": "create_ticket",
  "description": "Creates a new support ticket in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "subject": {
        "type": "string",
        "description": "The subject or title of the ticket."
      },
      "comment_body": {
        "type": "string",
        "description": "The initial comment or description of the ticket."
      },
      "requester_name": {
        "type": "string",
        "description": "Name of the requester."
      },
      "requester_email": {
        "type": "string",
        "description": "Email of the requester."
      },
      "priority": {
        "type": "string",
        "description": "Priority level of the ticket.",
        "enum": ["low", "normal", "high", "urgent"],
        "nullable": true
      }
    },
    "required": ["subject", "comment_body", "requester_name", "requester_email"]
  }
}

{
  "name": "create_ticket",
  "description": "Creates a new support ticket in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "subject": {
        "type": "string",
        "description": "The subject or title of the ticket."
      },
      "comment_body": {
        "type": "string",
        "description": "The initial comment or description of the ticket."
      },
      "requester_name": {
        "type": "string",
        "description": "Name of the requester."
      },
      "requester_email": {
        "type": "string",
        "description": "Email of the requester."
      },
      "priority": {
        "type": "string",
        "description": "Priority level of the ticket.",
        "enum": ["low", "normal", "high", "urgent"],
        "nullable": true
      }
    },
    "required": ["subject", "comment_body", "requester_name", "requester_email"]
  }
}

update_ticket​

Updates an existing support ticket in Zendesk using the PUT /api/v2/tickets/{ticket_id}.json Zendesk API endpoint:

{
  "name": "update_ticket",
  "description": "Updates an existing support ticket in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "ticket_id": {
        "type": "integer",
        "description": "The ID of the ticket to update."
      },
      "status": {
        "type": "string",
        "description": "The status to update the ticket to.",
        "enum": ["new", "open", "pending", "hold", "solved", "closed"],
        "nullable": true
      },
      "priority": {
        "type": "string",
        "description": "Priority level of the ticket.",
        "enum": ["low", "normal", "high", "urgent"],
        "nullable": true
      },
      "comment_body": {
        "type": "string",
        "description": "A comment to add to the ticket.",
        "nullable": true
      },
      "public": {
        "type": "boolean",
        "description": "Whether the comment is public (visible to the requester).",
        "default": true,
        "nullable": true
      }
    },
    "required": ["ticket_id"]
  }
}

{
  "name": "update_ticket",
  "description": "Updates an existing support ticket in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "ticket_id": {
        "type": "integer",
        "description": "The ID of the ticket to update."
      },
      "status": {
        "type": "string",
        "description": "The status to update the ticket to.",
        "enum": ["new", "open", "pending", "hold", "solved", "closed"],
        "nullable": true
      },
      "priority": {
        "type": "string",
        "description": "Priority level of the ticket.",
        "enum": ["low", "normal", "high", "urgent"],
        "nullable": true
      },
      "comment_body": {
        "type": "string",
        "description": "A comment to add to the ticket.",
        "nullable": true
      },
      "public": {
        "type": "boolean",
        "description": "Whether the comment is public (visible to the requester).",
        "default": true,
        "nullable": true
      }
    },
    "required": ["ticket_id"]
  }
}

{
  "name": "update_ticket",
  "description": "Updates an existing support ticket in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "ticket_id": {
        "type": "integer",
        "description": "The ID of the ticket to update."
      },
      "status": {
        "type": "string",
        "description": "The status to update the ticket to.",
        "enum": ["new", "open", "pending", "hold", "solved", "closed"],
        "nullable": true
      },
      "priority": {
        "type": "string",
        "description": "Priority level of the ticket.",
        "enum": ["low", "normal", "high", "urgent"],
        "nullable": true
      },
      "comment_body": {
        "type": "string",
        "description": "A comment to add to the ticket.",
        "nullable": true
      },
      "public": {
        "type": "boolean",
        "description": "Whether the comment is public (visible to the requester).",
        "default": true,
        "nullable": true
      }
    },
    "required": ["ticket_id"]
  }
}

{
  "name": "update_ticket",
  "description": "Updates an existing support ticket in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "ticket_id": {
        "type": "integer",
        "description": "The ID of the ticket to update."
      },
      "status": {
        "type": "string",
        "description": "The status to update the ticket to.",
        "enum": ["new", "open", "pending", "hold", "solved", "closed"],
        "nullable": true
      },
      "priority": {
        "type": "string",
        "description": "Priority level of the ticket.",
        "enum": ["low", "normal", "high", "urgent"],
        "nullable": true
      },
      "comment_body": {
        "type": "string",
        "description": "A comment to add to the ticket.",
        "nullable": true
      },
      "public": {
        "type": "boolean",
        "description": "Whether the comment is public (visible to the requester).",
        "default": true,
        "nullable": true
      }
    },
    "required": ["ticket_id"]
  }
}

close_ticket​

Closes a support ticket in Zendesk by updating its status to "closed" using the PUT /api/v2/tickets/{ticket_id}.json Zendesk API endpoint:

{
  "name": "close_ticket",
  "description": "Closes a support ticket in Zendesk by setting its status to 'closed'.",
  "parameters": {
    "type": "object",
    "properties": {
      "ticket_id": {
        "type": "integer",
        "description": "The ID of the ticket to close."
      }
    },
    "required": ["ticket_id"]
  }
}

{
  "name": "close_ticket",
  "description": "Closes a support ticket in Zendesk by setting its status to 'closed'.",
  "parameters": {
    "type": "object",
    "properties": {
      "ticket_id": {
        "type": "integer",
        "description": "The ID of the ticket to close."
      }
    },
    "required": ["ticket_id"]
  }
}

{
  "name": "close_ticket",
  "description": "Closes a support ticket in Zendesk by setting its status to 'closed'.",
  "parameters": {
    "type": "object",
    "properties": {
      "ticket_id": {
        "type": "integer",
        "description": "The ID of the ticket to close."
      }
    },
    "required": ["ticket_id"]
  }
}

{
  "name": "close_ticket",
  "description": "Closes a support ticket in Zendesk by setting its status to 'closed'.",
  "parameters": {
    "type": "object",
    "properties": {
      "ticket_id": {
        "type": "integer",
        "description": "The ID of the ticket to close."
      }
    },
    "required": ["ticket_id"]
  }
}

add_comment​

Adds a comment to an existing support ticket in Zendesk using the PUT /api/v2/tickets/{ticket_id}.json Zendesk API endpoint:

{
  "name": "add_comment",
  "description": "Adds a comment to an existing support ticket in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "ticket_id": {
        "type": "integer",
        "description": "The ID of the ticket to add a comment to."
      },
      "public": {
        "type": "boolean",
        "description": "Whether the comment is public (visible to the requester).",
        "default": true,
        "nullable": true
      }
    },
    "required": ["ticket_id"]
  }
}

{
  "name": "add_comment",
  "description": "Adds a comment to an existing support ticket in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "ticket_id": {
        "type": "integer",
        "description": "The ID of the ticket to add a comment to."
      },
      "public": {
        "type": "boolean",
        "description": "Whether the comment is public (visible to the requester).",
        "default": true,
        "nullable": true
      }
    },
    "required": ["ticket_id"]
  }
}

{
  "name": "add_comment",
  "description": "Adds a comment to an existing support ticket in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "ticket_id": {
        "type": "integer",
        "description": "The ID of the ticket to add a comment to."
      },
      "public": {
        "type": "boolean",
        "description": "Whether the comment is public (visible to the requester).",
        "default": true,
        "nullable": true
      }
    },
    "required": ["ticket_id"]
  }
}

{
  "name": "add_comment",
  "description": "Adds a comment to an existing support ticket in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "ticket_id": {
        "type": "integer",
        "description": "The ID of the ticket to add a comment to."
      },
      "public": {
        "type": "boolean",
        "description": "Whether the comment is public (visible to the requester).",
        "default": true,
        "nullable": true
      }
    },
    "required": ["ticket_id"]
  }
}

get_ticket​

Retrieves information about a specific ticket in Zendesk using the GET /api/v2/tickets/{ticket_id}.json Zendesk API endpoint:

{
  "name": "get_ticket",
  "description": "Retrieves information about a specific ticket in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "ticket_id": {
        "type": "integer",
        "description": "The ID of the ticket to retrieve."
      }
    },
    "required": ["ticket_id"]
  }
}

{
  "name": "get_ticket",
  "description": "Retrieves information about a specific ticket in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "ticket_id": {
        "type": "integer",
        "description": "The ID of the ticket to retrieve."
      }
    },
    "required": ["ticket_id"]
  }
}

{
  "name": "get_ticket",
  "description": "Retrieves information about a specific ticket in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "ticket_id": {
        "type": "integer",
        "description": "The ID of the ticket to retrieve."
      }
    },
    "required": ["ticket_id"]
  }
}

{
  "name": "get_ticket",
  "description": "Retrieves information about a specific ticket in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "ticket_id": {
        "type": "integer",
        "description": "The ID of the ticket to retrieve."
      }
    },
    "required": ["ticket_id"]
  }
}

verify_support_pin​

Verifies the caller's support PIN against the stored PIN in Zendesk using the GET /api/v2/search.json Zendesk API endpoint:

{
  "name": "verify_support_pin",
  "description": "Verifies the caller's support PIN against the stored PIN in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "caller_phone_number": {
        "type": "string",
        "description": "The caller's phone number."
      },
      "entered_pin": {
        "type": "integer",
        "description": "The support PIN entered by the caller."
      }
    },
    "required": ["caller_phone_number", "entered_pin"]
  }
}

{
  "name": "verify_support_pin",
  "description": "Verifies the caller's support PIN against the stored PIN in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "caller_phone_number": {
        "type": "string",
        "description": "The caller's phone number."
      },
      "entered_pin": {
        "type": "integer",
        "description": "The support PIN entered by the caller."
      }
    },
    "required": ["caller_phone_number", "entered_pin"]
  }
}

{
  "name": "verify_support_pin",
  "description": "Verifies the caller's support PIN against the stored PIN in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "caller_phone_number": {
        "type": "string",
        "description": "The caller's phone number."
      },
      "entered_pin": {
        "type": "integer",
        "description": "The support PIN entered by the caller."
      }
    },
    "required": ["caller_phone_number", "entered_pin"]
  }
}

{
  "name": "verify_support_pin",
  "description": "Verifies the caller's support PIN against the stored PIN in Zendesk.",
  "parameters": {
    "type": "object",
    "properties": {
      "caller_phone_number": {
        "type": "string",
        "description": "The caller's phone number."
      },
      "entered_pin": {
        "type": "integer",
        "description": "The support PIN entered by the caller."
      }
    },
    "required": ["caller_phone_number", "entered_pin"]
  }
}

get_current_user_tickets​

Retrieves ticket numbers for the authenticated user using the GET /api/v2/users/{user_id}/tickets/requested.json Zendesk API endpoint:

{
  "name": "get_current_user_tickets",
  "description": "Retrieves ticket numbers for the authenticated user.",
  "parameters": {
    "type": "object",
    "properties": {
      "caller_phone_number": {
        "type": "string",
        "description": "The caller's phone number."
      },
      "status": {
        "type": "string",
        "description": "Filter tickets by status.",
        "enum": ["new", "open", "pending", "hold", "solved", "closed"],
        "nullable": true
      },
      "priority": {
        "type": "string",
        "description": "Filter tickets by priority.",
        "enum": ["low", "normal", "high", "urgent"],
        "nullable": true
      }
    },
    "required": ["caller_phone_number"]
  }
}

{
  "name": "get_current_user_tickets",
  "description": "Retrieves ticket numbers for the authenticated user.",
  "parameters": {
    "type": "object",
    "properties": {
      "caller_phone_number": {
        "type": "string",
        "description": "The caller's phone number."
      },
      "status": {
        "type": "string",
        "description": "Filter tickets by status.",
        "enum": ["new", "open", "pending", "hold", "solved", "closed"],
        "nullable": true
      },
      "priority": {
        "type": "string",
        "description": "Filter tickets by priority.",
        "enum": ["low", "normal", "high", "urgent"],
        "nullable": true
      }
    },
    "required": ["caller_phone_number"]
  }
}

{
  "name": "get_current_user_tickets",
  "description": "Retrieves ticket numbers for the authenticated user.",
  "parameters": {
    "type": "object",
    "properties": {
      "caller_phone_number": {
        "type": "string",
        "description": "The caller's phone number."
      },
      "status": {
        "type": "string",
        "description": "Filter tickets by status.",
        "enum": ["new", "open", "pending", "hold", "solved", "closed"],
        "nullable": true
      },
      "priority": {
        "type": "string",
        "description": "Filter tickets by priority.",
        "enum": ["low", "normal", "high", "urgent"],
        "nullable": true
      }
    },
    "required": ["caller_phone_number"]
  }
}

{
  "name": "get_current_user_tickets",
  "description": "Retrieves ticket numbers for the authenticated user.",
  "parameters": {
    "type": "object",
    "properties": {
      "caller_phone_number": {
        "type": "string",
        "description": "The caller's phone number."
      },
      "status": {
        "type": "string",
        "description": "Filter tickets by status.",
        "enum": ["new", "open", "pending", "hold", "solved", "closed"],
        "nullable": true
      },
      "priority": {
        "type": "string",
        "description": "Filter tickets by priority.",
        "enum": ["low", "normal", "high", "urgent"],
        "nullable": true
      }
    },
    "required": ["caller_phone_number"]
  }
}

Recommendations​ before launching

Begin with a pilot project to test your AI agent’s capabilities in a controlled environment before implementing in a production environment. We recommend that you:

• Test individual functions with mock data

• Have actual users test the system

• Implement error handling to manage and log errors appropriately

• Use environment variables or a secrets manager

• Consider encrypting support PINs

• Adhere to GDPR and other data protection regulations

• Avoid logging sensitive information

By following this guide, you can implement an AI agent that interacts with Zendesk through SWAIG, providing users with the ability to manage support tickets over the phone securely. The integration of support PIN authentication adds an extra layer of security, so that only authorized users can access and modify their tickets.

SignalWire’s infrastructure is designed to support ultra-low latency, meaning your callers will have a smooth conversational experience even under heavy traffic—whether they’re speaking to a human or an AI agent.

If you’re ready to build the future of communications, join our community of developers on Discord!

Frequently asked questions

What is SWAIG and why use it with Zendesk?

SignalWire AI Gateway (SWAIG) lets an AI agent call serverless functions defined in SignalWire Markup Language (SWML). In this integration, those functions map to Zendesk Support API endpoints so the agent can perform ticket operations reliably instead of trying to “type” tickets from freeform conversation.

What can the AI agent do in Zendesk?

The agent can create, update, and close tickets, add comments, and run ticket-related operations after verifying the caller. For complex requests, it can queue the ticket for escalation to a human support team during business hours.

How does support PIN authentication work?

The agent prompts the caller for a support PIN, then a SWAIG function verifies that PIN against Zendesk user records before allowing any ticket creation or updates. This helps prevent unauthorized callers from accessing or changing customer data.

What do I need before I start this tutorial?

You need a Zendesk account with admin access, a SignalWire account, and Python basics. The walkthrough uses a GitHub repo and an .env file with Zendesk credentials such as subdomain, email, and API token.

How do I map SWAIG function arguments to Zendesk fields?

You define SWAIG function arguments in SWML, then map those arguments to the Zendesk payload fields for each endpoint. The guide includes examples for ticket creation and update argument mapping so parameters line up with Zendesk’s expected request format.