The App Builder lets you create Zendesk apps using natural language processing (NLP). With NLP, you can provide instructions in plain language, similar to how you might explain your ideas to a colleague or friend. Generative AI interprets these prompts and generates the necessary code and functionality. With generative AI, building apps is as easy as describing them, eliminating the learning curve associated with traditional coding.
Features of the App Builder include:
- Conversational UI: Describe your desired app using natural language.
- Example prompts: A small collection of prompts to help you get started.
- Iterative app development: Continuously refine and build applications using large language models (LLMs), allowing you to adjust the app to meet your specific requirements.
- Version control: Save different versions of the created app, enabling easy navigation between iterations.
- Real-time visual preview: Preview the app visually in real time as you build, to provide instant validation of how the app will look and function.
- Data integration: Create apps that utilize data from Zendesk, your company's internal systems, and third-party platforms such as Shopify, Jira, and others.
- Code accessibility: Access the generated code for the app and mock data used to generate the app preview, which can be reviewed by more technically skilled admins or developers.
- Testing environment: Test the app within your Zendesk Lotus environment before installation to ensure proper functionality. You can test the app with real production data from your Zendesk account, ensuring that it behaves exactly as expected in a live environment before going live.
- Publishing and deployment: Publish and deploy the app within your Zendesk account, including an app permission flow.
- Error resolution: Use the LLM to fix any unexpected issues.
- Feedback submission: Use the feedback form to report bugs, request features, or share general comments.
- Download conversation: Download the conversation history for reference or further analysis.
Apps created by the App Builder are designed with Zendesk Garden components, and appear in the Zendesk ticket sidebar apps.
Navigating the App Builder interface
In Admin Center, click 
Apps and integrations in the sidebar, then select Apps > App builder. You must be a Zendesk admin to use the App Builder.
If you haven't created an app yet, opening the App Builder takes you to the prompt window, where you can explore several examples. You can use these examples to test App Builder or as a starting point for developing your own app. Clicking an example automatically generates a prompt and starts the app creation process.
For App Builder, apps are what you create and install on your accounts that agents can see and interact with. Conversations are basically talking to the AI back and forth to create an app. You might have conversation where you prompt App Builder, but it fails to create an app. So technically a conversation can exist without producing an app.
Below the examples is a dedicated input section where you can enter your initial prompts.
After you send your initial prompt, a new page appears and lists your conversation on the left side. Here, the LLM interacts with you, providing a detailed description of the app. This overview lets you verify that the App Builder has correctly understood your prompts.
Beneath this overview is a text box where you can make any necessary adjustments. For example, you can say, “Move the Submit button to the bottom left corner of the app” or “Make the Priority field a dropdown menu” to modify the app's layout or functionality.
On the right side of the page is the output, which include:
- A preview tab that offers a live preview of the app.
- A code tab containing the generated code.
- A mock data tab that allows you to view sample the data used in the preview.
At the top, you'll find the following options:
- Feedback: Opens a Google Form in a new browser tab. Answer the questions in the form in as much detail as possible.
- Options menu: Click the three vertical dots to download the conversation as a JSON file or to delete the current app and start a new one.
- Generated app: Select a version from the dropdown menu to preview that specific version.
- Test: Click to view and interact with the app in the apps panel located on the right side of the ticketing interface in Zendesk Support. This testing lets you explore and assess the app's functionality without making any actual updates to the data. It is designed for you to verify that the app operates as intended, ensuring that all features work correctly before deploying it in a live environment.
- Publish: Click to install the app.
Building an app
The App Builder generates React code contained in a single file based on your prompt.
Once you publish an app, App Builder apps are located in the Zendesk Support apps panel, making it accessible for agents and admins.
To begin a new app, click Start a conversation on the App Builder LLM page, which serves as the homepage after you have built your first app.
The App Builder uses NLP to interpret user prompts and convert them into functional app components. To ensure you get the best results from the App Builder, it's important to follow specific guidelines when crafting your prompts. For more information on best practices, see Prompting guidelines for App Builder.
- Build a simple feature and keep refining the app by adding additional prompts that offer more context and detailed requirements. By breaking the development process into several segments, you can more easily troubleshoot and address issues in specific parts of the app before introducing additional complexity.
- If the built app doesn’t work, ask the bot to add logging.
- Read the bot’s response to make sure it understands what you are asking it to build.
- Perform thorough testing of the app before publishing it.
- If you encounter an error while testing your app, copy and paste the error message into the prompt. This allows the LLM to analyze the issue and assist you in debugging the problem.
- If something doesn’t work as expected, provide detailed explanations of what you’re expecting, which parts are functioning correctly, and which parts are not. Avoid simply stating that it doesn’t work.
- Approach the process with patience to better understand how the LLM operates and what steps to take if you’re not achieving the desired results.
Linking to your private company data sources or third-party platforms
The App Builder enables you to create apps that integrate with your private company systems and third-party platforms. While it helps to understand APIs and authentication methods, the App Builder guides you through the process when those inputs are necessary.
Integrating your app with private company systems
To integrate with your private company systems, you need to know the API endpoint URL and the authentication method your company uses for that system. This information can typically be found in your internal documentation or obtained from your internal development teams who manage the system.
For internal integrations, particularly when working with LLMs, you may require more comprehensive authentication information compared to third-party integrations. This could include API keys, OAuth tokens, or other credentials specific to your internal systems. Additionally, you will need to define the input data that the LLM will process, which may consist of user queries, ticket details, or other relevant information that the app will utilize to generate responses.
You should also specify the expected output format, which could include structured data, JSON responses, or specific fields that the app will return after processing the input data.
Once you have gathered all the necessary details, prompt the App Builder to establish the connection. The builder will guide you through the process, asking you to provide the API endpoint, authentication details, and data structure information.
After completing the integration, you can test it in your Zendesk instance by clicking Test. This allows you to verify that the integration functions correctly and meets your requirements before deploying it in a live environment.
Integrating your app with third-party platforms
The App Builder lets you create an application that can display or manipulate data from any third-party applications, such as Jira, Shopify, Slack, and others, as long as those services have public-facing APIs. For example, suppose there is no existing product functionality available, and the current Salesforce marketplace app only provides read-only access that allows users to view information from Salesforce within Zendesk. You can enhance this capability by creating an app that shows contact information from Salesforce. This app would not only display the relevant data but also include a button that lets you update the subscription field with a specific value in Salesforce. After the update is attempted, the app should display a notification to inform you whether the update was successful or if any issues occurred during the process.
Example flow for creating an app
Here is an example flow for creating an app. In this example, we'll track changes in ticket assignees.
- In Admin Center, click Apps and integrations in the sidebar, then select Apps > App builder.
- At the prompt, enter “Create an app called Assignee Change Tracker that tracks changes on an assignee on a given ticket. Make sure to display the names of previous assignees and new assignees. Also display the total number of changes in assignment of the ticket.”
- Click Send.
The LLM responds with something similar to this:
- Review the LLM response, and then click Code and Mock data to view the underlying code and data used to populate this preview. For more information about the code, see Apps in the Zendesk developer docs.
- At the prompt, enter “Add a button to refresh the displayed data to reflect the latest changes. Add another button to export data to Excel. Make both buttons small and next to each other.”
- Click Enter.
The LLM responds with something similar to this:
- At the prompt, enter “Replace the value in the assignee column with the agent name instead of the id.”
- Click Enter.
- Click Test to test the app using your own data. Testing the app does not make any updates to your data.
Your app is now complete and is ready to be published.
Installing and using apps created by the App Builder
When you are satisfied with your app, click Publish in the upper right corner to add it to the apps panel. The builder prompts you to specify who has access to this app. Next, acknowledge the service disclaimer regarding the use of apps created through the App Builder. After you click Agree and Publish, the installation process begins, and App Builder notifies you when your app has been successfully installed.
To modify permissions or manage the app further, click Manage App in the notification within the App Builder page, or select Apps > Zendesk Supported Apps. See Managing your installed apps.
Troubleshooting
The App Builder may encounter errors that require additional context or information to resolve. Some examples of these errors include:
- The app cannot be generated.
- The app cannot be installed.
- Integration with a private company system or third-party platform fails.
- The preview cannot be loaded.
When the App Builder encounters issues, it will attempt to resolve them automatically. If it cannot, it will present you with an error message. Respond to these errors with specific details about what you expected to happen and what did not go as expected. Providing this information helps the LLM better understand the context of the issue, allowing it to analyze the problem more effectively.
For example, if the expected output was a specific data format or a particular response from the app, but the actual output was different, detailing these discrepancies will enable the LLM to identify patterns, troubleshoot effectively, and suggest appropriate solutions. The more precise and detailed the feedback, the better the LLM can learn from the interaction and improve its responses in future scenarios.
In some instances, like fetching or updating data or integrating with third-party apps, the error may not be noticeable until you view the app with live data in your Zendesk instance.
- 401: Unauthorized Error - This indicates that the user does not have the necessary permissions to access the requested resource.
- 403: Forbidden Error - This occurs when a user is logged out of Admin Center after their session expires while the App Builder remains open in their browser. It can also arise from integration failures.
- 404: Not Found Error - This error signifies a broken or incorrect URL, or it may indicate that the requested API path is incorrect or unavailable.
- 503: Service Unavailable Error - This error occurs when the server receives too many requests, causing it to exceed its resource limits. This can also happen if the server is down for maintenance or updates.
Limitations
The following are limitations in the open EAP scheduled for June 2025:
- Real-time updates that allow you to see the app's response while the LLM is processing is not available. The App Builder may take several seconds to respond, depending on the complexity of the prompts given.
- You can create up to 10 conversations in total. An alert will indicate how many conversations you have left to build until you reach this limit.
0 comments