ज्ञानधार

hotline.tg

Hotline Topics API (V1)

Topics API एकीकरण के लिए डिज़ाइन किया गया Hotline Telegram CRM बाहरी सिस्टम के साथ. यह दस्तावेज़ इंटरफ़ेस की मुख्य विधियों का वर्णन करता है।
मुख्य विधि आपको बैकएंड समूह की ओर से विषय के स्रोत के बारे में जानकारी प्राप्त करने की अनुमति देती है। किसी विषय पर आने वाले संदेश को भेजने की भी एक विधि है user_id пользователя.
सिस्टम की कार्यक्षमता के विस्तार के उदाहरण Hotline साथ Topics API आपके सहायक बॉट के माध्यम से एक अलग लेख में वर्णित है.
ध्यान दें: इस पृष्ठ में स्वचालित अनुवाद के साथ अंश हैं। यदि आपको यह जानकारी समझने में कठिनाई हो रही है, तो भाषा को अंग्रेजी या रूसी में बदलने का प्रयास करें और अपनी विश्वसनीय वेबसाइट अनुवाद प्रणाली का उपयोग करें।
इंटरफ़ेस पता
https://n8n.production.hotline.tg/webhook/topic_action
  • केवल प्रक्रियाएं POST अनुरोध
  • फिलहाल इंटरफ़ेस तक पहुंचने के लिए हेडर का होना जरूरी है x-api-key, जो जारी किए गए टोकन को इंगित करता है सपोर्ट सेवा
  • प्रत्येक उदाहरण का अपना भी होता है api_key, जो बन जाता है @hotlinetg_bot प्रत्येक उदाहरण के लिए, और जो सीधे JSON अनुरोधों के मुख्य भाग में दर्शाया गया है
विधि 1: विषय पर उपलब्ध जानकारी
उदाहरण अनुरोध:
{
    "action": "info_by_topic",
    "group_id": "2101424779", # as it appers in topic public link (without -100)
    "topic_id": "$TOPIC_ID",  # as it appers in topic public link

    "instance": "$INSTANCE",
    "api_key": "$KEY"
}
उपयोगकर्ता के लिए उदाहरण प्रतिक्रिया:
{
    "result": "topic_info",
    "group_id": $GROUP_ID,
    "topic_id": $TOPIC_ID,

    "frontend_type": "private",
    "instance_name": "$INSTANCE_NAME",
    "instance_frontend_user_id": $INSTANCE_FRONTEND_USER_ID,
    "instance_id": $INSTANCE_ID,

    "chat_id": $CHAT_ID,
    "thread_id": $THREAD_ID,

    "topic_last_date": "$LAST_DATE",
    "topic_status": "$STATUS",
    "topic_title": "$TITLE",

    "user_id": $USER_ID,
    "user_name": "$NAME",
    "user_first_name": "$FNAME",
    "user_last_name": "$LNAME",
    "user_username": "$USERNAME",
    "user_lang": "None",
    "user_phone": "None"
}
समूहों के लिए उदाहरण प्रतिक्रिया:
{
    "result":"topic_info",

    "group_id": $GROUP_ID,
    "topic_id": $TOPIC_ID,

    "frontend_type": "group",
    "instance_name": "$INSTANCE_NAME",
    "instance_frontend_user_id": $INSTANCE_FRONTEND_USER_ID,
    "instance_id": $INSTANCE_ID,

    "frontend_chat_id": $CHAT_ID,

    "topic_last_date": "$LAST_DATE",
    "topic_status": "$STATUS",
    "topic_title": "$TITLE"
}
विशेषताएं:
  1. Topic_status में 3 मान हैं: 'बंद', 'user_answered', 'support_answered' (विषय शीर्षक में क्रमशः काले, बैंगनी और पीले वर्ग के रूप में दिखाया गया है)
  2. फ्रंटएंड_टाइप के प्रकार: निजी (नियमित उपयोगकर्ता), बॉट, गुप्त, समूह, सुपरग्रुप, विषय, चैनल
  3. अभी, पूरी जानकारी केवल निम्नलिखित विषयों के लिए प्रदान की गई है: निजी, बॉट, गुप्त
  4. यदि एक बैकएंड समूह में कई उदाहरण जुड़े हुए हैं, तो आप समूह में विषयों के बारे में जानकारी प्राप्त करने के लिए उनमें से किसी का भी उपयोग कर सकते हैं (किसी विशिष्ट विषय का उदाहरण संबंधित प्रतिक्रिया फ़ील्ड में दिखाया जाएगा)
विधि 2: विषय पर आने वाला संदेश user_id
उदाहरण अनुरोध:
{
    "action": "incoming_in_topic",
    "user_id": $USER_ID1,
    "message": "/ `test` *incoming* _message_ \n\n [@hotlinetg_support]",

    "instance": "$INSTANCE",
    "api_key": "$KEY"
}
उत्तर उदाहरण:
{
    "result": "message_sent",
    "topic_link": "https://t.me/c/2101424779/1591",
    "message": "/ `test` *incoming* _message_ \n\n [@hotlinetg_support]",
    "chat_id": $CHAT_ID,
    "thread_id": "$THREAD_ID"
}
तक पहुँच प्राप्त करना Topics API
प्राप्त करने के लिए x-api-key टोकन एपीआई तक पहुंचने के लिए, या एकीकरण और समर्थन की लागत की गणना करने के लिए, आपको समर्थन को लिखना होगा @hotlinetg_support.