ArgorantDocs

التواقيع

امنح كل صندوق بريد توقيعه الخاص، أو نصًا واحدًا لعدة صناديق بريد، وضعه في رسائل الحملات والردود باستخدام {{signature}}.

التوقيع نص ثابت يحتوي على متغيرات المرسِل {{sender_first_name}} و{{sender_last_name}} و{{sender_full_name}} و{{sender_title}} و{{sender_company}} و{{sender_email}}، وهي المتغيرات نفسها التي تستخدمها رسائل الحملات. اكتبه مرة واحدة وسيوقّع كل صندوق بريد باسمه الخاص. في رسالة الحملة يعود {{first_name}} و{{company}} إلى جهة الاتصال؛ أما في التوقيع فكل متغير يعود إلى المرسِل، لذا فإن التوقيع القديم الذي يحتوي على {{first_name}} يظل يوقّع باسم صندوق البريد ويُحفظ على أنه {{sender_first_name}}. يمكن أن يكون نصًا عاديًا أو HTML بسيطًا مع روابط وفواصل أسطر. لا يُسمح بالصيغ البديلة مثل {Best|Cheers} في التوقيع.

Text
Best,
{{sender_first_name}} {{sender_last_name}}
{{sender_title}}, {{sender_company}}

السطر الذي تكون كل متغيراته فارغة يُحذف، لذا لا يحصل صندوق البريد الذي ليس له مسمى وظيفي على سطر فارغ.

أي توقيع يستخدمه صندوق البريد

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

رسائل الحملات والردود

يُملأ {{signature}} في كل رسالة تستخدمه: أول رسالة في الحملة، والمتابعات، والردود. والرسالة التي لا تحتوي على {{signature}} لا تحمل أي توقيع. لم يعد replies_only مستخدمًا؛ وما زال مقبولًا لكنه لا يغيّر شيئًا.

ضعه في مكانه

اكتب {{signature}} حيث يجب أن يظهر التوقيع، في رسالة حملة أو في رد من صندوق الوارد. يُملأ وقت الإرسال بتوقيع صندوق البريد الذي يرسل. لا يُضاف شيء إلى الحملات تلقائيًا: الرسالة التي لا تحتوي على {{signature}} تبقى كما كتبتها. وتنتهي ردود وكيل الذكاء الاصطناعي بتوقيع صندوق البريد عندما يكون مضبوطًا.

في رسالة حملة بنص عادي يظهر الرابط كتسميته متبوعة بالعنوان. وفي حملة لا ترسل روابط، تُحذف أسطر التوقيع التي تحتوي على رابط أو عنوان.

في التطبيق

افتح صناديق البريد، وانقر صندوق بريد، وعدّل التوقيع. لضبط عدة صناديق دفعة واحدة، حددها وانقر التوقيع في شريط التحديد: يتغير فقط ما تحدده. التوقيع الافتراضي لمساحة العمل موجود ضمن الإعدادات، صناديق البريد.

عبر API

اضبط صندوق بريد واحدًا:

Shell
curl -X PUT "https://app.argorant.com/api/v1/inboxes/elena@acme.com/signature" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"template":"Best,\n{{sender_first_name}} {{sender_last_name}}\n{{sender_title}}, {{sender_company}}","title":"Head of Growth","replies_only":true}'

يعرض الرد توقيع صندوق البريد الخاص (own) والتوقيع الذي يستخدمه فعليًا (effective، مع source والنص الناتج text). يقرأه GET على العنوان نفسه، ويزيل DELETE التوقيع الخاص بصندوق البريد.

اضبط كل صناديق البريد على نطاق ما على النص نفسه:

Shell
curl -X POST "https://app.argorant.com/api/v1/inboxes/signature/bulk" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"domains":["acme.com"],"template":"Best,\n{{sender_first_name}}"}'

اختر صناديق البريد باستخدام emails أو domains أو tags أو order_id (كل صندوق بريد أنشأه طلب واحد) أو all: true. راجع وسوم صندوق البريد لاختيار طلب كامل دفعة واحدة. الحقول التي لا ترسلها تبقى كما هي في كل صندوق بريد. ويزيل clear: true تواقيعها الخاصة.

التوقيع الافتراضي لمساحة العمل هو GET وPUT وDELETE على /api/v1/signature. لترى كيف يبدو النص قبل حفظه، أرسله إلى POST /api/v1/signature/preview، مع email لاستخدام اسم صندوق بريد أو مع قيمك الخاصة.

عبر CLI ومساعدي الذكاء الاصطناعي

Shell
argorant inboxes signature set elena@acme.com --text "Best,\n{{sender_first_name}} {{sender_last_name}}" --title "Head of Growth"
argorant inboxes signature bulk --domains acme.com --text "Best,\n{{sender_first_name}}"
argorant signature default set --text "Best,\n{{sender_first_name}}"
argorant signature preview --text "Best,\n{{sender_first_name}}" --mailbox elena@acme.com

يوقف --in-campaigns خيار الردود فقط. في Claude وChatGPT الأدوات هي argorant_get_signature وargorant_set_inbox_signature وargorant_set_inbox_signatures وargorant_set_default_signature وargorant_preview_signature.

في هذه الصفحة