شروع سریع

پیش از شروع

دسترسی به API همراه با بسته ارائه می‌شود. به بسته تجاری، حرفه‌ای یا بسته API اینستاگرام نیاز دارید. قیمت‌ها را ببینید.

وقتی یکی از این بسته‌ها فعال بود، بقیه موارد را در chat.parstechai.com تنظیم کنید:

نکته‌ای که اول باید بدانید

کانال همیشه متعلق به یک ربات است. نمی‌توانید یک صفحه اینستاگرام را به‌تنهایی وصل کنید. اول ربات را بسازید، سپس کانال را به آن متصل کنید.

اگر مشتریان نهایی زیادی را مدیریت می‌کنید، برای هر مشتری یک ربات بسازید. همین کار است که گفتگوهای یک مشتری را از گفتگوهای مشتری دیگر جدا نگه می‌دارد.

۱. ساخت ربات

curl -X POST https://api-chat.parstechai.com/v1/robots \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Rose Flower Shop",
    "external_id": "shop_10422"
  }'

{
  "id": "rbt_8fK2mQ",
  "name": "Rose Flower Shop",
  "external_id": "shop_10422",
  "channels": [],
  "created_at": "2026-09-20T11:04:33Z"
}

external_id مال شماست. شناسه مشتری خودتان را در آن بگذارید تا ما آن را در هر رویداد برگردانیم؛ به این ترتیب هیچ‌وقت به جدول تطبیق شناسه‌ها نیاز پیدا نمی‌کنید.

۲. شروع اتصال کانال

curl -X POST https://api-chat.parstechai.com/v1/robots/rbt_8fK2mQ/channels \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "type": "instagram" }'

{
  "id": "chn_3pQ7xL",
  "type": "instagram",
  "robot_id": "rbt_8fK2mQ",
  "status": "pending_authorisation",
  "authorisation_url": "https://api-chat.parstechai.com/v1/connect/ig/svc_4dR8nW",
  "expires_at": "2026-09-20T12:04:33Z"
}

۳. اطمینان از فعال‌بودن کانال

curl https://api-chat.parstechai.com/v1/robots/rbt_8fK2mQ/channels \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxxxxxxxxxx"

{
  "data": [
    {
      "id": "chn_3pQ7xL",
      "type": "instagram",
      "robot_id": "rbt_8fK2mQ",
      "username": "rose.flower.shop",
      "is_active": true,
      "connected_at": "2026-09-20T11:06:10Z"
    }
  ]
}

۴. بررسی اولین رویداد

رویدادها به آدرس وب‌هوکی می‌رسند که در پنل تنظیم کرده‌اید. پیش از اعتماد به محتوای رویداد، امضای آن را بررسی کنید.

{
  "schema_version": "1.0.0",
  "event": "message",
  "delivery_id": "dlv_9fK2mQ",
  "occurred_at": "2026-09-20T11:09:02Z",
  "robot_id": "rbt_8fK2mQ",
  "external_id": "shop_10422",
  "channel_id": "chn_3pQ7xL",
  "data": {
    "conversation_id": "cnv_4dR8nW",
    "message_id": "msg_1aB2cD",
    "source": "direct",
    "role": "client",
    "type": "text",
    "text": "Hi, do you have these roses in stock?",
    "attachments": [],
    "sender": { "id": "iguser_88213", "username": "sara.k" },
    "created_at": "2026-09-20T11:09:02Z"
  }
}

امضا در هدر X-ParsChat-Signature می‌آید و مقدار آن HMAC-SHA256 بدنه خام درخواست به‌صورت hex است که با secret شما ساخته شده است.

import hashlib
import hmac
def is_authentic(raw_body: bytes, header_signature: str, secret: str) -> bool:
    expected = hmac.new(secret.encode(), raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, header_signature)

به‌محض ذخیره‌کردن رویداد، با 2xx پاسخ دهید. هر پاسخ دیگری، از جمله پایان مهلت (timeout)، دوباره تلاش می‌شود. رویدادهای وب‌هوک را ببینید.

خطاهای رایج

همه مقدارهای code در خطاها فهرست شده‌اند.

قدم بعدی