Plateforme
Features
Agent Studio
Construisez et personnalisez rapidement votre agent.
Moteur autonome
Utilisez des LLMs pour guider les conversations et les tâches.
Bases de connaissances
Entraînez votre bot avec des sources de connaissances personnalisées
Tables
Stocker et gérer les données de conversation
Canaux
Whatsapp Emblème
WhatsApp
Instagram Emblème
Instagram
Logo de Facebook Messenger
Messenger
Slack logo
Slack
Tous les canaux
Intégrations
Logo Hubspot
HubSpot
Logo Notion
Notion
Logo Jira
Jira
Calendly logo
Calendly
Toutes les intégrations
Fournisseurs de LLM
Logo de lOpenAI
OpenAI
Logo Anthropic
Anthropic
Logo Groq
Groq
Logo HuggingFace
Hugging Face
Tous les LLMs
Solutions
Pour
Entreprise
Automatisez les flux de travail de production critiques pour la mission.
Agences
Fournissez des services d'agents sophistiqués.
Développeurs
Explorez une API robuste pour le développement d'agents.
Histoires de clients
Découvrez comment Botpress transforme les entreprises dans le monde entier grâce à des clients réussis.
Par secteur
E-commerce
Éducation
Finance
Hôtellerie
Tous les secteurs
Par département
Ventes
Ingénierie
Produit
ITSM
Tous les départements
Par cas d'utilisation
Assistant de shopping
Génération de leads
Expérience employé
Gestion des tickets
Tous les cas d'utilisation
Ressources
Essentiel
Académie
Apprenez à construire grâce à des cours sélectionnés.
Bibliothèque
Ressources pour améliorer vos flux de travail en IA.
Blog
Aperçus et mises à jour sur Botpress et les agents IA.
construction
Discord
Rejoignez des milliers de pairs et partagez des idées.
Docs
Guides et références complets
API
Matériel de référence à utiliser avec des systèmes externes.
Classement des LLM
Comparer la performance et le coût des fournisseurs de modèles.
Vidéos
Tutoriels, démonstrations et visites guidées du produit.
Journal des modifications
Restez à jour sur les dernières mises à jour de Botpress.
Partenaires
Devenir partenaire
Rejoignez notre réseau d'experts certifiés
Engagez un expert
Connectez-vous avec des partenaires et des consultants
Docs
Entreprise
Tarification
Se connecter
ContactInscrivez-vous
retour à Hub

Zoho Sales IQ HITL

v2.0.0
Installer sur votre espace de travail
Mis à jour par Botpress Growth Team
  # **Zoho SalesIQ HITL (Human-in-the-Loop) Integration**

This integration allows Botpress to **seamlessly escalate conversations** from a chatbot to a live agent in **Zoho SalesIQ**. When a user requests human assistance, the bot initiates a **new conversation** in Zoho SalesIQ and enables real-time communication between the user and a human agent.

### **How It Works**

1. **Conversation Start**:
   - When a user requests live agent support, the bot calls **Zoho SalesIQ's Open Conversation API** to create a new session.
   - The **Botpress HITL interface** keeps track of the conversation ID.

2. **Message Handling**:
   - User messages are forwarded to the **Zoho SalesIQ Send Message API**, allowing the visitor to communicate with the assigned agent.

3. **Operator Events Tracking**:
   - The integration listens for **Zoho SalesIQ webhook events**, such as:
     - **Agent Assignment (`operatorAssignedUpdate`)**
     - **Conversation Resolved (`operatorConversationComplete`)**
     - **Missed Conversations (`operatorConversationMissed`)**
     - **Agent Messages (`operatorSendMessage`)**

4. **Closing Conversations**:
   - Once an agent **resolves the conversation**, Botpress will update the session and notify the chatbot.

---

# Zoho SalesIQ Integration Setup Guide

### **[Loom video walk through setting up the OAuth configuration.](https://www.loom.com/share/d3c758e372e54a32b4f29d7da44af1ce?sid=38c81c81-486e-4a48-bfb1-941b02d052d1)** ###

## Step 1: Create a Zoho Developer Account

1. Open the Zoho API Console:  
   [https://api-console.zohocloud.ca/add?client_type=ORG](https://api-console.zohocloud.ca/add?client_type=ORG)
2. Sign in or create a Zoho Developer account if needed.
3. Create a new OAuth client.
4. Set the **Redirect URI** to your **Botpress webhook URL**.

## Step 2: Generate an Authorization Code

Ensure you use the **correct region URL** for OAuth authentication.

#### **Zoho Accounts Domains:**
| Region         | Accounts URL                       |
|---------------|----------------------------------|
| US           | `https://accounts.zoho.com`     |
| AU           | `https://accounts.zoho.com.au`  |
| EU           | `https://accounts.zoho.eu`      |
| IN           | `https://accounts.zoho.in`      |
| CN           | `https://accounts.zoho.com.cn`  |
| JP           | `https://accounts.zoho.jp`      |
| SA (Saudi Arabia) | `https://accounts.zoho.sa` |
| CA (Canada)  | `https://accounts.zohocloud.ca` |

Construct the following authorization URL, replacing placeholders with your actual values:

```text
https://accounts.zohocloud.ca/oauth/v2/org/auth?response_type=code
&client_id=YOUR_CLIENT_ID
&scope=SalesIQ.Conversations.ALL,SalesIQ.apps.read
&redirect_uri=YOUR_REDIRECT_URI
&access_type=offline
&state=123
```

- Replace `YOUR_CLIENT_ID` with your **Zoho Client ID**.
- Replace `YOUR_REDIRECT_URL` with your **Botpress webhook URL**.
- Ensure the scope is set to `SalesIQ.Conversations.ALL`.

### Get Authorization Code

1. Open the modified URL in a browser.
2. Click **Accept** when prompted.
3. Copy the **authorization code** from the redirected URL, which will look something like:

   ```text
   https://webhook.botpress.cloud/2fca97ae-3078-4287-87a2-957e7f68157a?state=123&code=1005.4e8ee2431c3713671170956c8f8ed585.8ac5720917a810e6d447df63d2b63aef&location=ca&accounts-server=https%3A%2F%2Faccounts.zohocloud.ca
   ```
   
4. The `code` parameter (`1005.4e8ee2431c...`) is your **authorization code**.

## Step 3: Exchange Authorization Code for Access Token

Run the following cURL command, replacing placeholders with your actual credentials:

```sh
curl -X POST "ACCOUNTS_URL_REGION/oauth/v2/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "code=YOUR_CODE" \
     -d "grant_type=authorization_code" \
     -d "client_id=YOUR_CLIENT_ID" \
     -d "client_secret=YOUR_CLIENT_SECRET" \
     -d "redirect_uri=YOUR_REDIRECT_URI" \
     -d "scope=SalesIQ.Conversations.ALL,SalesIQ.apps.read"
```

- Replace `YOUR_CODE` with the **authorization code** from Step 2.
- Replace `YOUR_CLIENT_ID`, `YOUR_CLIENT_SECRET`, and `YOUR_REDIRECT_URL` with your actual values.

## Step 4: Store Credentials in Your Integration

After making the request, you will receive a response containing an **access token** and a **refresh token**. Store the following credentials in your integration configuration:

- **Client ID**
- **Client Secret**
- **Access Token**
- **Refresh Token**

## Step 5: Retrieve Required Zoho IDs

To fully integrate with **Zoho SalesIQ**, you need to gather the following details:

### 1. Get Your Screen Name

- Visit your **Zoho SalesIQ Home Page**.
  [https://salesiq.zohocloud.ca/](https://salesiq.zohocloud.ca/)
- Your **Screen Name** is displayed on this page in the URL at the top of your browser, for example, envyroinc is the screen name here https://salesiq.zohocloud.ca/envyroinc/mychats.

### 2. Get Your Department ID

1. Go to **Settings > Departments** in **Zoho SalesIQ**.
2. Click on the correct department.
3. The **Department ID** is in the URL:
   
   ```text
   https://salesiq.zohocloud.ca/envyroinc/settings/departments/edit/6338000000002024
   ```
   
   - Example **Department ID**: `6338000000002024`

### 3. Get Your App ID

1. Go to **Settings > Brands** in **Zoho SalesIQ**.
2. Click on the correct brand.
3. The **App ID** is in the URL:
   
   ```text
   https://salesiq.zohocloud.ca/envyroinc/settings/brands/6338000000002238
   ```
   
   - Example **App ID**: `6338000000002238`

## Step 6: Final Integration Configuration Setup

Enter the following details into your integration configuration:

✅ **Screen Name**  
✅ **App ID**  
✅ **Department ID**

# How to Set Up a Webhook in SalesIQ for Botpress

Follow these steps to integrate your SalesIQ account with Botpress using webhooks.

## Step 1: Navigate to Webhooks in SalesIQ
1. **Log in** to your SalesIQ account.
2. Click on **Settings** in the sidebar.
3. Scroll down and select **Webhooks**.

## Step 2: Add a New Webhook
4. Click **Add a New Data Modifications Webhook**.
5. Select the **correct brand/organization** for which you want to configure the webhook.

## Step 3: Configure the Webhook
6. In the **URL to be invoked** field, **copy and paste** your Botpress webhook URL.

## Step 4: Select Webhook Events
7. Check the following events to be associated with the webhook:
   - `conversation.attender.updated`
   - `conversation.missed`
   - `conversation.operator.replied`
   - `conversation.completed`

## Step 5: Save Your Webhook
8. Click the **Create Webhook** button to finalize your webhook setup.

**That's it!** Your webhook is now configured to send SalesIQ events to Botpress.



Construisez mieux avec Botpress

Créez des expériences incroyables pour les agents IA.

Commencez - c'est gratuit
Icône d'une flèche
En savoir plus sur Botpress Academy

Construisez des agents IA mieux et plus rapidement avec notre collection sélectionnée de cours, de guides et de tutoriels.

Engagez un expert

Connectez-vous avec nos développeurs certifiés pour trouver un créateur expert qui répond à vos besoins.

Tous les systèmes opérationnels
SOC 2
Certifié
RGPD
Conforme
© 2025
Plateforme
Tarification
Agent Studio
Moteur autonome
Bases de connaissances
Tables
Hub
Intégrations
Canaux
LLMs
Ressources
Parlez aux ventes
Documentation
Engagez un expert
Vidéos
Histoires de clients
Référence de l'API
Blog
Statut
Ressources v12
Communauté
Support communautaire
Devenir partenaire
Devenir un ambassadeur
Devenir un affilié
Société
À propos
Carrières
Actualités et presse
Légal
Confidentialité
© Botpress 2025