ربط القنوات من داخل منتجك

curl -X POST https://social.linkiasoft.com/api/v1/connect-sessions \
  -H "x-api-key: lk_live_..." \
  -H "X-Tenant-Id: 8f6a2b3c-4d5e-4a7b-9c1e-3f2b1a9c0d4e" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "whatsapp",
    "origin": "https://app.example.com",
    "state": "user-4821",
    "locale": "ar"
  }'

{
  "id": "6f1c8e2a-9b4d-4c7e-8a13-2d5f0b7c9e41",
  "platform": "whatsapp",
  "status": "pending",
  "connectUrl": "https://crm.linkiasoft.com/ar/connect#token=cst_...",
  "channelId": null,
  "channelName": null,
  "state": "user-4821",
  "createdAt": "2026-10-22T09:00:00.000Z",
  "expiresAt": "2026-10-22T09:30:00.000Z",
  "completedAt": null
}

async function connectWhatsApp() {
  // افتح النافذة أولًا ثم حمّل الرابط فيها — حتى تبقى داخل النقرة.
  const popup = window.open('', 'linkia_connect', 'width=520,height=720');
  const { connectUrl } = await fetch('/api/linkia/connect-session', { method: 'POST' })
    .then((r) => r.json());
  popup.location.href = connectUrl;
}

window.addEventListener('message', (event) => {
  if (event.origin !== 'https://crm.linkiasoft.com') return;
  if (event.data?.source !== 'linkia-connect') return;

  const { sessionId, status, platform, channelId, channelName, state } = event.data;
  // status: 'connected' | 'cancelled'
  confirmOnServer(sessionId);
});

https://app.example.com/done?sessionId=6f1c…&status=connected&channelId=b21e…&state=user-4821

curl https://social.linkiasoft.com/api/v1/connect-sessions/6f1c8e2a-9b4d-4c7e-8a13-2d5f0b7c9e41 \
  -H "x-api-key: lk_live_..." \
  -H "X-Tenant-Id: 8f6a2b3c-4d5e-4a7b-9c1e-3f2b1a9c0d4e"

{
  "event": "connect_session.completed",
  "source": "social",
  "data": {
    "session_id": "6f1c8e2a-9b4d-4c7e-8a13-2d5f0b7c9e41",
    "status": "connected",
    "platform": "whatsapp",
    "channel_id": "b21e7d40-3a55-4f89-9c02-77ab1e6d3c88",
    "channel_name": "Acme Support",
    "state": "user-4821"
  }
}