Bilgi tabanı

hotline.tg

Hotline Topics API (V1)

Topics API entegrasyon için tasarlandı Hotline Telegram CRM harici sistemlerle. Bu belge arayüzün ana yöntemlerini açıklamaktadır.
Ana yöntem, arka uç grup tarafında konunun kaynağı hakkında bilgi almanızı sağlar. Bir konuya gelen mesajın gönderilmesi için de bir yöntem vardır. user_id kullanıcı.
Sistemin işlevselliğini genişletme örnekleri Hotline ile Topics API asistan botunuz aracılığıyla ayrı bir makalede anlatılmaktadır.
Not: Bu sayfada otomatik çeviriye sahip parçalar bulunmaktadır. Bu bilgileri anlamakta zorluk çekiyorsanız, dili İngilizce veya Rusça'ya çevirip güvendiğiniz web sitesi çeviri sistemini kullanmayı deneyebilirsiniz.
Arayüz adresi
https://n8n.production.hotline.tg/webhook/topic_action
  • Yalnızca işlemler POST istekleri
  • Şu anda arayüze erişmek için bir Başlığa sahip olmak gerekiyor x-api-key, verilen jetonu gösterir destek servisi
  • Her örneğin kendine ait api_keyki bu ortaya çıkıyor @hotlinetg_bot her örnek için ve doğrudan JSON isteklerinin gövdesinde belirtilen
Yöntem 1: Konuyla ilgili mevcut bilgiler
Örnek istek:
{
    "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"
}
Bir kullanıcı için örnek yanıt:
{
    "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"
}
Gruplar için örnek yanıt:
{
    "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"
}
Özellikler:
  1. Topic_status'un 3 değeri vardır: 'closed', 'user_answered', 'support_answered' (konu başlığında sırasıyla siyah, mor ve sarı karelerle gösterilir)
  2. Frontend_type türleri: özel (normal kullanıcı), bot, gizli, grup, süper grup, konu, kanal
  3. Şimdilik yalnızca şu konular için eksiksiz bilgi verilmektedir: özel, bot, gizli
  4. Bir arka uç grubuna birden fazla örnek eklenmişse gruptaki konular hakkında bilgi edinmek için bunlardan herhangi birini kullanabilirsiniz (belirli bir konunun örneği ilgili yanıt alanlarında gösterilecektir).
Yöntem 2: Konuya gelen ileti: user_id
Örnek istek:
{
    "action": "incoming_in_topic",
    "user_id": $USER_ID1,
    "message": "/ `test` *incoming* _message_ \n\n [@hotlinetg_support]",

    "instance": "$INSTANCE",
    "api_key": "$KEY"
}
Cevap örneği:
{
    "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"
}
Erişim elde etme Topics API
Almak için x-api-key jeton API'ye erişmek veya entegrasyon ve destek maliyetini hesaplamak için desteğe yazmanız gerekir @hotlinetg_support.