नेविगेशन पर जाएँ
इंटीग्रेशंससेटअप गाइड्ससपोर्ट

Freshdesk

webhook टूल से कॉल से Freshdesk टिकट बनाएं।

वेबहुक टूल के साथ, जब भी कोई कॉलर किसी समस्या की जानकारी देता है या मदद मांगता है, आपका रिसेप्शनिस्ट Freshdesk टिकट खोल सकता है, ताकि आपकी टीम उसे संभाल सके। Growth, Pro और Enterprise प्लान पर, मौजूदा टिकट देखने के लिए आप Freshdesk का MCP सर्वर भी कनेक्ट कर सकते हैं।

टिकट बनाएं

1

अपनी API कुंजी पाएं

Freshdesk में अपनी प्रोफ़ाइल तस्वीर चुनें, Profile settings खोलें और View API key चुनें। कुंजी कॉपी करें। यह आपके एजेंट अकाउंट की तरह काम करती है, इसलिए टिकट आपकी अनुमतियों के साथ बनाए जाते हैं।

2

ऑथराइज़ेशन हेडर बनाएं

Freshdesk में API कुंजी यूज़रनेम होती है और X पासवर्ड होता है। टर्मिनल में इसे एन्कोड करें और YOUR_API_KEY को अपनी कुंजी से बदलें:

printf 'YOUR_API_KEY:X' | base64

हेडर वैल्यू Basic के बाद आउटपुट होती है।

अपनी API कुंजी किसी ऑनलाइन एन्कोडर में पेस्ट न करें। कुंजी या एन्कोडेड हेडर रखने वाला कोई भी व्यक्ति आपके टिकट पढ़ और बदल सकता है।

3

वेबहुक टूल बनाएं

Integrations पर जाएं, Add integration चुनें और Webhook Tool चुनें।

फ़ील्डवैल्यू
नामcreate_freshdesk_ticket
विवरण”कॉलर द्वारा समस्या की जानकारी देने या टीम से मदद मांगने पर सपोर्ट टिकट खोलें।“
मेथडPOST
URLhttps://YOURDOMAIN.freshdesk.com/api/v2/tickets
रिक्वेस्ट हेडर्सAuthorization: Basic के बाद एन्कोड की गई कुंजी
बॉडी पैरामीटर्सname (string, आवश्यक): “कॉलर का पूरा नाम।”
phone (string): “कॉलर का फ़ोन नंबर।”
email (string): “कॉलर का ईमेल पता, अगर उन्होंने दिया हो।”
subject (string, आवश्यक): “समस्या का संक्षिप्त सारांश।”
description (string, आवश्यक): “कॉलर ने जो बताया, उन्हीं के शब्दों में, साथ ही उनके दिए गए विवरण।”
status (number, आवश्यक): “हमेशा सटीक वैल्यू 2।”
priority (number, आवश्यक): “हमेशा सटीक वैल्यू 1।”
source (number, आवश्यक): “हमेशा सटीक वैल्यू 3।“
एजेंट्स को असाइन करेंReceptionist

YOURDOMAIN को अपने Freshdesk सबडोमेन से बदलें। Enable चुनें।

4

इसे टेस्ट करें

किसी समस्या की जानकारी देकर अपने रिसेप्शनिस्ट को टेस्ट करें। टिकट Freshdesk में दिखाई देगा।

निश्चित वैल्यू टिकट को Open (status 2) और Low प्राथमिकता (priority 1) के साथ बनाती हैं, और इसे Phone (source 3) से आया हुआ चिह्नित करती हैं। रिसेप्शनिस्ट को प्राथमिकता सेट करने देने के लिए, वैल्यू के बजाय उनका विवरण लिखें, जैसे: “कम के लिए 1, मध्यम के लिए 2, उच्च के लिए 3, तुरंत के लिए 4।”

रिक्वेस्टर को खोजने या बनाने के लिए Freshdesk को फ़ोन नंबर या ईमेल चाहिए। अपने रिसेप्शनिस्ट को हमेशा कॉलर का फ़ोन नंबर लेने के लिए कहें।

MCP सर्वर से टिकट देखें

Freshdesk का MCP सर्वर Growth, Pro और Enterprise प्लान पर उपलब्ध है। अपने रिसेप्शनिस्ट को कॉलर के मौजूदा टिकट देखने देने के लिए इसका इस्तेमाल करें। MCP ऐक्शन आपकी प्लान पर निर्भर सालाना सीमा में गिने जाते हैं।

Reception.ai में Integrations पर जाएं, Add integration चुनें और MCP Server चुनें।

फ़ील्डवैल्यू
नामFreshdesk
सर्वर टाइपStreamable HTTP
सर्वर URLhttps://YOURDOMAIN.freshdesk.com/mcp
HTTP हेडर्सAuthorization: आपकी API कुंजी, बिना प्रीफ़िक्स

Secret Token खाली छोड़ें, ताकि Reception.ai आपका Authorization हेडर ठीक वैसे ही भेजे जैसा आपने दर्ज किया है। कस्टम डोमेन होने पर भी अपना freshdesk.com सबडोमेन इस्तेमाल करें। Enable चुनें।

Tools टैब खोलें और टिकट देखने वाले टूल, जैसे fetchSearchTickets और fetchTicket, को Client (रिसेप्शनिस्ट) को असाइन करें। टिकट, एजेंट्स, ग्रुप्स या आर्टिकल अपडेट करने वाले टूल असाइन न करें।

समस्या निवारण

समस्याक्या जांचें
Freshdesk से 401कुंजी के बाद :X लगाकर एन्कोड करें, और हेडर वैल्यू की शुरुआत Basic और एक स्पेस से करें।
रिक्वेस्टर के बारे में 400टिकट के लिए नाम के साथ फ़ोन नंबर या ईमेल चाहिए। सुनिश्चित करें कि रिसेप्शनिस्ट इन्हें लेता है।
status या priority के बारे में 400status, priority और source string नहीं, number पैरामीटर्स होने चाहिए।
MCP सर्वर में कोई टूल नहीं दिखताअपना freshdesk.com सबडोमेन इस्तेमाल करें और Authorization हेडर में बिना Basic या Bearer के कच्ची API कुंजी डालें।