AI Cards

AI Cards

AI cards are used to perform artifical intelligence related tasks. Currently, answer bot engine and the ChatGPT (OpenAI) are available. 

Channel compatibility and limitations

       
All AI card are supported in Website, Mobile App, Facebook, Instagram, WhatsApp, Telegram, and LINE.

Answer Bot

Alert
The Answer bot card is available only for the Enterprise  plan

The Answer bot card behaves like the Answer bot, it displays articles and FAQs based on the visitor's question.  

  • To add an Answer bot card to the bot's flow, click on the card holder (+) icon to view the card gallery and select the Answer bot card under the action card section.

  1. Give a name to your card and select the resource section  to the Answer bot card. Resources are the "Brain of the Answer bot." The bot will use these to answer the visitor's questions. Choose your resource, the Answer bot card supports either Zoho SalesIQ's resource or Zoho Desk's knowledge base. 
    1. Zoho SalesIQ Resource - The bot uses only the SalesIQ's resource to answer the question.
Info
When using the Zoho SalesIQ resources, you need to have a considerable amount of resources(FAQs, Articles) to improve bot response efficiency and accuracy. We recommend having a minimum of 50 resources in each category. The more resources, the more powerful your bot will be. A strong resource base for the Answer bot will reduce your operators' workload and increase the bot's resolution rate.
    1. Zoho Desk Resource - The bot uses only the Desk's knowledge base to answer the question. 
Notes
Note:  
  1. Zoho Desk integration is mandatory to select the Zoho Desk resource/knowledge base for the bot. 
  2. The bot uses the articles from the desk department that is mapped to the bot's department under integration configuration. 
  3. Zia should be enabled in the Zoho Desk.
  4. A minimum of 30 articles are required in the KB. 


  1. Next, select a  Small talk package. Small talk is a collection of possible informal phrases that a visitor can send during a conversation and the corresponding responses that can be given by the bot. The default package will be selected by default but you can choose the package of your choice.  Learn how to manage Small Talk packages.

AI services to summarise the answers

Answer Bot supports two AI services that enhance how responses are delivered. Instead of sending entire articles, both services generates summarized content based on the visitor's question and follow it with related articles.

Zia
Zoho’s built-in Generative AI that crafts summaries directly from your resources.
  1. Enabled by default.
  2. No extra subscription or cost required.
  3. Available in US, IN, EU, and AU Data Centers.
ChatGPT
Uses OpenAI’s ChatGPT to generate summarized answers from your articles.
  1. The SalesIQ-ChatGPT integration is mandatory.
  2. Requires a paid ChatGPT plan with API access (free trial or ChatGPT Plus may not work reliably).
  3. Available in US, IN, EU, AU, and JP Data Centers.


If the bot knows the answer to a visitor query, it picks the right article or FAQ and displays it. This is called an Answer found case. In this section, 
  1. Enter the Suggestion Prefix Text.  This is the text that will be displayed above the article that the bot displays to the visitor. 
  2. Followed by, click on Add action to add a follow-up action when the bot finds answers to the visitor's queries. You can add a maximum of three follow-up actions. 


If the bot does not know the answer to a visitor query and does not find any matching articles or FAQs, it is an Answer not found case. In this section, 
  1. Set up  Fallback Text  - the text that has to be displayed in the chat window when no FAQ or article matches the visitor's query. 
  2. Followed by, click on Add action to add a follow-up action when the bot couldn't find answers. You can add a maximum of three follow-up actions. 
  3. You can also configure the bot to display related resources. Click on the toggle to enable/disable  Related Resource Suggestion . Now, enter the suggestion text to indicate when a related resource is shown.
  4. Finally, click on Save . The answer bot card will be added to the bot's flow.
Notes
The Answer bot card will exit only when the visitor selects follow up actions, until then the answer bot engine will continue.
The answer bot card will split the flow according to the follow-up action you have defined here. Therefore you can add card and create flow based on your requirements. By default, there is a failure flow, this will be invoked when the answer bot bot engine fails. You can add cards here to handle failure cases.  



Example - Setting up answer bot card for support. 



Question Answering 

Info
Note to customers: This card is a part of our upcoming Summer ’26 release and will be rolled out in phases. If you would like early access to explore the feature, please fill out this form.
The Question Answering card card enables your bot to generate contextual, business-specific answers using your knowledge base and AI services.

It is designed for sales and support use cases, where responses need to be consistent, relevant, and aligned with your business content. The card uses your SalesIQ knowledge center (Articles, FAQs, Small Talks, and Webpages) or Zoho Desk Knowledge base along with the configured AI engine, making every answer specific to your business.

The quality of responses depends on both your knowledge base and the AI engine, richer content leads to more accurate and useful answers.

Business outcomes
  1. Handle a higher volume of queries efficiently by automating repetitive questions across sales and support.
  2. Deliver consistent, business-aligned responses by grounding answers in your knowledge base instead of generic AI output
  3. Reduce routine workload for operators using AI to handle common queries so operators can focus on complex conversations
  4. Maintain control over AI responses by defining how the bot handles valid, invalid, or failed answers

Supported AI services

The AI Response card supports multiple AI engines, giving you flexibility to choose or integrate your preferred service

AI serviceSupported models 
Zia (Zoho’s in-house AI engine)
Zia uses the most optimal model (no selection required).
OpenAIgpt-3.5-turbo, gpt-4, gpt-4o, gpt-4o-mini
OpenAI Assistant
Assistants configured in your OpenAI account
Anthropicclaude-sonnet-4-6, claude-opus-4-6, claude-haiku-4-5-20251001
Google AIgemini-2.5-flash, gemini-2.5-pro, gemini-3.1-pro
DeepSeekdeepseek-chat
Custom Service
Any AI service via REST APIs
AlertNote: To use external AI services, the respective AI must be integrated with SalesIQ. Click here to know more about the AI integration.

Working

Zia
  1. Zia uses the SalesIQ knowledge center/Zoho Desk's Knowledge base to generate answers.
  2. Searches Articles, FAQs, Small Talks, and Webpages
  3. Identifies the most relevant resources based on the visitor/user question. 
  4. Generates a summarized response and displays as answers. 
OpenAI, Anthropic, Google AI, & DeepSeek
  1. Zia retrieves up to 5 relevant resources from SalesIQ/Desk resource
  2. These resource are sent to the configured AI service
  3. The AI generates a response using both your data and its capabilities
Alert
Note: The OpenAI Assistant generates responses using its own knowledge. 
Custom service
  1. You can also connect any AI service using a custom REST API. 
  2. Custom services can optionally use SalesIQ or Zoho Desk knowledge sources. 
  3. Upon enabling, relevant resources are retrieved by Zia and sent along with the visitor's/user’s query, allowing the AI to generate responses using both business context and its own knowledge.
  4. Timeout: 5 seconds. Ensure the AI service responds within this duration for synchronous processing.
  5. Asynchronous support: If the response takes longer than 5 seconds, asynchronous handling is supported to process and deliver the response.
Info
Info
  1. Response handling can be customized for all supported services.
  2. Each response can include like/dislike options to collect visitor feedback.
  3. Response streaming is supported for all services except Custom Service.

Card configuration

To add this card to the builder, click on the + icon and go to Q/A card under the AI cards. Select Q/A card.

  1. Select the AI service to power this card

Service

Zia
OpenAI
Anthropic
Google AI
DeepSeek
Custom Service
Zia

Input 

Define what input (questions) is sent to the card from the visitor/user. Based on this, Zia will generate answers. 

Available options

  1. Use visitor’s last message - Uses the most recent user input, including responses from buttons, text inputs, or selection cards. Ensure the previous step captures meaningful input to avoid irrelevant answers.
  2. Choose context variable - Use data stored from earlier steps in the flow.
  3. Ask the visitor for input - Prompt the user with a question and use their response as input.

Training

Define the data source used to generate responses.

Knowledge sources (select one):
  1. SalesIQ resources:
    1. The car uses SalesIQ's Articles, FAQs, Webpages, and Small Talks
    2. Select specific resource or combinations based on your use case.
    3. Training status: Click on "Resource training status" to view training status for each resource. If a resource is not trained, you can retry training

  1. Zoho Desk resources
    1. The card uses the Desk's knowledge base.
    2. Zia should be enabled in the Zoho Desk (Setup > General > Zia > and enable Ticket Reply Assistant).
    3. A minimum of 30 articles is required in the Desk Knowledge base for this card to work. 
    4. Zoho Desk integration is mandatory to select the Zoho Desk resource/knowledge base for the bot. 
    5. The card uses the articles from the desk department that is mapped to the bot's department under integration configuration.  
    6. So, ensure to map the essential desk department with SalesIQ in the SalesIQ-Desk Integration page. 

Global data 

Enable global data to handle broader, non-business-specific queries.

  1. Define keywords (tags) to guide the AI toward better contextual search.
  2. Example - "Trending shoes"
  3. Use case - You own a shoe shop, when a visitor asks a general query like “What are the trending shoes for GenZ?”, the AI uses these tags to understand the context and generate a relevant response, even if the query is not strictly business-specific.
Notes
Supports up to 20 tags, each with 20 characters.

This allows the bot to respond to general queries while still prioritizing business context.

Response

Define how responses are handled and presented to the visitor/user.

Waiting state

  1. While Zia generates a response, you can display interim messages. Example: “Searching…”, “Fetching best match…”, "Putting it together".
  2. Supports up to 3 messages, displayed sequentially in a loop. 

Answer found

Triggered when Zia generates a response (answer) using a knowledge-backed context. 

Configurations

  1. Allow answer streaming - Streams responses in real time as they are generated, reducing perceived wait time.
  2. List reference sources - Displays the resources used to generate the answer in list.
    1. Title for source list - Title to display before the reference. Example: “Know more:”
  3. Follow-up action - Add buttons as per your preference for this case. Initially, the answers will be displayed, followed by these buttons. Each button will have a separate leg to handle the flow. 

Answer not found

Triggered when the Zia couldn't generate a response (answer). This can be due to the following reason.

  1. No relevant knowledge is identified
  2. Zia cannot generate a usable response
Configurations
  1. Add a text/message to be displayed when the "Answer not found case is triggered.
  2. Follow-up action - Add buttons as per your preference for this case. Initially, the answers will be displayed, followed by these buttons. Each button will have a separate leg to handle the flow. 

Ratings

Enable feedback collection for each response. This will collect the rating for a response. 

  1. Displays thumbs up / thumbs down options
  2. Allows users to rate each answer
Warning
Note: Ratings are supported only for the Web and Mobile SDKs. Social channels don't support this.
Trigger actions based on ratings:
Define automated actions via plugs based on rating patterns.
  1. Occurrence Count - Number of ratings required to trigger an action
  2. Mode (one at a time): 
    1. Consecutively - Back-to-back ratings
    2. Entire chat - Across the full conversation
Info
Unrated messages are not considered positive or negative.

Plug Configuration

  1. Select a plug
  2. Map required parameters
  3. Trigger actions such as notifications, escalations, or workflows

Finally, click Save to apply the configuration.

OpenAI
Supports both models and Assistants. Choose one to continue.
Alert
Note: Only Assistants configured through the SalesIQ–OpenAI integration can be used.


Input 

Define what input (questions) is sent to the card from the visitor/user. Based on this, OpenAI will generate answers. 

Available options

  1. Use visitor’s last message - Uses the most recent user input, including responses from buttons, text inputs, or selection cards. Ensure the previous step captures meaningful input to avoid irrelevant answers.
  2. Choose context variable - Use data stored from earlier steps in the flow.
  3. Ask the visitor for input - Prompt the user with a question and use their response as input.

Training

Define the data source used to generate responses.

Knowledge sources (select one):
  1. SalesIQ resources:
    1. The card uses SalesIQ's Articles, FAQs, Webpages, and Small Talks
    2. Select specific resources or combinations based on your use case.
    3. Training Status: Click on "Resource training status" to view training status for each resource. If a resource is not trained, you can retry training

  1. Zoho Desk resources
    1. The card uses the Desk's knowledge base.
    2. Zia should be enabled in the Zoho Desk (Setup > General > Zia > and enable Ticket Reply Assistant).
    3. A minimum of 30 articles is required in the Desk Knowledge base for this card to work. 
    4. Zoho Desk integration is mandatory to select the Zoho Desk resource/knowledge base for the bot. 
    5. The card uses the articles from the desk department that is mapped to the bot's department under integration configuration.  
    6. So, ensure to map the essential desk department with SalesIQ in the SalesIQ-Desk Integration page. 

Global data 

Enable global data to handle broader, non-business-specific queries.

  1. Define keywords (tags) to guide the AI toward better contextual search.
  2. Example - "Trending shoes"
  3. Use case - You own a shoe shop, when a visitor asks a general query like “What are the trending shoes for GenZ?”, the AI uses these tags to understand the context and generate a relevant response, even if the query is not strictly business-specific.
Notes
Supports up to 20 tags, each with 20 characters.

This allows the bot to respond to general queries while still prioritizing business context.


Response

Define how responses are handled and presented to the visitor/user.

Waiting state

  1. While OpenAI generates a response, you can display interim messages. Example: “Searching…”, “Fetching best match…”, "Putting it together".
  2. Supports up to 3 messages, displayed sequentially in a loop. 

Answer found

Triggered when OpenAI generates a response (answer) using a knowledge-backed context. 

Configurations

  1. Allow answer streaming - Streams responses in real time as they are generated, reducing perceived wait time.
  2. List reference sources - Displays the resources used to generate the answer in list.
    1. Title for source list - Title to display before the reference. Example: “Know more:”
  3. Follow-up action - Add buttons as per your preference for this case. Initially, the answers will be displayed, followed by these buttons. Each button will have a separate leg to handle the flow. 

Answer not found

Triggered when the OpenAI couldn't generate a response (answer). This can be due to the following reason.

  1. No relevant knowledge is identified
  2. OpenAI cannot generate a usable response
  3. Detection conditions are met (for Assistants)
Configurations
  1. Add a text/message to be displayed when the "Answer not found case is triggered.
  2. Follow-up action - Add buttons as per your preference for this case. Initially, the answers will be displayed, followed by these buttons. Each button will have a separate leg to handle the flow. 

Special Case: OpenAI Assistant

OpenAI Assistants may sometimes return fallback or technical responses (e.g., due to uncertainty, token limits, or processing issues). Displaying such responses directly to users can lead to a poor experience. To handle this, use Detection Text.

Configure your Assistant (in OpenAI) to return a specific, unique phrase when, it does not know the answer or when failure occurs. 
Info
Example instruction to Assistant - When you don’t know or are unsure about an answer, respond with: “Cannot generate answer” (and nothing else)
Then, set this exact phrase as the Detection Text in the card. So now, when this exact text is returned, the card treats it as an "Answer Not Found" case, and the configured fallback text and follow-up button will be triggered. This ensures users do not see incomplete, irrelevant, or technical AI responses.

Ratings

Enable feedback collection for each response. This will collect the rating for a response. 

  1. Displays thumbs up / thumbs down options
  2. Allows users to rate each answer
Warning
Note: Ratings are supported only for the Web and Mobile SDKs. Social channels don't support this.
Trigger actions based on ratings
Define automated actions via plugs based on rating patterns.
  1. Occurrence Count - Number of ratings required to trigger an action
  2. Mode (one at a time): 
    1. Consecutively - Back-to-back ratings
    2. Entire chat - Across the full conversation
Info
Unrated messages are not considered positive or negative.

Plug Configuration

  1. Select a plug
  2. Map required parameters
  3. Trigger actions such as notifications, escalations, or workflows

Finally, click Save to apply the configuration.

Anthropic
Alert
To use Anthropic models, SalesIQ-Anthropic integration is mandatory
Choose an Anthropic model to continue.


Input 

Define what input (questions) is sent to card from the visitor/user. Based on this, Anthropic will generate answers. 

Available options

  1. Use visitor’s last message - Uses the most recent user input, including responses from buttons, text inputs, or selection cards. Ensure the previous step captures meaningful input to avoid irrelevant answers.
  2. Choose context variable - Use data stored from earlier steps in the flow.
  3. Ask the visitor for input - Prompt the user with a question and use their response as input.

Training

Define the data source used to generate responses.

Knowledge sources (select one):
  1. SalesIQ resources:
    1. The card uses SalesIQ's Articles, FAQs, Webpages, and Small Talks
    2. Select specific resources or combinations based on your use case.
    3. Training Status: Click on "Resource training status" to view training status for each resource. If a resource is not trained, you can retry training.

  1. Zoho Desk resources
    1. The card uses the Desk's knowledge base.
    2. Zia should be enabled in the Zoho Desk (Setup > General > Zia > and enable Ticket Reply Assistant).
    3. A minimum of 30 articles is required in the Desk Knowledge base for this card to work. 
    4. Zoho Desk integration is mandatory to select the Zoho Desk resource/knowledge base for the bot. 
    5. The card uses the articles from the desk department that is mapped to the bot's department under integration configuration.  
    6. So, ensure to map the essential desk department with SalesIQ in the SalesIQ-Desk Integration page. 

Global Data 

Enable global data to handle broader, non-business-specific queries.

  1. Define keywords (tags) to guide the AI toward better contextual search.
  2. Example - "Trending shoes"
  3. Use case - You own a shoe shop, when a visitor asks a general query like “What are the trending shoes for GenZ?”, the AI uses these tags to understand the context and generate a relevant response, even if the query is not strictly business-specific.
Notes
Supports up to 20 tags, each with 20 characters.

This allows the bot to respond to general queries while still prioritizing business context.


Response

Define how responses are handled and presented to the visitor/user.

Waiting state

  1. While Anthropic generates a response, you can display interim messages. Example: “Searching…”, “Fetching best match…”, "Putting it together".
  2. Supports up to 3 messages, displayed sequentially in a loop. 

Answer found

Triggered when Anthropic generates a response (answer) using a knowledge-backed context. 

Configurations

  1. Allow answer streaming - Streams responses in real time as they are generated, reducing perceived wait time.
  2. List reference sources - Displays the resources used to generate the answer in list.
    1. Title for source list - Title to display before the reference. Example: “Know more:”
  3. Follow-up action - Add buttons as per your preference for this case. Initially, the answers will be displayed, followed by these buttons. Each button will have a separate leg to handle the flow. 

Answer not found

Triggered when the Anthropic couldn't generate a response (answer). This can be due to the following reason.

  1. No relevant knowledge is identified
  2. Anthropic cannot generate a usable response
Configurations
  1. Add a text/message to be displayed when the "Answer not found case is triggered.
  2. Follow-up action - Add buttons as per your preference for this case. Initially, the answers will be displayed, followed by these buttons. Each button will have a separate leg to handle the flow. 

Ratings

Enable feedback collection for each response. This will collect the rating for a response. 

  1. Displays thumbs up / thumbs down options
  2. Allows users to rate each answer
Warning
Note: Ratings are supported only for the Web and Mobile SDKs. Social channels don't support this.
Trigger actions based on ratings:
Define automated actions via plugs based on rating patterns.
  1. Occurrence Count - Number of ratings required to trigger an action
  2. Mode (one at a time): 
    1. Consecutively - Back-to-back ratings
    2. Entire chat - Across the full conversation
Info
Unrated messages are not considered positive or negative.

Plug Configuration

  1. Select a plug
  2. Map required parameters
  3. Trigger actions such as notifications, escalations, or workflows

Finally, click Save to apply the configuration.

Google AI
Alert
To use Google AI models, SalesIQ-Google AI integration is mandatory
Choose an Google AI model to continue.


Input 

Define what input (questions) is sent to the card from the visitor/user. Based on this, Google AI will generate answers. 

Available options

  1. Use visitor’s last message - Uses the most recent user input, including responses from buttons, text inputs, or selection cards. Ensure the previous step captures meaningful input to avoid irrelevant answers.
  2. Choose context variable - Use data stored from earlier steps in the flow.
  3. Ask the visitor for input - Prompt the user with a question and use their response as input.

Training

Define the data source used to generate responses.

Knowledge sources (select one):
  1. SalesIQ resources:
    1. The card uses SalesIQ's Articles, FAQs, Webpages, and Small Talks
    2. Select specific resources or combinations based on your use case.
    3. Training Status: Click on "Resource training status" to view training status for each resource. If a resource is not trained, you can retry training

  1. Zoho Desk resources
    1. The bot uses the Desk's knowledge base.
    2. Zia should be enabled in the Zoho Desk (Setup > General > Zia > and enable Ticket Reply Assistant).
    3. A minimum of 30 articles is required in the Desk Knowledge base for this card to work. 
    4. Zoho Desk integration is mandatory to select the Zoho Desk resource/knowledge base for the bot. 
    5. The card uses the articles from the desk department that is mapped to the bot's department under integration configuration.  
    6. So, ensure to map the essential desk department with SalesIQ in the SalesIQ-Desk Integration page. 

Global Data 

Enable global data to handle broader, non-business-specific queries.

  1. Define keywords (tags) to guide the AI toward better contextual search.
  2. Example - "Trending shoes"
  3. Use case - You own a shoe shop, when a visitor asks a general query like “What are the trending shoes for GenZ?”, the AI uses these tags to understand the context and generate a relevant response, even if the query is not strictly business-specific.
Notes
Supports up to 20 tags, each with 20 characters.

This allows the bot to respond to general queries while still prioritizing business context.


Response

Define how responses are handled and presented to the visitor/user.

Waiting State

  1. While Google AI generates a response, you can display interim messages. Example: “Searching…”, “Fetching best match…”, "Putting it together".
  2. Supports up to 3 messages, displayed sequentially in a loop. 

Answer found

Triggered when Google AI generates a response (answer) using a knowledge-backed context. 

Configurations

  1. Allow answer streaming - Streams responses in real time as they are generated, reducing perceived wait time.
  2. List reference sources - Displays the resources used to generate the answer in list.
    1. Title for source list - Title to display before the reference. Example: “Know more:”
  3. Follow-up action - Add buttons as per your preference for this case. Initially, the answers will be displayed, followed by these buttons. Each button will have a separate leg to handle the flow. 

Answer not found

Triggered when the Google AI couldn't generate a response (answer). This can be due to the following reason.

  1. No relevant knowledge is identified
  2. Google AI cannot generate a usable response
Configurations
  1. Add a text/message to be displayed when the "Answer not found case is triggered.
  2. Follow-up action - Add buttons as per your preference for this case. Initially, the answers will be displayed, followed by these buttons. Each button will have a separate leg to handle the flow. 

Ratings

Enable feedback collection for each response. This will collect the rating for a response. 

  1. Displays thumbs up / thumbs down options
  2. Allows users to rate each answer
Warning
Note: Ratings are supported only for the Web and Mobile SDKs. Social channels don't support this.
Trigger actions based on ratings:
Define automated actions via plugs based on rating patterns.
  1. Occurrence Count - Number of ratings required to trigger an action
  2. Mode (one at a time): 
    1. Consecutively - Back-to-back ratings
    2. Entire chat - Across the full conversation
Info
Unrated messages are not considered positive or negative.

Plug Configuration

  1. Select a plug
  2. Map required parameters
  3. Trigger actions such as notifications, escalations, or workflows

Finally, click Save to apply the configuration.

DeepSeek
Alert
To use DeekSeek models, SalesIQ-DeekSeek integration is mandatory
Choose an DeekSeek model to continue.


Input 

Define what input (questions) is sent to the card from the visitor/user. Based on this, AI will generate answers. 

Available options

  1. Use visitor’s last message - Uses the most recent user input, including responses from buttons, text inputs, or selection cards. Ensure the previous step captures meaningful input to avoid irrelevant answers.
  2. Choose context variable - Use data stored from earlier steps in the flow.
  3. Ask the visitor for input - Prompt the user with a question and use their response as input.

Training

Define the data source used to generate responses.

Knowledge sources (select one):
  1. SalesIQ resources:
    1. The card uses SalesIQ's Articles, FAQs, Webpages, and Small Talks
    2. Select specific sources or combinations based on your use case.
    3. Training status: Click on "Resource training status" to view training status for each resource. If a resource is not trained, you can retry training

  1. Zoho Desk resources
    1. The card uses the Desk's knowledge base.
    2. Zia should be enabled in the Zoho Desk (Setup > General > Zia > and enable Ticket Reply Assistant).
    3. A minimum of 30 articles is required in the Desk Knowledge base for this card to work. 
    4. Zoho Desk integration is mandatory to select the Zoho Desk resource/knowledge base for the bot. 
    5. The card uses the articles from the desk department that is mapped to the bot's department under integration configuration.  
    6. So, ensure to map the essential desk department with SalesIQ in the SalesIQ-Desk Integration page. 

Global Data 

Enable global data to handle broader, non-business-specific queries.

  1. Define keywords (tags) to guide the AI toward better contextual search.
  2. Example - "Trending shoes"
  3. Use case - You own a shoe shop, when a visitor asks a general query like “What are the trending shoes for GenZ?”, the AI uses these tags to understand the context and generate a relevant response, even if the query is not strictly business-specific.
Notes
Supports up to 20 tags, each with 20 characters.

This allows the bot to respond to general queries while still prioritizing business context.


Response

Define how responses are handled and presented to the visitor/user.

Waiting state
  1. While DeekSeek generates a response, you can display interim messages. Example: “Searching…”, “Fetching best match…”, "Putting it together".
  2. Supports up to 3 messages, displayed sequentially in a loop. 

Answer found

Triggered when DeekSeek generates a response (answer) using a knowledge-backed context. 

Configurations

  1. Allow answer streaming - Streams responses in real time as they are generated, reducing perceived wait time.
  2. List reference sources - Displays the resources used to generate the answer in list.
    1. Title for source list - Title to display before the reference. Example: “Know more:”
  3. Follow-up action - Add buttons as per your preference for this case. Initially, the answers will be displayed, followed by these buttons. Each button will have a separate leg to handle the flow. 

Answer Not Found

Triggered when the DeekSeek couldn't generate a response (answer). This can be due to the following reason.

  1. No relevant knowledge is identified
  2. DeekSeek cannot generate a usable response
Configurations
  1. Add a text/message to be displayed when the "Answer not found case is triggered.
  2. Follow-up action - Add buttons as per your preference for this case. Initially, the answers will be displayed, followed by these buttons. Each button will have a separate leg to handle the flow. 

Ratings

Enable feedback collection for each response. This will collect the rating for a response. 

  1. Displays thumbs up / thumbs down options
  2. Allows users to rate each answer
Warning
Note: Ratings are supported only for the Web and Mobile SDKs. Social channels don't support this.
Trigger actions based on ratings:
Define automated actions via plugs based on rating patterns.
  1. Occurrence Count - Number of ratings required to trigger an action
  2. Mode (one at a time): 
    1. Consecutively - Back-to-back ratings
    2. Entire chat - Across the full conversation
Info
Unrated messages are not considered positive or negative.

Plug Configuration

  1. Select a plug
  2. Map required parameters
  3. Trigger actions such as notifications, escalations, or workflows

Finally, click Save to apply the configuration.

Custom Service

Use Custom Service to connect your own AI or any third-party AI that is not natively supported in SalesIQ, using REST APIs.

Input

Define the input (question) sent to your AI via the API.

Available options:

  1. Use visitor’s last message - Uses the most recent user input, including responses from buttons, text inputs, or selection cards. Ensure the previous step captures meaningful input to avoid irrelevant answers.
  2. Choose context variable - Use data stored from earlier steps in the flow.
  3. Ask the visitor for input - Prompt the user with a question and use their response as input.

Info
The visitor/user input will be available under the %visitor_message% variable. 

Include resources (Optional)

You can pass SalesIQ or Zoho Desk knowledge base resources to your API. This is to provide context to your AI before generating a response.

Knowledge sources (select one):
  1. SalesIQ resources:
    1. The AI gets SalesIQ's Articles, FAQs, Webpages, and Small Talks
    2. Select specific sources or combinations based on your use case.
    3. Training Status: Click on the "Resource training status" to view training status for each resource. If a resource is not trained, you can retry training

  1. Zoho Desk resources
    1. The AI gets the Desk's knowledge base.
    2. Zia should be enabled in the Zoho Desk (Setup > General > Zia > and enable Ticket Reply Assistant).
    3. A minimum of 30 articles is required in the Desk Knowledge base for this card to work. 
    4. Zoho Desk integration is mandatory to select the Zoho Desk resource/knowledge base for the bot. 
    5. The AI uses the articles from the desk department that is mapped to the bot's department under integration configuration.  
    6. So, ensure to map the essential desk department with SalesIQ in the SalesIQ-Desk Integration page. 

Info
The relevant resources will be retrieved and ready to be passed to the AI via the %training_resource% variable. 

Request configuration

Configure how the API request is sent to the AI.

AlertNote: API timeout is 5 seconds. Use asynchronous handling for longer responses.
  1. Method - Choose the request type (GET, POST, PUT, DELETE)
  2. URL - Enter the API endpoint.
  3. Headers - Add required headers (e.g., authentication, content type).
    1. Click Configure
    2. Enter parameter name and value
    3. Values can be mapped from context variables or entered manually.

  1. Query parameters - Add parameters to the URL.
    1. Click Configure
    2. Enter parameter name and value
    3. Values can be mapped from context variables or entered manually.
  2. Body parameters - Define the request payload based on the API.
    1. Click Configure to open the JSON builder and define your payload.
Info
The following variables are available for use in headers, query parameters, and body parameters. Use them based on your requirements:
  1. %visitor_message%  - The value of the visitor/user's input
  2. %training_resource% – Retrieved resources based on the input (if enabled)
  1. Connections Connections handle authentication securely. Instead of adding credentials directly in the card, link your request to an existing connection created through the Data Resource Environment (DRE). If needed, click Add to create a new connection. All authentication-based connections are managed under DRE, ensuring a secure and centralized setup. 

Asynchronous request requirements

When using asynchronous handling, ensure the following while sending the request:
  1. Include the conversation ID so the system can identify which chat the response belongs to. Use %active_conversation_id% variable to pass the current conversation ID. 
  2. Include a verification key (key–value pair) for response authorization.
    1. Example: "verification_key": "s9s89sdhfsljkgmow0823badokejorp"
These can be passed in the header, query parameters, or body of the request.

Response handling

Waiting State
  1. While the AI generates a response, you can display interim messages. Example: “Searching…”, “Fetching best match…”, "Putting it together".
  2. Supports up to 3 messages, displayed sequentially in a loop. 

Asynchronous response handling (optional)

Enable Get Asynchronous Response if your API responds via a callback instead of returning a response immediately. Use this when your API cannot respond within the 5-second timeout.

When sending the request, the conversation id (%active_conversation_id%) and a key-value pair for the authorization should be sent. Use the URL below as a callback once the AI generates the response. 

Response via callback
  1. Once your API generates a response, send it to: 
  1. Replace <id> with the same conversation ID received in the request.
  2. Include the same verification key in the response.
Response authorization:
To ensure the response is valid and secure:
  1. Request parameter - Select the parameter used to send the verification key in the request (query, header or body).
  1. Response parameter - Specify the parameter in the response that carries the same value. In the below API response, the "verificationKey" holds the value sent from the request. 
  1. {
  2.   "status": "success",
  3.   "data": {
  4.     "startTime": 1778565755849,
  5.     "endTime": 1778565757485,
  6.     "request": {
  7.       "message": "Hi, I need some help with my recently raised issue.",
  8.     },
  9.     "response": "Good morning! Could you please provide me with your email address and a brief description of the issue you're facing? This will help me find the correct ticket and provide you with the assistance you need.",
  10.   },
  11.   "timestamp": "2026-05-12T06:02:37.490758258Z",
  12.   "verificationKey": "s9s89sdhfsljkgmow0823badokejorp"
  13. }
  1. Use dot notation to access nested values (e.g., data.<key-name>).
The system compares the conversation ID (request vs response) and the authorization value (request vs response). 
  1. If both match, the response is accepted and displayed.
  2. Upon a mismatch, the failure leg is triggered.

Answer handling

Answer found

Triggered when a valid response is received.

  1. Response parameter - Specify the parameter containing the answer. Use dot notation to access nested values (e.g., data.response.text).
  2. Follow-up action - Add buttons as per your preference for this case. Initially, the answers will be displayed, followed by these buttons.  
  3. Each button will have a separate leg to handle the flow. 

Answer not found

Triggered when an invalid response is received. AI may sometimes return empty, fallback, or technical responses (e.g., due to uncertainty, token limits, or processing issues). Displaying such responses directly can lead to a poor user experience.

To handle this, define conditions to identify invalid responses and route them to the Answer Not Found flow.

  1. Enter the response parameter (from the API response body). Use dot notation to access nested values (e.g., data.response.text).
  2. Define conditions to detect invalid responses
    1. Check for empty responses
    2. Check for specific failure text using conditions (e.g., contains)
Example: Instruct your AI to return a fixed string during failure“Cannot generate answer”. Then configure a condition.
  1. If the "data.response.text" contains “Cannot generate answer” - this will trigger the Answer not found case. 
Message & follow-up buttons
  1. Text - Add a text to handle the Answer not found case. 
  2. Follow-up action - Add buttons as per your preference for this case. Initially, the answers will be displayed, followed by these buttons.  
  3. Each button will have a separate leg to handle the flow. 

Ratings

Enable feedback collection for each response. This will collect the rating for a response. 

  1. Displays thumbs up / thumbs down options
  2. Allows users to rate each answer
Warning
Note: Ratings are supported only for the Web and Mobile SDKs. Social channels don't support this.
Trigger actions based on ratings:
Define automated actions via plugs based on rating patterns.
  1. Occurrence Count - Number of ratings required to trigger an action
  2. Mode (one at a time): 
    1. Consecutively - Back-to-back ratings
    2. Entire chat - Across the full conversation
Info
Unrated messages are not considered positive or negative.

Plug Configuration

  1. Select a plug
  2. Map required parameters
  3. Trigger actions such as notifications, escalations, or workflows

Finally, click Save to apply the configuration.

After saving, the card is added to the bot builder canvas. It includes flow paths for:

  • Answer found - follow up buttons
  • Answer not found - follow up buttons
  • Default failure (for technical issues)

You can continue building the bot flow based on these paths.

ChatGPT

The ChatGPT card allows getting responses from the OpenAI (ChatGPT) for the visitor's questions. To use this card, OpenAI-SalesIQ integration is mandatory. 
  1. To add the card to the flow, click on the cardholder icon (+) and choose ChatGPT under the AI cards section.

  1. Provide a name for the card
  2. Next, select a ChatGPT service for the card. You can choose between a GPT model or an Assistant:
    1. GPT Model: Supported models include GPT-3.5 Turbo and GPT-4. Select the one that best suits your requirements.

    1. Assistant: If you have already created an Assistant in your OpenAI portal, you can connect it to Zoho SalesIQ under the ChatGPT Assistant Configuration. Once configured, you can add the Assistant to this card.

  1. Then, choose the card input:
    1. Use the visitor's latest response - The last visitor's response to the bot will be taken as the card input. 

    1. Choose a context variable - Allows to choose an existing bot context variable from any card. (Visitor's response to a specific card can be saved in context variable and used as input)

    1. Saving the visitor's response in the (visitor.issue) context variable.

    1. Prompt the visitor for an input - Allows the bot to send a message, prompt the visitors for a response and use it as input. 

  1. Next, if required, provide a command to make ChatGPT behave based on a specific function(s). Example command: If "Rephrase, grammar check" is given as a command, ChatGPT will rephrase and check the spelling of the provided input.

  1. Then, click on Add action to provide the follow-up actions. 
  2. Finally, click on Save
Notes
Note: This ChatGPT models are not trained with your knowledge base/resources. 
Here is the output for the different input cases: