-
Notifications
You must be signed in to change notification settings - Fork 10
Add doc: label unhandled AI responses and open a support ticket #656
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
SangeetaMishr
wants to merge
1
commit into
main
Choose a base branch
from
docs/ai-fallback-label-and-ticket
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
43 changes: 43 additions & 0 deletions
43
docs/Use Cases/Label Unhandled AI Responses and Open a Support Ticket.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,43 @@ | ||
| > ### **2 minute read `Advanced`** | ||
| ___ | ||
|
|
||
| **When your AI (Dialogflow, ChatGPT, or another classifier) can't understand a contact's message, you can automatically label it and hand it off to a human agent — all in one place in your flow.** | ||
|
|
||
| ___ | ||
|
|
||
| ## When to use this | ||
|
|
||
| If you're using an AI integration to answer contact questions, there's usually a "fallback" or "default" path in your flow — the branch a contact ends up in when the AI doesn't recognize their message. This is the ideal place to: | ||
|
|
||
| 1. **Label the message** (for example, `AI_unhandled`) so you can track how often the AI fails to understand contacts. | ||
| 2. **Open a support ticket** right away, so a human agent can step in and help. | ||
|
|
||
| Both of these are individual flow actions, documented under **Product Features > Flows > Flow Actions** as `Label the incoming message` and `Open a ticket with a human agent`. This page shows how to chain them together for this specific use case. | ||
|
|
||
| ## Setting it up | ||
|
|
||
| In the branch of your flow where the AI fails to match an intent (the "Other" or default category coming out of your classifier's split node), add two connected nodes: | ||
|
|
||
| 1. **Label the incoming message** — pick this action from the node dropdown, then create (or select) a label such as `AI_unhandled`. Every message that lands here gets tagged with this label, which you can later filter or report on. | ||
|
|
||
|  | ||
|
|
||
| 2. **Open a ticket with a human agent** — connect this node right after the label node by dragging from the red exit circle on the label node. Choose or create a topic (for example, `AI Fallback`) so these tickets are easy to filter in the Support Tickets list, optionally assign a staff member, and write a body describing the issue — you can reference flow results like `@results.result_1` if you saved the contact's message earlier in the flow. | ||
|
|
||
|  | ||
|
|
||
| Once connected, the two nodes run in sequence — the message is labeled, and a ticket opens immediately after, without any extra waiting step in between. | ||
|
|
||
|  | ||
|
|
||
| ## After setup | ||
|
|
||
| - Publish the flow and test it by sending a message the AI won't recognize. | ||
| - Check **Flows > Support tickets** to confirm the ticket was created under the topic you chose, and check **Flows > \[your flow\] > tag** (or search by label) to confirm the message was labeled. | ||
| - A staff member can now find the ticket, open the conversation, and respond to the contact directly. | ||
|
|
||
| ___ | ||
|
|
||
| ## Tags | ||
|
|
||
| AI fallback, Label the incoming message, Open a ticket with a human agent, Support ticket, Unhandled AI response, ChatGPT, Dialogflow. | ||
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win
Add a top-level page heading before the callout.
The file currently begins with a blockquoted
###heading, triggering MD041 and MD022. Add an H1 title and a blank line before the read-time callout.Proposed fix
📝 Committable suggestion
🧰 Tools
🪛 markdownlint-cli2 (0.23.0)
[warning] 1-1: Headings should be surrounded by blank lines
Expected: 1; Actual: 0; Below
(MD022, blanks-around-headings)
[warning] 1-1: First line in a file should be a top-level heading
(MD041, first-line-heading, first-line-h1)
🤖 Prompt for AI Agents
Source: Linters/SAST tools