لاگ اِن کریںفری ٹرائل شروع کریں
easyCoexistence آفیشل APIs

گاہکوں کے WhatsApp میسجز اور سوشل کمنٹس ویب ہک کے ذریعے کیسے وصول کریں

ہر کنکشن کو easyCoexistence کے Partner API کے ذریعے گاہکوں کے WhatsApp میسجز یا سوشل کمنٹس کے لیے اپنا ویب ہک ملتا ہے۔ WhatsApp میسجز Meta سے براہ راست اس URL پر جاتے ہیں، جن پر دستخط Tech Provider ایپ کی خفیہ کلید سے ہوتے ہیں نہ کہ اس کلید سے جو آپ رکھتے ہیں، اس لیے URL کے پاتھ میں موجود ایک لمبی بے ترتیب خفیہ کلید انہیں تصدیق کرتی ہے۔ Instagram اور Facebook کے کمنٹس اور DMs، اور TikTok کے کمنٹس، جیسے ہی آتے ہیں آگے بھیجے جاتے ہیں، ہر اکاؤنٹ کی اپنی خفیہ کلید سے X-EC-Signature کے ساتھ دستخط شدہ۔

200 characters

Meta کی متبادل کال بیک URL کی زیادہ سے زیادہ لمبائی، جو کسی نمبر کے میسجز آپ کے اینڈ پوائنٹ پر بھیجتی ہے۔

7 days

Meta کتنی دیر تک ایسا WhatsApp ویب ہک دوبارہ بھیجتا ہے جسے آپ کا اینڈ پوائنٹ قبول نہیں کرتا، کم ہوتی تعدد کے ساتھ، جس سے ڈپلیکیٹس بن سکتے ہیں۔

AS32934

Meta کا نیٹ ورک؛ whois روٹ تلاش اس کے وہ پتے دکھاتی ہے جہاں سے WhatsApp ویب ہکس آتے ہیں، جنہیں Meta وقتاً فوقتاً بدلتا ہے۔

3 MB

Meta کے مطابق کسی WhatsApp ویب ہک پے لوڈ کی زیادہ سے زیادہ جسامت۔

5 minutes

وہ عمر جس کے بعد فارورڈ ایونٹ کا دستخط شدہ ٹائم اسٹیمپ مسترد ہونا چاہیے، اور HMAC کا موازنہ مستقل وقت میں کیا جائے۔

ہر کنکشن کو اپنا ویب ہک کیسے ملتا ہے؟

ہر ریسورس کے لیے ایک کال کے ذریعے۔ WhatsApp نمبر کے لیے PUT /connections/{id}/webhook کا استعمال ہوتا ہے، جس میں url اور verify_token ہوں، یا کنیکٹ سیشن پر یہی جوڑا webhook_url اور webhook_verify_token کے نام سے، تاکہ نمبر پہلے ہی منٹ سے آپ کی طرف روٹ ہو۔ سوشل اکاؤنٹ کے لیے کنیکٹ ہونے کے بعد PUT /channels/{id}/webhook ہے۔ دونوں میں سے کسی پر url کو null کرنے سے ڈیلیوری بند ہو جاتی ہے۔ دونوں راستے اس میں مختلف ہیں کہ ڈیلیور کون کرتا ہے اور آپ تصدیق کیسے کرتے ہیں:

WhatsApp numberInstagram, Facebook, TikTok
Set withwebhook_url on the session, or PUT /connections/{id}/webhookPUT /channels/{id}/webhook, after it connects
Delivered byMeta, straight to your URLeasyCoexistence, forwarding each event as it arrives
BodyMeta's webhook, unchangedplatform, account_id, external_id and the network's entry
AuthenticateA long random secret in the URL pathX-EC-Signature, keyed with the account's secret
RetriesMeta's own, for up to 7 daysNone: one attempt
Copy keptNoneNone

آپ کے نمبر کے میسجز کو اپنے اینڈ پوائنٹ پر کیسے بھیجیں؟

اسے ایک HTTPS URL دیں جس کے پاتھ میں ایک لمبی بے ترتیب خفیہ کلید ہو، ساتھ ایک verify ٹوکن بھی: کنیکٹ سیشن پر webhook_verify_token، 8 سے 200 حروف کا، یا PUT پر verify_token۔ Meta فوراً ایک GET کے ذریعے URL چیک کرتا ہے جس میں hub.mode=subscribe، hub.verify_token اور hub.challenge ہوتے ہیں، اور ٹوکن ملنے پر آپ کے اینڈ پوائنٹ کو hub.challenge کی قدر واپس کرنی ہوگی۔ اگر یہ ہینڈشیک ناکام ہو جائے تو PUT 502 meta_rejected کے ساتھ Meta کا اپنا پیغام واپس کرتا ہے؛ کنیکٹ سیشن پر نمبر پھر بھی کنیکٹ ہو جاتا ہے، اور سیشن کا last_error بتاتا ہے کہ URL کیوں لاگو نہیں ہوا۔

Node.js: Meta's handshake and the path secret
import express from "express";
import { timingSafeEqual } from "node:crypto";

const PATH_SECRET = process.env.WA_PATH_SECRET; // the random part of webhook_url
const VERIFY_TOKEN = process.env.WA_VERIFY_TOKEN; // the verify token you sent
const app = express();

function same(a, b) {
  const x = Buffer.from(String(a)), y = Buffer.from(String(b));
  return x.length === y.length && timingSafeEqual(x, y);
}

// Meta's handshake, run when the destination is set
app.get("/wa/:secret", (req, res) => {
  if (!same(req.params.secret, PATH_SECRET)) return res.sendStatus(404);
  if (req.query["hub.mode"] !== "subscribe" || !same(req.query["hub.verify_token"], VERIFY_TOKEN)) {
    return res.sendStatus(403);
  }
  res.send(req.query["hub.challenge"]);
});

// Messages, echoes and the one-time import; payloads reach 3 MB
app.post("/wa/:secret", express.json({ limit: "4mb" }), (req, res) => {
  if (!same(req.params.secret, PATH_SECRET)) return res.sendStatus(404);
  res.sendStatus(200); // answer first: Meta retries for up to 7 days
  enqueue(req.body); // deduplicate on each message id before acting
});

آپ Meta کے دستخط کی جانچ کیوں نہیں کر سکتے، اور اس کی جگہ کیا ہے؟

Meta ہر ڈیلیوری پر X-Hub-Signature-256 سے دستخط کرتا ہے، جو پے لوڈ کا HMAC-SHA256 ہوتا ہے جسے وصول کرنے والی ایپ کی App Secret سے تیار کیا گیا ہو۔ آپ کے گاہکوں کے نمبروں کے لیے وہ ایپ easyCoexistence کی Tech Provider ایپ ہے، اور اس کی خفیہ کلید کبھی شیئر نہیں ہوتی، اس لیے آپ کی طرف سے ہیڈر کی تصدیق ممکن نہیں۔ اس کی جگہ URL کے پاتھ میں موجود لمبی بے ترتیب خفیہ کلید بطور شناختی ثبوت کام کرتی ہے: اسے مستقل وقت میں موازنہ کریں اور باقی سب مسترد کریں۔ دوسری تہہ کے طور پر، Meta کے AS32934 پر رجسٹرڈ راستوں کی اجازت فہرست بنائیں اور اسے تازہ رکھیں، کیونکہ Meta اپنے IP پتے وقتاً فوقتاً بدلتا ہے۔

آپ کے URL تک کون سے WhatsApp ویب ہکس پہنچتے ہیں؟

وہ فیلڈز جو Meta کا متبادل کال بیک URL لے سکتا ہے: messages، جس میں گاہکوں کے بھیجے ہوئے میسجز اور آپ کے بھیجے ہوئے میسجز کی حیثیت شامل ہے؛ smb_message_echoes، اس کے لیے جو کاروبار WhatsApp Business ایپ سے بھیجتا ہے؛ اور ایک بار کی امپورٹ کی ہسٹری اور smb_app_state_sync۔ Meta کبھی بھی ٹیمپلیٹ ویب ہکس، یا account_update جیسے اکاؤنٹ ویب ہکس، کسی اوور رائیڈ کو نہیں بھیجتا۔ یہ easyCoexistence کے کال بیک پر جاتے ہیں، اسی لیے ٹیمپلیٹ ریویو پولنگ سے پڑھا جاتا ہے اور ڈراپ ایک اسٹیٹس ایونٹ کے طور پر آپ تک پہنچتا ہے۔

  • ویب ہک URL WhatsApp Business Account پر سیٹ ہوتا ہے، اس لیے ایک اکاؤنٹ کے دو نمبر اسے شیئر کرتے ہیں: value.metadata.phone_number_id پر روٹ کریں۔
  • میڈیا ایک ID کے طور پر آتا ہے؛ credentials کال سے حاصل ہونے والے گاہک کے ٹوکن کے ساتھ Meta سے فائل لائیں۔
  • پے لوڈ 3 MB تک پہنچ سکتے ہیں، اس لیے باڈی سائز کی کوئی بھی حد جو اس سے کم ہو بڑھا دیں۔

فارورڈ کیا گیا سوشل ایونٹ کیسا دکھتا ہے؟

Content-Type application/json اور X-EC-Signature ہیڈر کے ساتھ ایک POST، جس میں چار کیز ہوتی ہیں: platform؛ account_id، وہ چینل ID جو Partner API استعمال کرتا ہے؛ external_id، نیٹ ورک پر اکاؤنٹ کی ID؛ اور entry۔ Instagram اور Facebook کے لیے entry، Meta کا ویب ہک entry بغیر تبدیلی کے ہے، جس میں کمنٹس اور مینشنز کے لیے changes اور DMs کے لیے messaging شامل ہیں۔ TikTok کے لیے اس میں comment.update ایونٹ ہوتا ہے جس کا content پارس ہو چکا ہوتا ہے، اور comment_id، video_id اور parent_comment_id سٹرنگز کے طور پر، تاکہ 64 بٹ IDs گول نہ ہوں۔

  • Instagram اکاؤنٹس کمنٹس، میسجز اور mention کے لیے سبسکرائب ہوتے ہیں؛ Facebook Pages فیڈ، میسجز اور mention کے لیے؛ TikTok comment.update بھیجتا ہے۔
  • easyCoexistence YouTube یا LinkedIn سے کوئی کمنٹ ایونٹ وصول نہیں کرتا: ان کی PUT کا جواب 400 not_supported ہے، اور ان کے کمنٹس ہر نیٹ ورک کے API سے credentials کے ساتھ پڑھے جاتے ہیں۔
  • فارورڈز میں X-EC-Event یا X-EC-Delivery ہیڈر نہیں ہوتا، اس لیے نیٹ ورک کی اپنی IDs سے ڈپلیکیٹ ہٹائیں، جیسے کمنٹ ID یا میسج کی mid کا استعمال کریں۔
A forwarded Instagram comment
{
  "platform": "instagram",
  "account_id": "<CHANNEL_ID>",
  "external_id": "<INSTAGRAM_ACCOUNT_ID>",
  "entry": {
    "id": "<INSTAGRAM_ACCOUNT_ID>",
    "time": 1793440800,
    "changes": [
      {
        "field": "comments",
        "value": {
          "id": "<COMMENT_ID>",
          "from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
          "text": "<COMMENT_TEXT>",
          "media": { "id": "<MEDIA_ID>", "media_product_type": "<MEDIA_PRODUCT_TYPE>" }
        }
      }
    ]
  }
}

X-EC-Signature کی تصدیق مرحلہ وار کیسے کریں؟

PUT /channels/{id}/webhook کے دیے گئے signing_secret کے ساتھ، جو صرف ایک بار دکھایا جاتا ہے اور اسی اکاؤنٹ کا ہوتا ہے۔ ہیڈر t=<unix>,v1=<hex> کی شکل میں ہوتا ہے۔ پھر ہر ڈیلیوری کے لیے:

  • کسی بھی JSON پارسنگ سے پہلے، درخواست کی خام باڈی کو بائٹس کے طور پر پڑھیں۔
  • ہیڈر کو کوما پر تقسیم کریں: t، جو سیکنڈ میں Unix وقت ہے، اور v1، جو hex ڈائجسٹ ہے۔
  • اگر t آپ کی گھڑی سے 5 منٹ سے زیادہ دور ہو تو ڈیلیوری مسترد کریں۔
  • اس اکاؤنٹ کی خفیہ کلید سے، t، ایک ڈاٹ اور خام باڈی پر HMAC-SHA256 حساب کریں، hex کی شکل میں۔
  • v1 کے ساتھ مستقل وقت میں موازنہ کریں، پھر 2xx کا جواب دیں اور کام قطار میں ڈالیں۔
Node.js: verifying a forwarded event
import express from "express";
import { createHmac, timingSafeEqual } from "node:crypto";

const app = express();
const secrets = new Map(); // channel id -> signing_secret, kept in your database

app.post("/hooks/social", express.raw({ type: "application/json" }), (req, res) => {
  const sig = Object.fromEntries(
    (req.get("X-EC-Signature") ?? "").split(",").map((part) => part.split("=", 2)),
  );
  if (!/^\d+$/.test(sig.t ?? "") || Math.abs(Date.now() / 1000 - Number(sig.t)) > 300) {
    return res.sendStatus(401); // missing or stale timestamp
  }
  let event;
  try {
    event = JSON.parse(req.body.toString("utf8")); // platform, account_id, external_id, entry
  } catch {
    return res.sendStatus(400);
  }
  const secret = secrets.get(event.account_id);
  if (!secret || !sig.v1) return res.sendStatus(401);
  const expected = createHmac("sha256", secret)
    .update(sig.t + ".")
    .update(req.body) // the raw bytes, exactly as they arrived
    .digest("hex");
  if (expected.length !== sig.v1.length ||
      !timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1))) {
    return res.sendStatus(401);
  }
  res.sendStatus(204); // one attempt and no retries: acknowledge, then work
  enqueue(event);
});

جب کوئی منزل سیٹ نہ ہو تو کیا ہوتا ہے؟

کچھ بھی آپ تک نہیں پہنچتا، اور کچھ بعد میں بھیجے جانے کے لیے انتظار نہیں کرتا۔ جس نمبر کا webhook_url نہ ہو وہ easyCoexistence کے کال بیک پر جاتا ہے، جہاں اس کے میسجز ذخیرہ کیے بغیر ضائع ہو جاتے ہیں، اور اسے چیٹ ہسٹری امپورٹ نہیں ملتی، جو صرف اس وقت درخواست کی جاتی ہے جب منزل موجود ہو۔ جس سوشل اکاؤنٹ کا ویب ہک نہ ہو اسے فارورڈ نہیں کیا جاتا: اس کے ایونٹس پھر بھی easyCoexistence کی ایپ تک پہنچتے ہیں، لیکن آپ کے لیے کوئی بھی محفوظ نہیں رکھا جاتا۔ ٹریفک کی ضرورت سے پہلے ہر منزل سیٹ کریں۔

جب کنکشن ٹوٹ جائے یا ہٹا دیا جائے تو منزل کے ساتھ کیا ہوتا ہے؟

ایک نمبر اپنی منزل ریکارڈ پر رکھتا ہے۔ جب ٹوٹا ہوا نمبر دوبارہ کنیکٹ ہوتا ہے تو easyCoexistence آپ کا URL دوبارہ Meta کے ساتھ سیٹ کرتا ہے، اور یہی معاملہ معطل نمبر کی واپسی پر ہوتا ہے۔ سوشل اکاؤنٹ ہٹانے سے اس کی منزل اور خفیہ کلید دونوں صاف ہو جاتی ہیں، اس لیے دوبارہ کنیکٹ ہونے کے بعد PUT /channels/{id}/webhook دوبارہ کال کریں اور نئی خفیہ کلید محفوظ کریں۔ یہ PUT جب بھی URL کے ساتھ کال ہو تو نئی خفیہ کلید جاری کرتا ہے، اور پرانی فوراً دستخط کرنا بند کر دیتی ہے۔

اسے کیسے سیٹ اپ کریں

  1. Put a secret in the URLChoose an HTTPS URL whose path holds a long random string, 200 characters or fewer in all, and make its GET answer Meta's hub.challenge.
  2. Route the number's messagesSend webhook_url and webhook_verify_token on the connect session, or PUT /connections/{id}/webhook once the number is connected.
  3. Turn on each social accountCall PUT /channels/{id}/webhook with your URL and store the signing_secret it returns against that channel.
  4. Verify, then acknowledgeCheck the path secret on WhatsApp deliveries and X-EC-Signature on forwarded ones, answer 2xx at once, then process from a queue.

عام غلطیاں

  • اپنے گاہکوں کے WhatsApp ڈیلیوریز پر X-Hub-Signature-256 کی جانچ کرنا۔ Meta اسے easyCoexistence کی ایپ کی خفیہ کلید سے حساب کرتا ہے، جو کبھی شیئر نہیں ہوتی، اس لیے جانچ کبھی پاس نہیں ہو سکتی؛ URL کے پاتھ کی خفیہ کلید سے تصدیق کریں۔
  • پارس شدہ JSON پر X-EC-Signature کی تصدیق کرنا۔ HMAC خام باڈی کو بائٹ بہ بائٹ ڈھانپتا ہے، اور اسے دوبارہ سیریلائز کرنے سے بائٹس بدل جاتی ہیں، اس لیے پارس کرنے سے پہلے تصدیق کریں۔
  • ہر چینل کے لیے ایک ہی خفیہ کلید استعمال کرنا۔ ہر سوشل اکاؤنٹ اپنی الگ خفیہ کلید سے دستخط کرتا ہے، اور اسٹیٹس ایونٹس ایک الگ کلید سے، اس لیے account_id سے کلید تلاش کریں۔
  • فارورڈ ایونٹ کا جواب دینے سے پہلے سست کام کرنا۔ وہ ایک بار بھیجا جاتا ہے، آپ کے جواب کے لیے 8 سیکنڈ انتظار کرتا ہے اور دوبارہ کوشش نہیں کی جاتی، اس لیے پہلے 2xx کا جواب دیں اور بعد میں پروسیس کریں۔
EasyCoexistence کے ساتھ یہ کام کرنا

easyCoexistence ہر گاہک کے نمبر کے میسجز Meta سے براہ راست آپ کے سرور تک روٹ کرتا ہے، اور Instagram، Facebook اور TikTok کے کمنٹس اور DMs جیسے ہی آتے ہیں ہر اکاؤنٹ کے دستخط کے ساتھ آپ کے اینڈ پوائنٹ پر بھیجتا ہے، بغیر کوئی کاپی رکھے اور ہر کنکشن 24/7 نگرانی میں ہے۔ فی کنکشن فی مہینہ US$ 9 سے US$ 0.75 تک، کنکشن بڑھانے کے ساتھ قیمت کم ہوتی ہے، اور پہلے 3 دن کا فری ٹرائل۔

اکثر پوچھے جانے والے سوالات

کیا میں اپنے گاہکوں کے WhatsApp میسجز پر Meta کے دستخط کی تصدیق کر سکتا ہوں؟

نہیں۔ Meta انہیں easyCoexistence کی Tech Provider ایپ کی خفیہ کلید سے دستخط کرتا ہے، جو کبھی شیئر نہیں ہوتی۔ اپنے URL کے پاتھ میں موجود لمبی بے ترتیب خفیہ کلید سے تصدیق کریں، اور اختیاری طور پر Meta کی IP رینجز بھی استعمال کریں۔

کیا YouTube اور LinkedIn کنکشن کمنٹ ایونٹس فارورڈ کرتے ہیں؟

نہیں۔ easyCoexistence ان میں سے کسی سے بھی کمنٹ ایونٹس وصول نہیں کرتا، اس لیے PUT /channels/{id}/webhook کا جواب 400 not_supported ہوتا ہے۔ ان کے کمنٹس ہر نیٹ ورک کے API سے چینل کے credentials کے ساتھ پڑھیں۔

کیا میرا سرور ڈاؤن ہو تو فارورڈ کیے گئے سوشل ایونٹس دوبارہ بھیجے جاتے ہیں؟

نہیں۔ ہر ایونٹ ایک بار بھیجا جاتا ہے اور کوئی کاپی محفوظ نہیں رکھی جاتی۔ WhatsApp ڈیلیوریز مختلف ہیں، کیونکہ Meta خود انہیں 7 دن تک دوبارہ بھیجتا ہے۔

کیا میسجز easyCoexistence سے گزرتے ہیں؟

WhatsApp پر نہیں: Meta کسی نمبر کے میسجز براہ راست اس ویب ہک پر پہنچاتا ہے جو آپ نے سیٹ کیا ہو۔ سوشل نیٹ ورکس کے کمنٹس اور DMs جیسے ہی آتے ہیں آپ کے اینڈ پوائنٹ پر فارورڈ ہوتے ہیں، ہر اکاؤنٹ کے دستخط کے ساتھ، اور کوئی کاپی محفوظ نہیں رکھی جاتی۔

مزید پڑھیں

کسٹمر کا WhatsApp یا سوشل کنکشن کب منقطع ہوتا ہے، یہ کیسے جانیںconnection.* اور channel.* اسٹیٹس ایونٹس: پے لوڈ، وجوہات، X-EC-Signature، تقریباً 33 گھنٹے تک دوبارہ کوشش اور id سے ڈپلیکیٹ روکنا۔API کے ذریعے WhatsApp Business ایپ کی چیٹ ہسٹری اور رابطے امپورٹ کریںCoexistence کے ذریعے WhatsApp Business ایپ کے رابطے اور 180 دن تک کی چیٹس امپورٹ کریں: ہسٹری ویب ہکس، chunk_order، progress اور ایرر کوڈ 2593109 کی تفصیل۔گاہک کے API ٹوکن کیسے حاصل کریں: WhatsApp، Instagram اور TikTok کے لیےWhatsApp نمبر اور ہر سوشل اکاؤنٹ کے کریڈینشلز کال کیا لوٹاتی ہے، فیلڈ بہ فیلڈ، اور ٹوکن کی تبدیلی اور token_ready کیسے کام کرتے ہیں۔Instagram ویب ہک ایونٹس: تبصرے، منشنز اور DMsInstagram کے تبصرے، منشنز اور DMs آپ کے اینڈ پوائنٹ تک ویب ہک ایونٹس کے طور پر کیسے پہنچتے ہیں، ہر پے لوڈ میں کیا ہوتا ہے، اور کیا جانچنا ہے۔Facebook Page کے لیے Messenger ویب ہک: میسجز اور منشن ایونٹسFacebook Page کے لیے Messenger میسجز اور منشنز کی ویب ہک فیلڈز: پے لوڈ کا ڈھانچہ، سینڈر آئی ڈیز، اور ایونٹس آپ کے اینڈ پوائنٹ تک کیسے پہنچتے ہیں۔TikTok کمنٹ ویب ہک ایونٹسTikTok کا comment.update ویب ہک کمنٹس اور ریپلائیز کیسے بتاتا ہے، ہر ایونٹ میں کیا ہوتا ہے، اور وہ دستخط شدہ آپ کے اینڈ پوائنٹ تک کیسے پہنچتے ہیں۔

دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔

کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔

  • 3 دن مفت
  • کسی بھی وقت منسوخ کریں
  • صرف آفیشل API
  • 24/7 نگرانی

تصدیق شدہ تاریخ