কনটেন্টে যান

পাবলিক API রেফারেন্স

টিকিট, মেসেজ, আর অ্যাকশনের জন্য স্কোপড API কী দিয়ে Threada-এর পাবলিক API ব্যবহার করুন।

Threada-এর পাবলিক API টিকিটিং, অটোমেশন, ও ইন্টিগ্রেশনের জন্য তৈরি। সব অনুরোধ টেন্যান্ট‑স্কোপড এবং অডিট‑লগড।

Base URL

সব পাবলিক API অনুরোধ এই বেস URL ব্যবহার করে।

https://api.threada.ai

অথেনটিকেশন

  • সব অনুরোধে `X-Api-Key` হেডার দিন।
  • প্রতি ইন্টিগ্রেশনের জন্য আলাদা কী ব্যবহার করুন এবং নিয়মিত রোটেট করুন।
  • কীগুলো টেন্যান্ট‑স্কোপড এবং scopes দিয়ে least‑privilege প্রয়োগ করা হয়।

Scopes

  • `support.read` — টিকিট, মেসেজ ও অ্যাকশন দেখুন/তালিকা করুন।
  • `support.write` — টিকিট তৈরি/আপডেট ও মেসেজ যোগ করুন।
  • `support.actions` — অ্যাকশন চালান এবং স্ট্যাটাস দেখুন।
  • `webhooks.manage` — ইনবাউন্ড ও আউটবাউন্ড ওয়েবহুক কনফিগার করুন।

Pagination

  • List endpoints `limit` এবং `page_token` গ্রহণ করে।
  • Responses `next_page_token` ফেরত দেয়।
  • পেজিনেশন টোকেন না থাকলে তালিকার শেষ।

Errors

  • Errors `{ error: { type, message, code } }` ফরম্যাটে ফেরত দেয়।
  • ভ্যালিডেশন বা পারমিশন ব্যর্থ হলে 4xx ব্যবহার করা হয়।
  • সার্ভার ত্রুটি হলে 5xx এবং একটি correlation ID ফেরত দেয়।

উদাহরণ

টিকিট তালিকা

সব চ্যানেলের ওপেন টিকিট আনুন।

অনুরোধ 
curl -X GET "https://api.threada.ai/api/v1/public/tickets?limit=25" \
  -H "X-Api-Key: YOUR_API_KEY"
প্রতিক্রিয়া 
{
  "items": [
    {
      "ticket_id": "TICKET_ID",
      "tenant_id": "TENANT_ID",
      "subject": "SUBJECT",
      "status": "open",
      "priority": "normal",
      "channel": "email",
      "tags": ["vip", "returns"],
      "last_message_at": "2026-02-04T18:32:11Z"
    }
  ],
  "next_page_token": "NEXT_PAGE_TOKEN"
}

টিকিট তৈরি করুন

প্রাথমিক মেসেজসহ নতুন টিকিট খুলুন।

অনুরোধ 
curl -X POST "https://api.threada.ai/api/v1/public/tickets" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "SUBJECT",
    "priority": "normal",
    "channel": "email",
    "contact": {
      "name": "CUSTOMER_NAME",
      "email": "customer@example.com"
    },
    "tags": ["returns"],
    "initial_message": {
      "role": "user",
      "content": "MESSAGE_BODY",
      "external_message_id": "EXT_MSG_ID"
    }
  }'
প্রতিক্রিয়া 
{
  "ticket": {
    "summary": {
      "ticket_id": "TICKET_ID",
      "tenant_id": "TENANT_ID",
      "subject": "SUBJECT",
      "status": "open",
      "priority": "normal",
      "channel": "email",
      "tags": ["returns"],
      "created_at": "2026-02-04T18:32:11Z"
    },
    "contact": {
      "name": "CUSTOMER_NAME",
      "email": "customer@example.com"
    },
    "messages": [
      {
        "message_id": "MESSAGE_ID",
        "role": "user",
        "content": "MESSAGE_BODY",
        "channel": "email",
        "created_at": "2026-02-04T18:32:11Z"
      }
    ]
  }
}

অ্যাকশন চালান

একটি টিকিটের জন্য Custom HTTP অটোমেশন ট্রিগার করুন।

অনুরোধ 
curl -X POST "https://api.threada.ai/api/v1/public/tickets/TICKET_ID/actions" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": {
      "type": "custom_http",
      "method": "POST",
      "url": "/hooks/zapier",
      "headers": {
        "X-Source": "threada"
      },
      "body_json": "{\"event\":\"ticket_updated\"}"
    }
  }'
প্রতিক্রিয়া 
{
  "action": {
    "action_id": "ACTION_ID",
    "tenant_id": "TENANT_ID",
    "ticket_id": "TICKET_ID",
    "action_type": "custom_http",
    "status": "succeeded",
    "requested_by": "api_key:API_KEY_ID",
    "payload": {
      "type": "custom_http",
      "method": "POST",
      "url": "/hooks/zapier",
      "headers": {
        "X-Source": "threada"
      },
      "body_json": "{\"event\":\"ticket_updated\"}"
    }
  }
}

উচ্চ ভলিউম বা কাস্টম ওয়ার্কফ্লো?

আমাদের টিমের সাথে কথা বলুন—রেট লিমিট, স্কোপ, এবং SLA প্রয়োজন অনুযায়ী টিউন করা হবে।

সেলসের সাথে যোগাযোগ