قائمة اختيارات

يمكن للرقم أن يعرض على من يكتبون إليه قائمة قصيرة: «1 للأسعار، 2 لمواعيد العمل، 3 للتحدث مع موظف». يردّون برقم الاختيار، فيرسل رقمك ما حددته له. لا كود تكتبه ولا مخطط ترسمه: تحية، وحتى تسعة اختيارات، وما يفعله كل اختيار.

أعدّها من لوحة التحكم تحت الردود التلقائية ← القائمة، حيث ترى تمامًا ما سيصل إلى الناس وتستطيع إرسالها إلى نفسك أولًا. أو استخدم الـ API في الأسفل.

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

ما يمكن أن يفعله الاختيار#

• إرسال رد: كلمات تكتبها، أو أحد ردود فريقك المحفوظة. يُقرأ الرد المحفوظ وقت إرساله، فتعديله مرة واحدة يغيّر القائمة أيضًا.
• فتح قائمة فرعية: بمستوى واحد فقط. الاختيار داخل قائمة فرعية يرسل ردًّا أو يحوّل إلى موظف؛ ولا يفتح قائمة أخرى. داخل القائمة الفرعية، يعيد 0 إلى القائمة الأولى.
• التحويل إلى موظف: يُخبَر الشخص بذلك بكلماتك («سيرد عليك أحد أفراد فريقنا هنا.»)، وتنتظر المحادثة تحت «بانتظار الرد» في المحادثات. يمكنك أيضًا وضع تصنيف على المحادثة وإسنادها إلى أحد أفراد فريقك. المحادثة التي يتولاها أحد أفراد فريقك بالفعل تبقى معه.

كيف يختار الناس#

• رقم الاختيار وحده: 2 أو ٢. لا تهم المسافات أو النقطة حوله، ويمكن للناس استخدام أي من شكلَي الأرقام أيًّا كان ما تعرضه قائمتك.
• أو نص الاختيار نفسه، كرسالة كاملة: «مواعيد العمل».
• أي شيء آخر ليس اختيارًا: «2 من فضلك»، أو «12»، أو صورة. عندها تُعرض القائمة مرة أخرى. لكنها لا تُعرض لما كتبه الشخص قبل أن تصله القائمة أو خلال دقيقة من وصولها: عدة رسائل متتالية تنال قائمة واحدة.
• تبقى القائمة مفتوحة 4 ساعات بعد إرسالها. بعد ذلك، أيًّا كان ما يكتبه الشخص، تصله القائمة الأولى من جديد. ويحدث الأمر نفسه حين تغيّر القائمة.

متى ترد، ومتى تصمت#

• فقط من كتب إلى الرقم للتو، في محادثة فردية. ولا ترد أبدًا على مجموعة، أو قناة، أو شخص كتب «STOP»، أو محادثة الرقم مع نفسه، أو أحد إشعارات واتساب الفارغة، أو رسالة مضى عليها أكثر من 15 دقيقة.
• كلمة أو رقم يفتحها. الرسالة التي بلا كلمات إطلاقًا (رمز تعبيري، أو ملصق، أو صورة بلا تعليق) لا تفتح القائمة، فهكذا يكون الرد على حالتك عادةً. وبعد أن تُفتح القائمة، تُعدّ رسالة كهذه شيئًا ليس اختيارًا.
• رد واحد لكل رسالة. الرد التلقائي على كلمة مفتاحية تطابق الرسالة تمامًا يرد أولًا. ثم اختيار من القائمة المفتوحة؛ ثم أي كلمة مفتاحية أخرى؛ ثم رد الغياب خارج ساعات عملك، مرة واحدة في اليوم؛ ثم القائمة. وما دامت القائمة مفعّلة، فهي ترحّب بالناس بدلًا من رد الترحيب.
• لا حلقة مفرغة أبدًا. من يواصل كتابة ما ليس اختيارًا يرى القائمة نفسها مرتين على الأكثر. وفي المرة الثالثة، تذهب المحادثة إلى فريقك بدلًا من ذلك، مع جملة التحويل التي كتبتها.
• بعد التحويل، يصمت كل رد آلي في تلك المحادثة: القائمة، وردود الكلمات المفتاحية، ووكيل الذكاء الاصطناعي. وينتهي ذلك بأول ما يحدث من هذه: يرد أحد أفراد فريقك على المحادثة من لوحة التحكم أو الهاتف، أو تُحدَّد المحادثة كمنتهية. أو ترسل أنت إلى ذلك الشخص رسالة عبر الـ API، أو تمر 24 ساعة دون أن يرد أحد.
• فريقك يتولى المحادثة: بعد أن يرد أحد أفراد فريقك على محادثة، تصمت القائمة فيها 24 ساعة، كما يفعل وكيل الذكاء الاصطناعي.
• إذا كان وكيل الذكاء الاصطناعي مفعّلًا أيضًا، تأتي القائمة أولًا. بعدها، الرسالة التي ليست اختيارًا تذهب إلى وكيل الذكاء الاصطناعي، والاختيار للقائمة. وإن كان الوكيل يرد فقط حين لا يرد فريقك (no_reply)، تنتظر تلك الرسالة مهلته أولًا. ولا يردّان معًا على رسالة واحدة أبدًا. راجع وكيل الذكاء الاصطناعي.
• الحدود: رسائل القائمة ردود تلقائية: 5 في الساعة و20 في اليوم على الأكثر للشخص الواحد، وتُحسب في باقتك كأي رسالة. بعد هذه الحدود لا يُرسل شيء آخر، لكن الاختيار الذي يحوّل إلى موظف يظل يسلّم المحادثة إلى فريقك.

في المحادثة، يرى فريقك الرسائل التي أرسلتها القائمة والاختيار الذي ترد عليه كل رسالة.

الـ API#

GET /v1/instances/{id}/menu
PUT /v1/instances/{id}/menu
{
  "enabled": true,
  "greeting": "Hello! Reply with 1, 2 or 3.",
  "digits": "western",
  "back_label": "Back",
  "handover_message": "Someone from our team will answer you here.",
  "choices": [
    {"label": "Prices", "outcome": "answer", "answer": "A croissant is EGP 25."},
    {"label": "Orders", "outcome": "menu", "greeting": "About an order:", "choices": [
      {"label": "Delivery times", "outcome": "answer", "answer": "We deliver within 2 hours."},
      {"label": "A problem with my order", "outcome": "person"}
    ]},
    {"label": "Talk to someone", "outcome": "person", "message": "Mona will answer you shortly."}
  ]
}

القائمة مستند واحد. GET يعيدها، وPUT يستبدلها كاملة: أرسل كل اختيار، بالترتيب الذي تُرقَّم به. ما يعيده GET هو ما يقبله PUT. يحتاج PUT إلى مفتاح وصول كامل. القائمة التي لن تعمل تُرفض برمز 422 يسمّي الحقل، ولا يتغير شيء.

• enabled: هل ترد القائمة. greeting: السطر الذي يسبق الاختيارات، حتى 600 حرف. digits: western (1 2 3) أو arabic (١ ٢ ٣).
• handover_message: ما يُقال للشخص حين تذهب المحادثة إلى فريقك، وكذلك حين تحوّل القائمة من تلقاء نفسها. back_label: اسم الاختيار 0 في القائمة الفرعية؛ وهو مطلوب حين يفتح اختيارٌ قائمة فرعية.
• choices: من 1 إلى 9. لكل اختيار label (حتى 40 حرفًا، وفيه حرف واحد على الأقل: رقمه يُضاف تلقائيًا) وoutcome:
  • answer، مع answer (حتى 1,000 حرف) أو saved_answer_id؛
  • menu، مع choices خاصة بها (من 1 إلى 9، وكل منها answer أو person)، ومع greeting إن شئت، يظهر فوقها بدلًا من نص الاختيار؛
  • person، ومعه إن شئت message خاصة به، وassign_to (معرّف أحد أفراد فريقك)، وchat_label_id (أحد تصنيفات صندوق المحادثات لديك). اختر هذين الاثنين من لوحة التحكم: فيعرض GET معرّفيهما.
• لا يجوز أن يتطابق نص اختيارين في القائمة نفسها. ولا يجوز أن يكون نص الاختيار، أو back_label، كلمة يرسلها الناس لإيقاف رسائلك أو استئنافها، مثل «توقف» أو «ابدأ».