Threadwire by TriTech

→ مرجع الـ API

وكيل الذكاء الاصطناعي

يمكن للرقم أن يرد بنفسه على من يكتبون إليه، بالذكاء الاصطناعي، مما تخبره به عن نشاطك. يستخدم مفتاح API الخاص بك من Anthropic أو OpenAI: تكلفة الذكاء الاصطناعي على حسابك لديهما، ولا يضيف Threadwire عليها شيئًا. ضع حدًّا شهريًا للإنفاق لدى مزودك.

كل إجابة هي رد عادي من الرقم، بالحماية نفسها التي لأي رسالة: «يكتب…» أولًا، وإيقاع الرد، وكل الحدود. ولا يبدأ بالكتابة إلى أي أحد أبدًا.

على ماذا يرد، ومتى

  • نص كتبه شخص إلى الرقم للتو، في محادثة فردية. ولا يرد أبدًا على مجموعة، أو قناة، أو حالة، أو ملف (حتى مع تعليق: فالذكاء الاصطناعي لا يراه). ولا على شخص كتب «STOP»، أو محادثة الرقم مع نفسه، أو رقم آخر من أرقامك، أو رسالة مضى عليها أكثر من 15 دقيقة.
  • ردودك التلقائية بالكلمات المفتاحية ترد أولًا. حين يرد أحدها على رسالة، أو رُدّ على الكلمة نفسها قبل لحظات، لا يقول الذكاء الاصطناعي شيئًا: رد واحد لكل رسالة. ورد الغياب أو رد الترحيب التلقائي حين يرد يسبقه بالطريقة نفسها.
  • إذا كانت قائمة اختيارات مفعّلة، تُعرض القائمة أولًا والاختيار للقائمة. يرد الذكاء الاصطناعي على ما ليس اختيارًا. وبعد أن يحوّل اختيارٌ المحادثة إلى فريقك، يصمت الذكاء الاصطناعي فيها حتى يرد فريقك أو يحددها كمنتهية، ولمدة 24 ساعة على الأكثر.
  • متى: always، أو outside_hours فقط (حسب working_hours لديك، بتوقيت الرقم نفسه)، أو no_reply: فقط حين لا يرد أحد من فريقك خلال wait_minutes.
  • فريقك يتولى المحادثة: بعد أن يرد أحد أفراد فريقك على محادثة (من لوحة التحكم أو الهاتف)، يصمت الذكاء الاصطناعي فيها 24 ساعة. الرسائل التي ترسلها عبر الـ API لا تنقل المحادثة إلى فريقك، فهي غالبًا تحديثات طلبات؛ ولإيقافه في محادثة، استخدم لوحة التحكم. في اللوحة، «إيقاف الذكاء الاصطناعي في هذه المحادثة» يوقفه فيها نهائيًا، إلى أن تضغط «السماح للذكاء الاصطناعي بالرد في هذه المحادثة».
  • الحدود: daily_limit ردًّا من الذكاء الاصطناعي في اليوم على الأكثر للرقم (تحدده أنت، حتى 2,000). و8 في الساعة و30 في اليوم على الأكثر للشخص الواحد، فلا يدخل أبدًا في محادثة لا تنتهي مع روبوت آخر.
  • عدة رسائل متتالية تنال ردًّا واحدًا، بعد نحو 10 ثوانٍ من آخرها.

ما الذي يعرفه

يجيب فقط من نص about لديك (حتى 8,000 حرف: ما تبيعه وأسعارك، ومواعيد العمل، والعنوان، والتوصيل، والإرجاع، والدفع). ويجيب كذلك من ردودك المحفوظة، ومن الردود التلقائية بالكلمات المفتاحية للرقم، ومن آخر 10 رسائل في المحادثة. يُطلب منه ألّا يخترع أبدًا أسعارًا أو مخزونًا أو مواعيد أو خصومات أو وعودًا. فحين لا يجد الإجابة، أو عند شكوى أو استرداد مبلغ أو دفع أو طلب التحدث مع موظف، يقول إن أحد أفراد فريقك سيرد قريبًا. يرد باللغة التي كتب بها الشخص (auto)، أو دائمًا بالعربية أو الإنجليزية (language)، بأسلوب friendly أو formal.

تبقى المحادثة تحت «بانتظار الرد» في لوحة التحكم، فيرى فريقك كل سؤال أجاب عنه الذكاء الاصطناعي. رسائله تحمل origin بقيمة ai.

الـ API

GET /v1/instances/{id}/ai-agent
PATCH /v1/instances/{id}/ai-agent
{"enabled": true, "provider": "anthropic", "model": "claude-sonnet-5-5", "api_key": "sk-ant-…",
 "about": "We sell…", "tone": "friendly", "language": "auto", "answers": "outside_hours",
 "working_hours": {"days": [0, 1, 2, 3, 4], "from": "09:00", "to": "17:00"}, "daily_limit": 200}

أرسل ما يتغير فقط. في working_hours، تُرقَّم days بدءًا من الأحد: 0 هو الأحد، و6 هو السبت. api_key للكتابة فقط: الردود تعرض api_key_set وapi_key_last4، ولا تعرض المفتاح أبدًا. models في الرد يسرد النماذج التي يمكنك اختيارها لكل مزود (anthropic وopenai). تفعيله يحتاج إلى مفتاح؛ وتغيير provider يحتاج إلى مفتاح ذلك المزود. يحتاج PATCH إلى مفتاح وصول كامل.

متى يتوقف

إذا رفض مزودك المفتاح، أو لم يعد في حسابك لدى مزود الذكاء الاصطناعي رصيد، أو كان النموذج غير متاح لمفتاحك، فالوكيل يتوقف مؤقتًا. لا يرد على أحد، ويوضح paused السبب، وتعرض صفحة الرقم «وكيل الذكاء الاصطناعي متوقف مؤقتًا»، ويصل المسؤولين لديك بريد إلكتروني. أصلح السبب، ثم احفظ الإعدادات من جديد (PATCH بأي حقل) أو اضغط «اختبار المفتاح» في لوحة التحكم. أي إخفاق آخر (المزود بطيء أو مشغول، أو لا إجابة يمكن إرسالها) يتخطى تلك الرسالة وحدها. ويُسجَّل في last_error، ولا تُعاد محاولته أبدًا.

بياناتك

حين يكون وكيل الذكاء الاصطناعي مفعّلًا، تذهب أحدث رسائل المحادثة ونص نشاطك إلى المزود الذي اخترته، ضمن حسابك لديه، لكتابة كل إجابة. نحتفظ بمفتاحك مشفّرًا وبنص نشاطك إلى أن تغيّرهما أو تزيل الرقم. راجع سياسة الخصوصية.