Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/arainey2022/myaskai-docs/llms.txt

Use this file to discover all available pages before exploring further.

My AskAI offers two separate Freshworks integrations that work independently or together: Freshchat for real-time conversation handling in your live chat widget, and Freshdesk for AI-powered responses to incoming email and form-based support tickets. Both integrations require no code on your website and are available on paid My AskAI plans.
Freshchat requires a Freshchat Pro plan or above. Freshdesk is available on any paid Freshdesk plan. You can use both integrations simultaneously, but AI Tagging can only be configured for one of them at a time — not both.

Freshchat is Freshworks’ real-time messaging platform. My AskAI integrates as a conversational AI agent inside the Freshchat widget, responding to customers instantly using your knowledge base.

Connecting Freshchat

1

Open Channels in My AskAI

Log in to your Dashboard and go to Channels. Under “Add to helpdesk”, click the Freshworks icon and select Freshchat.
2

Enter API credentials

Enter your API key and Chat URL from Freshchat. Find them in your Freshchat dashboard at Admin Settings > Marketplace and Integrations > API Settings > API details for chat. Click Connect your Freshchat account.
3

Enable the webhook

In your Freshchat dashboard, go to Admin Settings > Marketplace and Integrations > Conversation Webhooks and toggle from Disabled to Enabled. Paste in the webhook URL from My AskAI: https://ask.myaskai.com/projects/webhooks/freshchat
4

Verify the connection

Send a test message to your Freshchat widget. The My AskAI setup page will show “Webhook successfully setup” to confirm.
5

Choose a reply mode

By default, the AI creates draft note replies. To have it reply directly to customers, go to Channels > Freshworks > Freshchat and toggle Direct replies on.
Before connecting, ensure you have turned off Freddy AI (Freshworks’ native AI agent) to prevent conflicting replies.

Reply Modes

Direct Replies

The AI replies directly to customers in the Freshchat widget. Best for teams that want full automation. New conversations transfer back to the AI after a conversation is resolved and the threading interval has passed.

Note Replies

The AI creates an internal note after each customer message for agents to review and send. Ideal when you want AI assistance without full automation.

Human Escalation

When a user says “Talk to a person” (or similar), or the AI cannot answer, it escalates automatically. On escalation:
  • An internal note is added to the conversation summarising the chat for the incoming agent.
  • If you’ve set up the AI Chat Status conversation property, it updates to human-handover-requested.
  • The AI stops responding for the rest of that conversation.
Auto-assign escalated conversations: Create a Conversation Assignment Rule in Freshchat (Admin Settings > Configurations and Workflows > Workflows > Conversation Assignment Rules) that targets conversations where AI Chat Status = human-handover-requested and routes them to the correct team or agent.

AI Chat Status Property

To track AI activity in your Freshchat inbox, create a conversation property:
  1. Go to Freshchat Admin Settings > Configuration and Workflow > Conversation Properties.
  2. Create a new Dropdown property called AI Chat Status with internal name ai_chat_status.
  3. The AI will automatically populate this field with one of three values:
    • ai-agent-replied — AI has sent a reply
    • human-handover-requested — escalation requested
    • ai-agent-tag-blocked — reply blocked by a tag rule

AI Tagging for Freshchat

1

Set up tagging

Go to AI Agent Setup > Auto-Tagging and click Import conversation property. Select a tag or custom field from Freshchat and click Import conversation property.
2

Review descriptions

Check and refine the auto-generated descriptions for each property value. Accuracy here directly affects tagging quality.
3

Enable auto-tagging

Toggle tagging on. Tags are applied automatically from that point forward.
4

Block replies by tag (optional)

In AI Agent Setup > AI Tagging, click Block next to any tag value to prevent the AI from responding to conversations with that topic. Blocked conversations are automatically escalated to a human.
Cost: $0.05 per conversation property per conversation, billed as an add-on.

Additional Options

SettingLocation
Prevent immediate escalationChannels > Freshworks > Freshchat
Auto-close inactive conversationsChannels > Freshworks > Freshchat
Triage / chatbot trigger phraseChannels > Freshworks > Freshchat (Chatbot/Triage toggle)
Hide “Just thinking…” messageChannels > Freshworks > Freshchat
Pause AI agentChannels > Freshworks > Freshchat

Required API Credentials

IntegrationCredentials Needed
FreshchatAPI Key + Chat URL (from Freshchat Admin Settings)
FreshdeskDomain subdomain + API Key (from Freshdesk Profile Settings)
Both integrations use API key authentication — no OAuth flow is required. My AskAI also creates a webhook in Freshchat and an Automation rule in Freshdesk automatically during setup.

Build docs developers (and LLMs) love