الرد على الردود
كل رد من كل حملة في صندوق وارد واحد. أجب في السلسلة نفسها، وأعد التوجيه، وصنّف الردود على أنها مهتم أو تم حجز اجتماع أو مرحلة خاصة بك في مسار المبيعات.
اطلع على الردود الجديدة
curl "https://app.argorant.com/api/v1/inbox?folder=replies&limit=25" -H "Authorization: Bearer $ARGORANT_API_KEY"قيمة folder هي all أو replies أو interested أو not_interested أو out_of_office أو bounces أو unsubscribes. ضيّق النتائج أكثر باستخدام campaign_id أو classification أو كلمة بحث في q. تأتي المحادثات مرتبة حسب آخر نشاط أولًا، بما في ذلك إجاباتك أنت. تعرض القوائم أول 300 حرف من آخر رسالة. تنقّل بين الصفحات باستخدام cursor وnext_cursor حتى تصبح قيمة has_more هي false؛ ويمكن الوصول إلى كل محادثة. المحادثة التي لم يصنّفها أحد بعد تحمل التصنيف unknown.
اقرأ ما تغير فقط
curl "https://app.argorant.com/api/v1/inbox?received_after=2026-11-10T09:00:00Z&limit=100" -H "Authorization: Bearer $ARGORANT_API_KEY"يُبقي received_after على المحادثات التي وصلت أحدث رسالة فيها من الشخص بعد تلك اللحظة. أما updated_after فيحتسب إجاباتك أنت أيضًا. لكل محادثة lead_id وupdated_at وlast_received_at. إذا كنت تقرأ API وفق جدول زمني بدلًا من ذلك، فابدأ كل قراءة قبل بضع دقائق من نهاية القراءة السابقة وتجاوز المعرّفات التي لديك بالفعل. قد يُحفظ الصف بعد لحظة من الوقت الذي يحمله، لذا قد تفوته نافذة تبدأ تمامًا حيث انتهت النافذة السابقة. لا تحتاج Webhooks إلى أي من هذا.
اقرأ محادثة
curl "https://app.argorant.com/api/v1/inbox/$THREAD" -H "Authorization: Bearer $ARGORANT_API_KEY"يمثل $THREAD قيمة id من القائمة. تحصل على النص الكامل والسلسلة كاملة، الأقدم أولًا: رسائلك، وردودهم، وإجاباتك، وعمليات إعادة التوجيه.
أجب في السلسلة نفسها
curl -X POST "https://app.argorant.com/api/v1/inbox/$THREAD/reply" \
-H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: reply-jane-1" \
-H "Content-Type: application/json" \
-d '{"body":"Thursday 10:00 works. I will send an invite."}'تُرسل الإجابة فورًا، في السلسلة نفسها، من صندوق البريد الذي استلم الرد. على الوكيل أن يعرض النص على المستخدم وينتظر موافقته. يضمن Idempotency-Key ألا تُرسل إعادة المحاولة الإجابة مرتين أبدًا.
أعد توجيهها إلى زميل
curl -X POST "https://app.argorant.com/api/v1/inbox/$THREAD/forward" \
-H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: fwd-jane-1" \
-H "Content-Type: application/json" \
-d '{"to":["sales-lead@yourcompany.com"],"note":"Hot lead, please call her this week."}'تحمل الرسالة المعاد توجيهها السجل والمرفقات. وخلال ثلاث دقائق تُظهر المحادثة ما إذا تم تسليمها.
صنفها وتتبع مسار المبيعات
لكل مساحة عمل خمسة تصنيفات قياسية: positive (يظهر باسم مهتم)، وmeeting_request، وout_of_office، وunsubscribe، وneutral (يظهر باسم أخرى). يمكنك تفعيل not_interested وquestion وreferral وwrong_person وmeeting_booked. أضف مراحلك الخاصة:
curl -X POST "https://app.argorant.com/api/v1/reply-statuses" \
-H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
-d '{"label":"Proposal sent","color":"purple"}'
curl -X POST "https://app.argorant.com/api/v1/inbox/$THREAD/classify" \
-H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
-d '{"classification":"proposal_sent"}'تُفهم interested على أنها positive. أعد تسمية مرحلة، أو غيّر لونها، أو أخفها، أو أظهرها باستخدام PATCH /api/v1/reply-statuses/{key}. احذف إحدى مراحلك الخاصة باستخدام DELETE /api/v1/reply-statuses/{key}؛ وتعود محادثاتها إلى محايد.
إشعار فوري
يستدعي Webhook لحدث reply.received خادمك عندما يرد شخص ما، وWebhook لحدث reply.positive عندما يحصل رد على تصنيف مهتم أو طلب اجتماع، وWebhook لحدث reply.label_changed كلما وضع أحد تصنيفًا أو غيّره، فلا ينتظر أحد الفحص التالي.
من الطرفية
npx argorant inbox list --folder replies
npx argorant inbox read <thread-id>
npx argorant inbox reply <thread-id> --body "Thursday works."
npx argorant inbox classify <thread-id> meeting_booked