> ## Documentation Index
> Fetch the complete documentation index at: https://www.voiceflow.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create and route support requests

> Turn an unresolved customer issue into a support request your team can act on. This walkthrough creates a Zendesk ticket for a damaged order, assigns it to an approved…

Turn an unresolved customer issue into a support request your team can act on. This walkthrough creates a Zendesk ticket for a damaged order, assigns it to an approved support agent and reads it back. Creating the ticket does not issue a replacement or start a live conversation.

## Before you begin

- A test project connected to the intended help desk. For the worked example, complete [Zendesk ticket-tool authorization](/docs/guides/integrations/zendesk/overview#connecting-zendesk). Code users must complete its browser OAuth too.
- A test customer, their confirmed request details and an approved destination in the help desk. The example uses Maya Chen, order **NS-1042** and `support@northstar.example`; replace them with your test account's records.
- A way to retain the returned ticket ID with the verified customer and request. Use an existing saved request for follow-ups instead of creating another ticket.

#### Studio

Open the test project in [Agent studio](https://creator.voiceflow.com). Use a Playbook or Workflow for this support-request task.

#### Developer

Use a [Voiceflow bearer credential](/docs/api-reference/authentication) with access to the test project and Environment. Keep it on your backend or development machine. Set:

```sh
export VF_TOKEN='YOUR_VOICEFLOW_BEARER_TOKEN'
export PROJECT_ID='YOUR_PROJECT_ID'
export ENVIRONMENT='main'
```

Install the current [Voiceflow CLI](/docs/cli/install) if you choose CLI. Both examples below use `VF_TOKEN`. Standalone tool execution uses the Environment's Draft; it does not attach a tool to an agent or publish it.

## Create and route the request

### 1. Confirm what the customer needs

Collect the issue, requested outcome, requester name and contact address. Summarize them and ask for confirmation before creating the request. The example records a cracked mug and a request for replacement; it does not promise eligibility, stock or a delivery date.

#### Studio

Add **Zendesk → Create ticket** to the relevant **Playbook** or **Global tools**. Its Trigger should describe this unresolved request and require confirmation before the write. Supply **subject**, **description**, **requesterName**, **requesterEmail** and **comment**; put the customer issue and requested outcome in the initial comment.

Zendesk Create ticket editor with the Northstar damaged-order inputs — Configure the confirmed request and the initial customer message.

#### Developer

Keep the confirmed values on your backend. Read [the action schema](/docs/guides/integrations/zendesk/overview?view=developer#connecting-zendesk) for your test Environment before executing `zendesk_create_ticket`. The five fields below are required; account-specific custom fields and priority are optional.

### 2. Create one request and retain its ID

#### Studio

Run the agent, describe the damaged order and confirm the summarized request. Inspect the Create ticket tool result. With **Capture response**, select the returned ticket ID from the actual result; have your application retain it with this customer's case.

Check the new ticket in Zendesk. The connector creates status **new**.

#### Developer

#### API

```sh
curl --fail-with-body --silent --show-error \
  --request POST "https://realtime-api.voiceflow.com/v1/stable/integration/zendesk/execute?projectID=$PROJECT_ID&environmentAlias=$ENVIRONMENT" \
  --header "Authorization: Bearer $VF_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
  "toolName": "zendesk_create_ticket",
  "inputs": {
    "subject": "Damaged item — Order NS-1042",
    "description": "A ceramic mug arrived broken.",
    "requesterName": "Maya Chen",
    "requesterEmail": "maya@northstar.example",
    "comment": "Customer confirmed the damage and requested a replacement."
  }
}'
```

#### CLI

```sh
vf --output-format json integration execute --integration zendesk \
  --project-id "$PROJECT_ID" --environment-alias "$ENVIRONMENT" \
  --tool-name zendesk_create_ticket \
  --inputs '{
  "subject": "Damaged item — Order NS-1042",
  "description": "A ceramic mug arrived broken.",
  "requesterName": "Maya Chen",
  "requesterEmail": "maya@northstar.example",
  "comment": "Customer confirmed the damage and requested a replacement."
}'
```

Require `success: true`, `error: null` and `truncated: false` before using `output.data`. An HTTP 200 alone does not establish that the provider action succeeded.

Retain `output.data.id`. The following steps use the illustrative ticket ID `8422`; replace it with the ID returned by your call. Inspect the actual ticket and initial comment in Zendesk.

Do not automatically repeat creation after a timeout or uncertain response. First check whether the ticket was created, or the customer can receive duplicate requests.

### 3. Route the same request and read it back

#### Studio

Add **Zendesk → Update ticket**. Set **ticketID** to the saved ID, **assignee** to a permitted support-agent email and **priority** and **status** if needed. The worked example uses normal priority and pending status. Supply only the fields you intend to change.

Zendesk Update ticket editor for ticket 8422 with an assignee and priority — Route the existing ticket using your account’s approved assignee.

Run the update once, then read the same ticket with **Find ticket** and confirm its assignee and priority in Zendesk.

#### Developer

#### API

```sh
curl --fail-with-body --silent --show-error \
  --request POST "https://realtime-api.voiceflow.com/v1/stable/integration/zendesk/execute?projectID=$PROJECT_ID&environmentAlias=$ENVIRONMENT" \
  --header "Authorization: Bearer $VF_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
  "toolName": "zendesk_update_ticket",
  "inputs": {
    "ticketID": 8422,
    "assignee": "support@northstar.example",
    "priority": "normal",
    "status": "pending"
  }
}'
```

```sh
curl --fail-with-body --silent --show-error \
  --request POST "https://realtime-api.voiceflow.com/v1/stable/integration/zendesk/execute?projectID=$PROJECT_ID&environmentAlias=$ENVIRONMENT" \
  --header "Authorization: Bearer $VF_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
  "toolName": "zendesk_find_ticket",
  "inputs": {
    "ticketID": 8422
  }
}'
```

#### CLI

```sh
vf --output-format json integration execute --integration zendesk \
  --project-id "$PROJECT_ID" --environment-alias "$ENVIRONMENT" \
  --tool-name zendesk_update_ticket \
  --inputs '{
  "ticketID": 8422,
  "assignee": "support@northstar.example",
  "priority": "normal",
  "status": "pending"
}'
```

```sh
vf --output-format json integration execute --integration zendesk \
  --project-id "$PROJECT_ID" --environment-alias "$ENVIRONMENT" \
  --tool-name zendesk_find_ticket \
  --inputs '{
  "ticketID": 8422
}'
```

Require `success: true`, `error: null` and `truncated: false` before using `output.data`. An HTTP 200 alone does not establish that the provider action succeeded.

The first call changes the assignee, priority and status; the second reads the same ticket. Confirm the returned record and the actual destination in Zendesk before saying it has been assigned. A saved assignment is not proof that a person has responded.

## Verify the customer outcome

- Exactly one request exists with the confirmed customer, issue and initial message.
- The saved ticket ID belongs to this customer's request and is available for a later [status check](/docs/guides/integrations/help-desks/check-support-request-status).
- The intended support agent receives the ticket. Give the customer the returned reference without promising a response time you have not established.

#### Studio

Publish the reviewed Environment and repeat the confirmation-first conversation in a fresh customer session.

#### Developer

Code examples execute the actions once. To have the AI perform them, [add and attach the tools, bind their inputs and compile the Draft](/docs/guides/integrations/zendesk/overview?view=developer#connecting-zendesk), then run a confirmation-first conversation. For a published experience, publish that reviewed Environment and repeat in a fresh customer session.

For other providers, use [Gorgias ticket creation](/docs/guides/integrations/gorgias/overview#creating-tickets), [Chatwoot conversation creation](/docs/guides/integrations/chatwoot/overview#creating-conversations) or [Freshchat conversations and routing](/docs/guides/integrations/freshchat/overview#creating-conversations). Use their request types and destination IDs; they are not Zendesk ticket fields.

### The request exists but the destination is wrong

Check the returned ID and account-specific routing field.

Read the same saved request before changing it. Confirm the connected account and that the target assignee or group exists and is permitted there. Fix only the destination field, then read it back. Creating another request does not repair routing. For immediate two-way support, use [Human agent hand-off](/docs/guides/integrations/help-desks/human-agent-handoff).
