অর্ডার দেওয়া
একটি অর্ডার একটি লিস্টে একটি চেকার চালায়। প্রতিটি চেকারের জন্য ধাপগুলো একই।
1. চেকার বেছে নিন
GET /checkers দেখায় আপনার অ্যাকাউন্ট কী কী অর্ডার করতে পারে, আপনার দামে। প্রতিটির একটি id থাকে, যেমন whatsapp_status_detection, এবং এটি ফোন নম্বর, ইমেইল বা ইউজারনেম নেয়। দেখুন চেকার।
curl "https://api.talismanleads.io/v1/checkers" \
-H "Authorization: Bearer tl_live_your_key_here"2. আপনার লিস্ট পাঠান
100,000টি এন্ট্রি ও 4 MB পর্যন্ত রিকোয়েস্টে entries হিসেবে দিন। বড় লিস্টের জন্য POST /uploads-এর কাছে একটি লিংক চান, সেই লিংকে PUT দিয়ে ফাইল পাঠান, তারপর তার upload_id ব্যবহার করুন। লিংকটি 2 ঘণ্টা থাকে। এতে আপনার API কী পাঠাবেন না।
- ফাইল হলো একটি
.txt, প্রতি লাইনে একটি এন্ট্রি, 200 MB ও 10,000,000টি এন্ট্রি পর্যন্ত। - ফোন নম্বর দেশের কোডসহ লিখুন, যেমন
+14155550142। - একটি ফাইলের ফোন নম্বর এক দেশের হওয়া উচিত: অন্তত 90%। মিশ্র লিস্টকে প্রতি দেশে একটি করে ফাইলে ভাগ করুন।
- একটি অবৈধ লাইনেই পুরো লিস্ট প্রত্যাখ্যাত হয়, এবং রেসপন্সে উদাহরণ দেখানো হয়।
- আপলোড করা ফাইল অর্ডারের জন্য 24 ঘণ্টা অপেক্ষা করে, তারপর মুছে ফেলা হয়।
- আপনার একসঙ্গে 20টি ফাইল বা 100 MB অপেক্ষায় থাকতে পারে, আপনি যতগুলোই API কী ব্যবহার করুন, এবং দিনে 500টি আপলোড করতে পারেন। আপনি এই সীমার নিচে থাকলে অনুমোদিত যেকোনো আকারের একটি ফাইল এর ওপরে যেতে পারে।
লিংক চান
curl -X POST "https://api.talismanleads.io/v1/uploads" \
-H "Authorization: Bearer tl_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{"file_name":"list.txt","size_bytes":1048576}'তাতে ফাইল পাঠান
UPLOAD_URL="PASTE_upload_url_FROM_THE_ANSWER_ABOVE"
curl --upload-file list.txt "$UPLOAD_URL" \
-H "Content-Type: text/plain" \
-w "%{http_code}\n"3. দাম দেখুন
POST /estimates এন্ট্রি গোনে ও দাম হিসাব করে, এবং কিছুই চার্জ করে না। billed_entries entries-এর চেয়ে বেশি হতে পারে, কারণ প্রতিটি ফাইল ন্যূনতম 2,000টি হিসেবে বিল করা হয়।
curl -X POST "https://api.talismanleads.io/v1/estimates" \
-H "Authorization: Bearer tl_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'4. অর্ডার দিন
POST /orders আপনার ব্যালেন্স থেকে চার্জ করে এবং কাজটি কিউতে রাখে। একটি Idempotency-Key পাঠান, যাতে রিট্রাইয়ে আপনার দুবার চার্জ হতে না পারে: দেখুন নিরাপদ রিট্রাই। দাম নিশ্চিত হতে expected_charge পাঠান, আর খরচ অন্য কিছু হলে অর্ডারটি price_changed সহ প্রত্যাখ্যাত হয়। রেসপন্সের জন্য 5 মিনিট পর্যন্ত সময় রাখুন, কারণ বড় লিস্ট পড়তে সময় লাগে।
curl -X POST "https://api.talismanleads.io/v1/orders" \
-H "Authorization: Bearer tl_live_your_key_here" \
-H "Idempotency-Key: crm-export-2026-11-05" \
-H "Content-Type: application/json" \
-d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'5. অবস্থা অনুসরণ করুন
প্রতি 30 সেকেন্ড বা তার বেশি ব্যবধানে GET /orders/{id} কল করুন। বড় ফাইল ভেতরে ভেতরে কয়েকটি অংশে ভাগ হয়, কিন্তু একটি অর্ডারের একটিই স্ট্যাটাস ও একটিই মোট থাকে।
queued- শুরুর অপেক্ষায়।
processing- চলছে।
completed- শেষ, প্রতিটি অংশ সম্পন্ন।
partially_completed- শেষ, কিছু অংশ ব্যর্থ। সেই অংশগুলো রিফান্ড করা হয়: `refunded` দেখায় কত ফেরত এসেছে।
failed- কোনো অংশই করা যায়নি। চার্জ রিফান্ড করা হয়: `refunded` দেখায় কত ফেরত এসেছে।
আরও স্ট্যাটাস যোগ হতে পারে, তাই অচেনা স্ট্যাটাসকে এখনও চলছে বলে ধরুন।
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f" \
-H "Authorization: Bearer tl_live_your_key_here"6. ফলাফল নিন
GET /orders/{id}/results প্রতিটি অংশের জন্য একটি ডাউনলোড লিংক দেয়, যা 15 মিনিট কার্যকর থাকে। যেকোনো সময় নতুন লিংকের জন্য আবার চান: ফলাফল রাখা থাকে। ফাইল সাধারণত একটি zip, যাতে all.csv, একটি স্প্রেডশিট ও টেক্সট লিস্ট থাকে, অথবা একটি একক CSV। কলাম যোগ হতে পারে, তাই অবস্থান দিয়ে নয়, নাম দিয়ে পড়ুন। এই লিংকগুলোতে আপনার API কী পাঠাবেন না।
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f/results" \
-H "Authorization: Bearer tl_live_your_key_here"চার্জ ও রিফান্ড
charge হলো অর্ডার দেওয়ার সময় তার খরচ, আর refunded হলো তার কতটা ফেরত এসেছে। যে অংশ ব্যর্থ হয় তা পুরো রিফান্ড করা হয়, আর যে অংশ প্রোভাইডার কম গুনেছে তার পার্থক্য ফেরত দেওয়া হয়, সেই অংশের ন্যূনতম বিল পর্যন্ত। দুটোই স্বয়ংক্রিয়ভাবে হয়।
প্রায় এক দিনের মধ্যে একই চেকারে একই লিস্ট, নতুন Idempotency-Key দিয়ে, নতুন অর্ডার হিসেবে আবার চার্জ হয়, এবং নতুন চেকের বদলে আপনার আগের ফলাফল ফেরত দিতে পারে।
অন্য জায়গা থেকে দেওয়া অর্ডার
ওয়েবসাইটে দেওয়া আপনার অর্ডারও তালিকায় আসে। API অর্ডার ওয়েবসাইটের আমার টাস্কে API ব্যাজসহ দেখা যায়, এবং আপনি সেখানে না চাইলে Telegram-এ কিছু পাঠায় না।