ویب ہکس: ٹیلیگرام میسجز CRM اور اپنے سرور پر بھیجیں

کبھی کبھی میسجز کسی دوسرے چینل میں نہیں بلکہ آپ کے اپنے سسٹم میں چاہئیں: CRM، نالج بیس، اینالیٹکس یا آپ کا اپنا بوٹ۔ اس کے لیے پائپ لائن میں ویب ہکس ہیں — ہر ڈیلیور ہونے والے میسج پر آپ کے ایڈریس کو بھیجی جانے والی HTTP ریکویسٹس۔

سیٹ اپ #

1. “ویب ہکس” سیکشن میں اپنی سروس کا ایڈریس شامل کریں، مثلاً https://crm.example.com/telegram.
2. پائپ لائن ایڈیٹر میں اس ویب ہک پر نشان لگائیں۔
3. ویب ہک کا سیکرٹ کاپی کر لیں — دستخط کی تصدیق کے لیے یہ ضروری ہے۔

پائپ لائن میسجز صرف ویب ہک پر بھی بھیج سکتی ہے، کسی وصول کنندہ چینل کے بغیر۔

کیا موصول ہوتا ہے #

ہر میسج پر (البم ایک ہی ریکویسٹ میں) JSON کے ساتھ POST آتا ہے:

{
  "pipeline_id": 12,
  "account_id": 3,
  "chat_id": -1001234567890,
  "messages": [{
    "id": 4521,
    "date": 1791936000,
    "text": "تازہ ترین خبر",
    "entities": [{"type": "bold", "offset": 0, "length": 9}],
    "media": {"type": "photo", "url": "https://cpo.st/m/…", "mime_type": "image/jpeg"}
  }]
}

ٹیکسٹ پائپ لائن کے فلٹرز اور تبدیلیوں کے بعد پہنچتا ہے۔ میڈیا لنکس کی صورت میں بھیجا جاتا ہے: فائل پہلی بار کھولنے پر ڈاؤن لوڈ ہوتی ہے اور 7 دن تک دستیاب رہتی ہے۔

دستخط کی تصدیق #

ہر ریکویسٹ پر دستخط ہوتا ہے: ہیڈر X-Copyposter-Signature میں ویب ہک کے سیکرٹ کے ساتھ اسٹرنگ <X-Copyposter-Timestamp>.<ریکویسٹ باڈی> کا HMAC-SHA256 ہوتا ہے۔ Python میں تصدیق:

import hmac, hashlib, time

def verify(secret: str, timestamp: str, body: bytes, signature: str) -> bool:
    if abs(time.time() - int(timestamp)) > 300:
        return False  # پرانی ریکویسٹ — ممکن ہے دوبارہ بھیجی گئی ہو
    expected = "sha256=" + hmac.new(secret.encode(), timestamp.encode() + b"." + body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature)

قابلِ اعتماد ڈیلیوری #

اگر سروس دستیاب نہ ہو یا 429/5xx جواب دے تو CopyPost ریکویسٹ 1 سیکنڈ، 5 سیکنڈ، 30 سیکنڈ، 2 منٹ اور 10 منٹ بعد دوبارہ بھیجے گا۔ 2xx جلدی واپس کریں اور بھاری پروسیسنگ بیک گراؤنڈ میں کریں۔

ایڈریس پبلک ہونا چاہیے: ویب ہکس لوکل اور اندرونی ایڈریسز پر نہیں بھیجے جاتے۔

حدود #

ماہانہ 1000 ریکویسٹس مفت، اس کے بعد 10 000 ریکویسٹس کے پیکج۔ موجودہ استعمال “پلان” صفحے پر نظر آتا ہے۔