Introduction
When a customer asks to talk to a human, the AI gathers the necessary information and opens a ticket. The Human Handoff feature ensures your customers get connected to your support team seamlessly, collecting the right details and creating support tickets in your helpdesk systemβall within the natural flow of conversation.
This works everywhere your AI is active: on your website chat widget, in Instagram DMs, Facebook Messenger, and WhatsApp. Your customers get the same seamless experience regardless of how they reach you.
Unlike traditional rigid contact forms, this feature understands context from the conversation, asks only necessary questions, and even allows other AI skills to escalate issues when needed.
What Human Handoff Does for Your Business
Smarter Handoffs to Your Team
Automatically captures customer details (email, name, order number) without repetitive questions
Uses conversation context to provide your support team with helpful background information
Creates tickets directly in your helpdesk (Zendesk, Gorgias, Freshdesk, or others)
Reduces friction by making it easy for customers to reach human support
Works Across All Your Channels
Customers on Instagram DM, Facebook Messenger, and WhatsApp get the same support escalation path as website chat visitors
Your existing Contact Support configuration applies automatically to all channels β no extra setup needed
Support tickets from Meta conversations appear in your helpdesk alongside website chat tickets
Seamless Integration with AI Skills
Other AI skills (like Cancel Order or Returns) can invoke Human Handoff when they can't complete a request
Maintains conversation flow when escalating from one skill to another
Provides your support team with context about what the customer was trying to do
Flexible Configuration
Choose which information to collect: email (always required), name, phone number, order number, photos
Set fields as required or optional based on your support process
Customize the acknowledgment message customers see when tickets are created
Set different messages for different times β holidays, weekends, after-hours, and more
Works with your connected helpdesk integration (Gorgias, Zendesk, Freshdesk, etc.)
Tag every handoff ticket with as many of your own tags as your routing and reporting need
Enrich tickets with full customer journey context
How It Works
For Your Customers
Request Support β Customer says "I need help from a person" or an AI skill determines escalation is needed
Smart Information Gathering β AI asks for necessary details, skipping anything already known from the conversation
Ticket Creation β A support ticket is created in your helpdesk with all the context
Confirmation β Customer receives confirmation that their request has been sent to your team
This flow is the same whether the customer is chatting on your website, messaging on Instagram, reaching out through Facebook Messenger, or contacting you on WhatsApp.
Example Flow (Website Chat):
Customer: "I want to cancel part of my order"
AI: "I understand you'd like to cancel part of order #12345. Let me connect you with our support team who can help with partial cancellations. May I have your email to create a support ticket?"
Customer: provides email
AI: "Perfect! I've sent your request to our support team. They'll reach out shortly to help with your order cancellation."
Example Flow (Instagram DM):
Customer sends a DM: "I need to talk to someone about my order"
AI: "I'd be happy to connect you with our support team. Could you share your email so I can create a ticket for you?"
Customer: provides email
AI: "I've forwarded your inquiry to an agent, who will respond within 24 hours."
The customer sees the confirmation right in their DM thread.
For Merchants (You)
Activating Human Handoff:
Navigate to Support Skills in your Rep AI console
Find the Human handoff card
Click Edit settings to open the configuration modal
Configure which information to collect: * Email β Always required (cannot be turned off) * Name β Set as Required or Optional using the dropdown * Phone β Toggle On/Off, set as Required or Optional * Order Number β Toggle On/Off, set as Required or Optional * Photo β Toggle On/Off, set as Required or Optional
Customize Acknowledgment Instructions β This controls what customers see after their ticket is created. You can write a simple message or use time-based conditions (see below). * Default: "I have forwarded your inquiry to an agent, who will respond within 24 hours."
Select your Integration Type (e.g., Gorgias, Zendesk, Freshdesk)
Set the ticket Subject (default: "Contact support")
Add your Tags β type a tag and click Add, or paste a comma-separated list. At least one tag is required. Every tag you add is applied to each handoff ticket, alongside Rep's automatic
repand channel tags. See Tag Every Handoff Ticket the Way Your Team Works below.Toggle "Enrich ticket with customer journey" to include conversation history in tickets
Click Preview to test the experience or Save to activate
These settings apply to all channels automatically β website chat, Instagram DM, Facebook Messenger, and WhatsApp. There's no separate configuration needed for Meta channels.
Modifying Settings:
Return to Support Skills at any time
Click Edit settings on the Human handoff card
Adjust field requirements, acknowledgment instructions, or integration settings
Changes apply immediately to new conversations across all channels
Configuration Options
Information to Collect
Choose which customer details the AI should gather before creating a support ticket:
Email β Always required (this ensures your team can respond)
Name β Required by default, can be set to Optional
Phone β Off by default, toggle On and set as Required or Optional
Order Number β Off by default, toggle On if you want order context (helpful for order-related issues)
Photo β Off by default, toggle On for visual issues like damaged products or fit problems
Pro Tip: Only collect information you actually need. The more fields you require, the more friction customers experience. Start with Email and Name, then add others based on your support team's needs.
Note on Meta channels: On Instagram DM, Facebook Messenger, and WhatsApp there is no upload window β the shopper attaches a photo the way they normally would in the app, and your AI reads it and passes its link along to the support ticket. Because there is no upload step for the shopper to complete, keep Photo set to Optional if your store receives messages on those channels. Set to Required, the AI may keep asking for an upload before it will open the ticket.
Acknowledgment Instructions
Customize the message customers see after the AI creates their support ticket. This is your chance to set expectations and reassure customers.
Default message: "I have forwarded your inquiry to an agent, who will respond within 24 hours."
Customization ideas:
Mention your actual response time
Add a reference number or next steps
Include alternative contact methods for urgent issues
Add a personal touch that matches your brand voice
Set Different Messages for Different Times
You can write conditional instructions that automatically change what customers see based on the current date, day of the week, or time of day. This is perfect for holidays, weekends, seasonal hours, or any situation where your support availability changes.
Instead of manually updating your acknowledgment message before every holiday or schedule change, simply write your conditions once and the AI handles the rest.
How it works: Write your instructions using natural "If... say..." language. The AI reads the current date and time and picks the right message automatically.
Important: For any time-of-day conditions, always include your timezone (e.g., "9am-5pm ET"). Examples
Holiday message:
If it's December 24, 25, or 26, say: "π Merry Christmas! Our support team is enjoying the holidays. Response times may be longer than usual. Thanks for your patience!" Otherwise, say: "Thanks for reaching out! We'll be in touch within 24 hours on business days. If you close this chat, we'll reach you via email."
Business hours (with timezone):
If it's Monday-Friday between 9am and 5pm ET, say: "Thanks for reaching out! We'll respond within 2 hours during business hours." If it's after 5pm ET on weekdays or anytime on weekends, say: "Thanks for your message! Our team is currently offline. We'll get back to you on the next business day."
Multiple holidays:
If it's December 24-26, say: "π Merry Christmas! Response times may be longer during the holidays." If it's December 31 or January 1, say: "π Happy New Year! We'll respond as soon as we're back." Otherwise, say: "Thanks for reaching out! We'll be in touch within 24 hours."
Seasonal hours:
If it's June 1 through August 31 and between 10am-4pm PT, say: "Summer hours: Our team works 10am-4pm PT. We'll respond shortly!" Otherwise, say: "Thanks! We'll respond within 24 hours on business days."
Tips for Writing Conditional Instructions
Be specific with dates β Write "December 24-26, 2025" rather than "the holiday season"
Always include your timezone for time-of-day conditions β e.g., "9am-5pm ET" or "after 6pm PST"
Include an "Otherwise" message β This is the fallback your customers see when no other condition matches
Keep it simple β The AI is very good at understanding plain English conditions, so write naturally
Use date ranges β "December 24-26" or "June 1 through August 31" both work
Combine conditions β "Monday-Friday between 9am-5pm ET" works as a single condition
What If I Don't Use Conditions?
If you write a simple message without any "If" conditions, it works exactly as before β the AI shows that same message to every customer, every time. No changes needed to your existing setup.
Integration Settings
Integration Type β Select your connected helpdesk (Gorgias, Zendesk, Freshdesk, etc.)
Subject β Default ticket subject line (e.g., "Contact support")
Tags β One or more tags applied to every handoff ticket, on top of Rep's automatic
repand channel tags. See Tag Every Handoff Ticket the Way Your Team Works below.
What Your Team Sees in Every Handoff Ticket
Every ticket Rep opens for your team leads with the shopper's request and carries the full chat conversation, so an agent can act without opening anything else.
In every handoff ticket:
The inquiry β a short, single-line statement of what the shopper is asking for, written by the AI from the conversation. Your agent reads the request first, in plain language, without having to reconstruct it from the chat.
Shopper contact details β name and email, plus phone number when the shopper has shared it, the order number when one came up in the conversation, and any photo the shopper uploaded.
The conversation β the full chat transcript between the shopper and your AI, turn by turn.
Quotation marks mean one thing: the shopper said it. Transcript turns are quoted verbatim; the AI's own writing β the inquiry line, the overview β is never in quotes, so an agent can always tell the difference at a glance.
Enrich Ticket with Customer Journey
The "Enrich ticket with customer journey" toggle in your Human handoff settings controls how much context Rep adds on top of that.
With the toggle on, each ticket also carries:
Conversation Overview (AI Generated) β the topic of the conversation, a one-to-two sentence summary, and a bullet list of key highlights, placed above everything else so it's the first thing your agent reads.
Customer actions on the website β the collection pages and product pages the shopper visited, and the products they added to their cart.
Time spent on the website before the handoff.
A link into the live chat, so if the shopper is still on your site your agent can reply in the conversation instead of by email.
With the toggle on, the inquiry line carries the shopper's own last message, since the overview above it already states the request in the AI's words.
With the toggle off, the ticket is the concise version: the AI-written inquiry line, the contact details, and the conversation. No overview block, no on-site journey, no live-chat link.
We recommend keeping this ON β it gives your team the shopper's intent, journey, and a live reply path in one place, and it cuts the time agents spend asking "What's this about?"
How the Ticket Looks in Your Helpdesk
The same information reaches every connected helpdesk. The layout follows whatever the helpdesk supports.
Zendesk, Gorgias, Freshdesk, HelpScout, Richpanel, and Rep Inbox receive a formatted ticket with labelled sections:
Conversation Overview (AI Generated) β Topic, Summary, Highlights (with enrichment on)
Customer Details β Name, Email, Phone number, Inquiry, Attached image, Order ID, and with enrichment on, Time Spent on Website and a Respond directly in the chat link
Customer Actions on the Website (with enrichment on)
Conversation History
Kustomer and Salesforce Service Cloud receive the same content as plain text, since those platforms render ticket bodies as text:
With enrichment on, the ticket opens with
Topic,Summary, andKey highlights, followed byCustomer's inquiryand the live-chat link, thenCustomer actions, the time on site, and the conversation, with the attached image and order ID at the end.With enrichment off, the ticket opens with
Customer's inquiry, thenName,Email,Phone numberandOrder ID, then the conversation.
If your handoff goes to a plain support email address rather than a connected helpdesk, the email carries the same formatted layout as the helpdesk group above.
Tag Every Handoff Ticket the Way Your Team Works
Your Human handoff settings include a Tags field, and it takes as many tags as you need. Every tag you add is applied to each support ticket Rep opens for your team, so the routing rules, views, and reports you already run in your helpdesk fire on Rep's tickets exactly the way they fire on the rest.
Adding your tags:
Open Support Skills and click Edit settings on the Human handoff card
Find the Tags field
Type a tag and click Add β it appears as a chip below the field
Repeat for each tag you want, or paste a comma-separated list to add several at once
Click Save
Paste your whole list at once. Typing or pasting a comma-separated string β vip, returns, urgent β adds each piece as its own tag. Spaces around the commas are trimmed and empty entries are skipped, so a list copied straight out of your helpdesk works as-is.
Removing a tag. Click the β on any chip. The rest stay exactly as they were. Save to apply.
At least one tag is required to save the skill, so every handoff ticket always carries something your team can route on.
Good to know:
Your tags add to Rep's own tags, they never replace them. Every handoff ticket still carries the
reptag and its channel tag (channel:mobile web,channel:instagram, and so on) alongside yours.Duplicates are caught for you. Adding a tag that's already in the list is rejected with a short message, so you can paste an overlapping list without creating doubles. Capitalisation isn't a difference that counts β
VIPandvipreach your helpdesk as one tag.Single words travel best. Some helpdesks split a tag on its spaces, so
high prioritycan arrive as two separate tags. Usehigh-priorityorhigh_prioritywhen a tag needs more than one word.Each tag can be up to 80 characters.
Already using one tag? It's shown as your first chip and keeps working exactly as it did. Add more whenever you like β there's nothing to migrate and nothing you need to re-configure.
Tags apply to new tickets. Tickets already sitting in your helpdesk are unchanged.
Email handoff doesn't use tags. When your Integration Type is Email, the field you'll see is to β the address the handoff is sent to β and no tags are involved.
Ways merchants use this:
One tag that routes to a queue (
support-ai), plus one that marks priority (vip), plus one for reporting (from-chat)A tag per team, so a single Rep handoff can be visible to both the returns and the shipping queue
A tag your existing macros and SLAs already key off, so Rep's tickets inherit your automation without you writing a new rule
Which helpdesks apply your tags: Zendesk, Gorgias, Freshdesk, Kustomer, HelpScout, and Rep Inbox. Kustomer creates a tag for you if the name is new to your account; Zendesk stores tags in lowercase. Richpanel tickets don't currently carry tags β see the note in Troubleshooting.
See Which Channel Each Handoff Came From
Every support ticket Rep opens in your helpdesk is automatically tagged with the channel the shopper was using when they asked for help β so your team can see, at a glance, where the conversation started without opening the ticket.
Alongside the standard rep tag, each handoff ticket carries a channel tag identifying one of:
Mobile β shopper was on your website on a mobile device
Desktop β shopper was on your website on a desktop computer
Facebook β Facebook Messenger
Instagram β Instagram DM
WhatsApp β WhatsApp
Email β the conversation reached you over email
Why this helps your team:
Route faster β send Instagram and Facebook tickets straight to your social-media specialist, or WhatsApp tickets to the right regional agent, using your helpdesk's normal routing rules
Filter and report β build saved views, queues, or reports grouped by channel (for example, "all WhatsApp handoffs this week") using the tag tools already built into your helpdesk
Prioritize β apply different SLAs or macros to different channels when your response expectations vary
No setup needed. The channel tag is added automatically on every new handoff ticket. It behaves exactly like any other tag in your helpdesk β there's nothing to configure in Rep. The tag works the same way across Gorgias, Zendesk, Freshdesk, Kustomer, HelpScout, and Rep Inbox.
Good to know: The channel tag applies only to new tickets created after this feature is enabled β existing tickets in your helpdesk are unchanged. Tickets that come in through a plain email fallback (rather than a connected helpdesk integration) don't carry the tag.
Common Scenarios
Customer Requests Human Help Directly
When customers explicitly ask to speak with someone, AI immediately begins the Human Handoff flow without trying to answer first.
Customer Requests Support on Instagram, Facebook, or WhatsApp
When a customer sends a message like "I need to talk to someone" on any Meta channel, the AI activates the same Human Handoff flow. It collects the required information conversationally within the DM thread, creates a ticket in your helpdesk, and sends the acknowledgment message β all without the customer needing to switch to your website.
Mid-Conversation Escalation
If a customer is using another AI skill (like tracking an order) but asks for human help, AI gracefully transitions to Human Handoff with full context. This works the same on website chat and Meta channels.
Known Customer Information
If your AI already knows the customer's email or order number from earlier in the conversation, it won't ask againβit automatically uses that information.
Routing Tickets by Channel
Because every handoff ticket is tagged with its channel, you can use your helpdesk's native rules to send tickets to the right place automatically β for example, routing all Instagram and Facebook handoffs to your social team, or giving WhatsApp tickets a faster SLA. No extra configuration in Rep is required; just build the view or rule on the tag in your helpdesk.
Routing Tickets by Your Own Tags
Because every handoff ticket also carries the tags you configured, your existing helpdesk rules work on Rep's tickets with no new setup. Add the tag your returns queue already watches and Rep's returns handoffs land there; add the tag your VIP SLA keys off and those tickets inherit the faster clock.
Holiday or After-Hours Contact
When you've set up time-based acknowledgment instructions, customers automatically see the right message based on when they reach out. For example, a customer contacting support on Christmas Day sees your holiday message, while someone reaching out on a regular Tuesday sees your standard response time. This works across all channels including Meta DMs.
Integration Issues
If your helpdesk integration has any issues, make sure it's properly connected in Settings β Integrations. The AI relies on this connection to create tickets successfully.
Benefits at a Glance
Faster Resolutions β Support team receives context-rich tickets, not just "Customer needs help"
Request First, Always β every ticket opens on a plain-language statement of what the shopper wants, with the full conversation underneath, so agents can act on the first screen
Reduced Friction β No duplicate questions or forcing customers through rigid forms
Improved Customer Experience β Feels like talking to a knowledgeable assistant, not filling out a form
Cross-Skill Awareness β All AI skills know when to escalate and can do so intelligently
Multi-Channel Coverage β Shoppers on Instagram, Facebook, and WhatsApp get the same escalation path as website visitors
Channel Visibility β Every handoff ticket is tagged with the shopper's channel (Mobile, Desktop, Facebook, Instagram, WhatsApp, Email), so your team can route and filter by where the conversation began
Your Tags, Every Ticket β apply as many of your own tags as you need to every handoff ticket, so your existing routing, SLAs, and reports pick Rep's tickets up automatically
Time-Aware Messaging β Customers always see accurate availability expectations, even during holidays or outside business hours
Flexibility β Works with your existing helpdesk integration
Troubleshooting
Human Handoff isn't working
Verify your helpdesk integration is connected in Settings β Integrations
Check that you've saved your Human Handoff settings
Ensure the Integration Type is selected in the configuration modal
Human Handoff isn't working on Meta channels
Make sure Contact Support is enabled and configured in your Support Skills settings β the same configuration applies to all channels
Verify your helpdesk integration is connected in Settings β Integrations
Confirm that Meta AI Answering is active on the channel where the customer is reaching out
My tags aren't on the ticket
Open Edit settings on the Human handoff card and confirm your tags are listed as chips, then Save β saving through the Console is what applies the change to new conversations
Tags apply to tickets created after you save; earlier tickets are unchanged
If a multi-word tag arrived split in two, your helpdesk broke it on the space β re-enter it as
one-wordorone_wordIf your Integration Type is Email, tags aren't part of that path
I use Richpanel and no tags arrive
Richpanel handoff tickets don't currently carry tags β yours, the rep tag, or the channel tag. Richpanel keeps its tags behind a separate API credential from the one that creates tickets. Your tags are saved and everything else about the handoff works normally. We're actively working on this; contact support if it's blocking a workflow and we'll let you know when it lands.
The AI overview is missing from a ticket
If a ticket arrives with the conversation and the customer journey but no Conversation Overview block, the AI summary wasn't available for that conversation. The ticket still carries everything else β the inquiry line, contact details, on-site journey and the full transcript β so your agent can work the ticket normally. This is rare and resolves on its own; there's nothing to change in your settings.
AI asks for information we already have
The AI asks for information again because it doesn't recognize the shopper as the same person from a previous conversation. This happens when:
Shopper uses a different device β The customer chatted on their phone yesterday but is now on their laptop
Cookies were cleared β Browser data was deleted, removing the session identifier
Not logged into Shopify β Guest shoppers don't have a persistent account connection
Incognito/Private browsing β These modes don't save session data between visits
Why this happens: Rep AI needs a connection point to recognize returning customers. Without being logged into your Shopify store, the AI relies on browser cookies to identify returning visitors. When that connection is lost, the AI treats them as a new visitor and needs to collect their information again.
The AI keeps asking for a photo on Instagram, Facebook, or WhatsApp
Those channels have no upload window, so the shopper attaches the image directly in the conversation instead. Your AI reads what they send and includes its link in the support ticket. If Photo is set to Required, the AI may still ask again before it opens the ticket β set Photo to Optional for stores that receive messages on Instagram, Messenger, or WhatsApp, and the flow completes normally with the photo attached.
My time-based messages aren't showing the right version
Double-check that your date format is specific (e.g., "December 24-26" instead of "around Christmas")
Make sure you've included a timezone for time-of-day conditions (e.g., "9am-5pm ET")
Remember that the AI uses your business timezone, not the customer's local time
Verify the year is included for date-specific conditions that shouldn't repeat annually
I wrote conditions but customers always see the same message
Make sure your instructions include the word "If" to signal conditional logic
Check that you have an "Otherwise" or "Else" clause for when no conditions match
Review your date ranges to confirm they cover the intended period
Want to customize the acknowledgment message
Click Edit settings on the Human handoff card
Find the Acknowledgment Instructions section
Replace the default message with your custom text β either a simple message or conditional instructions
Click Save to apply changes
Getting the Most from Human Handoff
Set Clear Expectations
Customize your acknowledgment instructions to mention your actual response time. Honesty builds trustβif you respond in 4 hours, say so!
Mirror Your Helpdesk's Own Tags
The fastest setup is to copy the tag names your team already routes on and paste them straight into the Tags field as a comma-separated list. Rep's tickets then flow through the views, queues, macros, and SLAs you've already built β no new rules to write.
Use Time-Based Messages for Holidays and Schedule Changes
Instead of scrambling to update your message before every holiday, write your conditions once at the start of the year. Include all your planned closures and schedule changes, and the AI takes care of the rest.
Enable Customer Journey Enrichment
Keep the "Enrich ticket with customer journey" toggle ON. Your support team will thank you when they see the full context instead of just "Customer needs help."
Monitor Escalation Patterns
Use Analytics to understand which types of questions lead to support escalations. If you see patterns, consider:
Adding FAQ content to answer common questions
Adjusting AI instructions to better handle specific scenarios
Enabling additional AI skills that might resolve issues before escalation
Optimize Field Collection
If customers frequently drop off during information collection:
Review which fields are set as Required
Consider making some fields Optional instead
Only ask for Photo uploads when truly necessary, and keep Photo set to Optional rather than Required if you receive messages on Instagram, Messenger, or WhatsApp
Need More Help?
If you have questions about configuring Human Handoff or want guidance on setting up time-based acknowledgment messages, contact our support teamβwe're here to help!