## Summary

Learn how to create a handoff action in Brainfish that allows users to escalate their queries to a live agent via Zendesk Chat.

## When to Use This

Use this setup when you want to provide your customers with the option to connect with a human support representative through Zendesk Sunshine Conversations directly from your Brainfish widget.

## Step-by-Step Instructions


 1. Navigate to your Brainfish dashboard and click on **Distribution**.
 2. Select the **Actions** tab.
 3. Click the **Create a new action** button in the top right corner.
 4. Choose **Handoff Action** from the available options.
 5. Define your action by providing an Action name (e.g., "Escalate to Human").
 6. Click **Pick your actions** to proceed.
 7. Select **Zendesk Chat** from the list of integrations (specifically the one via Zendesk Sunshine Conversations).
 8. Enter your Action Name, Zendesk Subdomain, App ID, Key ID, and Key Secret.
 9. Click **Add** to confirm your credentials.
10. In the Select agents screen, choose the specific widget where you want this action to appear (e.g., "Widget: Customer Support").
11. Click **Save & Publish**.

## Common Questions

* What credentials do I need for the Zendesk integration? You will need your Zendesk Subdomain, App ID, Key ID, and Key Secret.
* Can I apply this action to multiple widgets? Yes, you can choose to show it on all widgets or select specific ones during the setup process.

## Troubleshooting Tips

* If the action doesn't appear in the widget, check that you have selected the correct widget in the "Select agents" step before publishing.
* Ensure all API credentials for Zendesk Sunshine Conversations are entered correctly without trailing spaces.

[How to Set Up Zendesk Handoff Actions 1918x928](https://brainfish-storage-prod.s3-accelerate.amazonaws.com/uploads/f46edc33-d7db-401f-b584-38aa6bc65540/09848d92-79b4-4cf3-aa86-8f6ccb277c21/Screen%20Recording%202026-05-02%20at%207.45.38%E2%80%AFpm.mov?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAUPPN5IL363ARF33J%2F20260506%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260506T031805Z&X-Amz-Expires=3000&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEMf%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMiJHMEUCIFzCN2SkHLpBamLsU3RNipX5WiZrZzEsEPRZH04RPFSBAiEAzRA6obe49ch7BogFMHxLtkPbyWWep4la2%2Bc97oWbpQkq5QUIkP%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARACGgwzMDgxMjU5NzUyODciDBDZPMHaGSVGDtxanCq5BZiAN9h2IsjrMdmJjywcWtOyciNe4CmK8hnnIVa47LZUlp7lRuztAK0JaxkhDWnjI8EXY%2FEB4j59bq5fsqi5GwNp5hiAuBwLa%2F5ZGPRAKGiv%2B27tWuWO2qacwb10LAkUYMPjzGCKXB1cLQCN6EiAalEaSFB7wPRGLHbnmhNviPbCyJmlYIdAK39AxFeM2I7kfYzLCge%2BX0oGxUEhyobYbaiSPm0TitghUbLPckkSQp%2Bqqt0gxxmw3jSv0Y4NPzF1HD%2B5YMCPe0z2FAFo0zXDmM391G61HohTLYiYourD7XNkrZ7TKJVgiGGiGIkRFpHWDIuus%2F1y71ujCm2y81EcyPfGX23L4yIEYvU%2B65Tn72TSeSazth3EazyQ%2BXu4D%2Bn0hCuuDB4RtyNY%2BenbP0Oumm9PAj6DhBnyj%2B2FznkOlc%2FFQjlP9XG29KdbxInR%2F0QTvfS0v5A41aEzuOjEJMLi0QcNPofAPkYr73MAAXD1fT0B%2FFgChal9o1Hi2uo7TYjORo%2BIJK9TwUyK0nSdv%2BoCNYTCzv4yCAyCeac7DQhyxXzIyNasvYNmkFLT9iJps8AqaqyNVq%2FvL50Ua28TOlFWHO75Nhr0%2FrLQ8nHUezAr%2BGu7bjOvkdhIR5XaoAXqGJjFem%2BfIi0S1f54CEI8XCwpvD2KZ5SfilXv3RROhn1G60B1I7ktyCGv%2B4QBNX0xze1aaRfQncRdGxsCvrwM7Zz1W3LQ8sTdUy9z7RIpXJ2SK4j91PZc5x13Dkx7erqHJsLHUgMveLuPWyksnVp%2BGu3WUi625XUXG4qbYEPDo70VFNMG9%2Fzh9RNn10qwZkVdbA0k87wCWCxbxzKtBGx3cwXb9hoWHPOgjTeH0AGfwngAtP8cJ100pes%2BHc2dejh2Jt4RN2QgYvferl0VJsjxdJKy9U%2B9Ob7p%2Ba%2FC2hkw49%2FpzwY6kAGhJBiKZ4c0uSwAybXXWmy8KwVsljyaqWRvMDNotstHiaN0F9g7qw3AytdHOQZTNdUoEwtYfCQf3%2Bnp%2Bpe4l6Iymv8MhfELoRCauXqjxMIBIg7lYaxUtYdU1%2BMKAoqoa6T8oIosvNsBcSu0VefGabylNoJVvDUAPLDaabxft8aXWvL4YorZKZjr%2B3mIzPgpOJw%3D&X-Amz-Signature=cf5e212ddf868bcde5663717343305e3c05eb1f53075668f51c12392643d461e&X-Amz-SignedHeaders=host&response-content-disposition=attachment&start=0&end=112)




How to Set Up Zendesk Handoff Actions

Everything about deploying Brainfish to your customers. Covers agents, widgets, actions, nudges, the hosted help center, and channel integrations like Slack and Microsoft Teams.

Communication Methods and Accessing Your Knowledge Base Across Multiple Platforms

Configuring Advanced Agent Settings via JSON

Configuring Advanced Agent Settings

Creating and Configuring a Help Center Agent (Including Suggested Follow-up Actions)

Agent Identity (Using identities to improve accuracy and context)

Simulation: Test Your Agent

Customizing Your Help Center Agent Appearance

How to Configure Custom Instructions and Response Style for AI Agents

Managing Multiple Help Center Configurations

How to customise the Popup logo?

Configuring Self Serve Agents

Available Response Length Modes in Brainfish

Configuring Region Segmentation for Self-Service Agents

Agents

Brainfish Search Bar & Pop-up Modal Guide

Implementing Brainfish Popup Agent With Custom Button

Integrating Brainfish Widgets with Vue

Integrating Brainfish Widgets with React

Integrating Brainfish Widgets with Salesforce Lightning Web Components (LWC)

How to Integrate Brainfish Widgets with Google Tag Manager: A Step-by-Step Guide

Installing Brainfish in Micro-UI Architectures

Integrating Brainfish Widgets with HTML

Integrating Brainfish Widgets with Angular

Brainfish Widget Overrides Guide

Brainfish Widget - Contextual Help

Widgets & Deployment

Custom Links

Customising Brainfish for Your Brand: Personalising the User Interface for Help Center

Authenticated help centers

How to Set Up a Custom Domain?

Domain Configuration

How to enable Region Segmentation

How to Set Up Multiple Help Centers in Brainfish

Knowledge Grouping: Segmenting Answers

Applying Custom Fonts to Your Help Center (Including CDN/Cache Behavior)

Navigate to a specific region

How to Set Up 301 Redirects in Help Center

Citation Configuration and Behavior in Brainfish Search Responses

Creating URL Redirect Rules for Ambient Knowledge

How to Preview the Help Center

Configuration options not appearing in Help Center?

Help Center

Salesforce Handoff Integration

How to Configure a Custom JavaScript Callback for a Handoff Action

Human Handoff Integrations

Setting up JS Callbacks with AI Action Buttons

How to Create and Define a New API Action

Overview

Zendesk Handoff Integration

Configuring the Handoff Action

Testing the Handoff Workflow

Setting Up Front Ticket Handoff

Handoffs & Actions

How to Configure and Manage the Microsoft Teams Integration

Slack Integration Permissions

Integrate and Manage Slack Agents

How to Create a New Slack Agent

How to Set Up and Configure the Slack Agent

Connecting Slack Channels in the Dashboard

Moving Channels Between Agents

Salesforce Email Agent Integration

How to Connect to Salesforce Using an External Client App

Brainfish Assist (Chrome Extension & Instant Answers Overview)

Including Query Details in Support Handoffs from the AI Assistant

Escalating to a Live Agent as a Customer

Managing Handoff Chats in Zendesk as an Agent

Integrations

Guidance & Nudges: A Complete Guide to Creating, Configuring, and Publishing Nudges

Nudges & Guidance

How endpoints are ordered in your API Reference

Distribution

New to Brainfish? Start here. Covers platform overview, navigation, pricing, onboarding, and how to get help.

Quickstart

What is Brainfish

Why Brainfish for enterprise

Creating and Removing Users

How to Activate a Suspended User Account

Getting Started: Navigating the Brainfish Platform

[VIDEO] Get Started with Brainfish: The AI Self-Service Platform

Language and Localization Support

Platform Overview

Getting Support for Brainfish, Including Slack Support

Stuck Logging In?

Pricing

Help & Support

Getting Started

Everything about managing your content. Covers the Managed CMS, articles, collections, external data source syncs, and keeping your knowledge base healthy.

Using the Managed CMS Editor

Editing and Managing Draft Articles

List of Editor Integrations

Articles 101

Collections 101

How to embed custom iframe?

How to Export and Import articles from Brainfish CMS?

Managed CMS

How to Manage Your Knowledge Base Articles

Comprehensive Guide to Managing Your Knowledge Hub

How to Optimize Articles for AI Ranking

How to embed videos in articles

Video Upload Limits and Default Timing Update (30 ms)

Connecting a New External Data Source

How to Connect Confluence as an External Data Source in Brainfish

Readme Knowledge Sync

Brainfish OAS Github Actions Sync 

OpenAPI Specification (OAS) API Documentation Sync

HelpJuice Knowledge Sync

Freshdesk Knowledge Sync

Zendesk Knowledge Sync

Intercom Knowledge Sync

Notion Knowledge Sync

Readme V2 Knowledge Sync

Helpscout Knowledge Sync

Website Knowledge Sync

Create Knowledge from GitHub PRs

HubSpot CSV Export

How to get Intercom access token?

How do I enable the Content Sync?

How to get the API key in Salesforce?

How to Connect, Sync, and Manage External Data Sources

Bulk Upload Knowledge into Brainfish

Migrating your content

How to Review and Approve Generated Answers

Accessing and Reviewing Session Replays

Ambient Agent / Session Recording FAQ's

How are sessions selected for knowledge generation

How to Create Knowledge Articles from a Slack Thread

Generate, Review, and Publish Knowledge Base Article Suggestions from Videos, Session Replays, Slack, and APIs

How to Use Explicit Matching for Knowledge Sources

Navigating Nested Folders

Search & Organisation

Using Brainfish Effectively in a Product Marketing Motion

Using Brainfish for Product Marketing and Content Discovery

Brainfish MCP — Use Brainfish Inside Claude

Microsoft Teams Integration

API Docs for Help Center

Knowledge

Understand how your customers are interacting with Brainfish. Covers threads, themes, sessions, answer rate, health checks, and article performance.

Tracking and Navigating Analytics: Identifying Users, Searching Threads, and Exporting Data

Overview & Navigation

Filtering and Reviewing Query Analytics

Threads & Filtering

Brainfish Hosted Help Center Website Analytics

Article statistics

Health Checks

What is Answer Rate?

Brainfish Themes: Understand your customers better at scale

How do I export themes or sub-themes?

Performance & Themes

Analytics

How Brainfish handles your data. Covers SOC 2 Type II and ISO 27001:2022 certifications, GDPR compliance, data residency (US, EU, AU), privacy controls, and security practices.

Security in Software Development

How can I authenticate users from my website to the Help Center?

GDPR

How does Help Center Authentication work?

Session Recording Privacy

Setting Up a DNT Tag for Brainfish AI Agent

Data Security

Compliance Measures

Brainfish Privacy and Security Features

Security & Compliance

For developers and technical users. Covers the REST API, JavaScript SDK, widget installation, mobile, MCP server, and advanced configuration options.