دليل تكوين Webhooks في Zoho CRM باستخدام WOZTELL API لرسائل WhatsApp

إرسال رسائل WhatsApp باستخدام Zoho CRM Webhooks

قبل البدء في البرمجة، نوصي باستخدام الطريقة التالية: https://support.woztell.com/portal/en/kb/articles/whatsapp-workflows-inside-zoho-crm:


في Zoho CRM يمكننا إنشاء Webhooks لتنفيذ API. بالإضافة إلى ذلك، يمكن استخدام هذه Webhooks مع قواعد سير العمل لأتمتة الإجراءات. في هذه المقالة، سنرى كيفية استخدام Webhooks في Zoho CRM و WOZTELL API لإرسال رسائل WhatsApp. للقيام بذلك يمكننا اتباع الخطوات التالية:

  1. إنشاء رمز الوصول
  2. تكوين Webhook
    1. إرسال رسالة نصية
    2. إرسال رسالة قالب

إنشاء رمز وصول

تحتاج API الخاصة بـ WOZTELL إلى رمز وصول للتحقق من هوية المستخدم. لذلك، قبل البدء في استخدام API، يجب علينا إنشاء رمز وصول. للقيام بذلك، يمكننا استخدام وثائق المنصة لإنشاء رمز وصول.

Alert
تذكر أن API لإرسال الرسائل تستخدم الأذونات: bot:sendResponses, bot:admin
Info
يرجى ملاحظة أنه يجب عليك إنشاء رمز وصول قصير لـ Webhooks في Zoho CRM

انقر هنا للانتقال مباشرة إلى المقالة لإنشاء الرموز.

تكوين Webhook

في Zoho CRM، يمكننا إنشاء Webhook من خلال اتباع هذه الخطوات:

1. قم بتسجيل الدخول إلى حساب Zoho CRM الخاص بك
2. انتقل إلى الإعدادات

3. في قسم "الأتمتة"، انقر على "الإجراءات"

4. انقر على علامة التبويب Webhooks.


5. انقر على زر تكوين Webhook

6. قم بتسمية Webhook وإضافة وصف له


7. اختر القيمة POST كطريقة للـ URL

8. في URL للإشعار، يجب أن نضع عنوان URL للـ API ورمز الوصول. سيكون كالتالي:

Info

تذكر تغيير {woztell-access-token} إلى قيمة رمز الوصول الخاص بك.


9. في قسم نوع التفويض، اختر "عام"

10. يجب علينا تحديد وحدة CRM حيث سنقوم بتكوين هذا Webhook. في هذا المثال، العملاء المحتملون.


11. في قسم العنوان، لن نقوم بتكوين أي شيء.


12. في قسم الجسم، سنختار "Raw" كنوع و "JSON" كتنسيق.

13. بعد ذلك، سنكون قادرين على لصق ملف JSON بالمعلومات التي نريد إرسالها في مربع النص الذي ظهر.

Notes
{
  "channelId": "{woztell-platform-channel-id}",
  "recipientId": "{whatsapp-phone}",
  "response": [
    {response-message-type}
  ]
}

حيث ستكون المعلمات كما يلي:
channelId
 يتم استخدام معرف القناة لتحديد من أي رقم هاتف سيتم إرسال الرسالة. يمكننا الحصول على معرف القناة باتباع الخطوات الموضحة في هذه المقالة.
recipientId
يشير recipientID إلى رقم الهاتف الذي نريد إرسال الرسالة إليه. إذا كنا بحاجة لاستخدام حقل من Zoho CRM في Webhook، يمكننا كتابة # لعرض الحقول المتاحة. (على سبيل المثال: إذا اخترنا حقل "الهاتف المحمول" في وحدة "العملاء المحتملين"، ستضيف Zoho CRM النص ${Leads.Mobile} وستستخدم قيمة الهاتف المحمول عندما يتم تفعيل Webhook).
response
في الاستجابة، يمكننا إضافة الرسالة التي نريد إرسالها. كما هو موضح في الوثائق الرسمية لـ Woztell، هناك بعض أنواع الرسائل التي يمكن إرسالها.


إرسال الرسائل النصية

بعد الخطوات السابقة، لإرسال الرسائل النصية، يجب علينا إضافة معلمة الاستجابة في JSON مع التنسيق المحدد في وثائق API. في هذه الحالة، سيكون RAW الخاص بـ Webhook كما يلي:

Notes
{
  "channelId": "{woztell-platform-channel-id}",
  "recipientId": "{whatsapp-phone}",
  "response": [
    {
      "type": "TEXT",
      "text": "Hello World!"
    }
  ]
}
ستكون معلمة الاستجابة عبارة عن JSON يحتوي على القيم التالية:

type
 ستكون هذه القيمة دائمًا TEXT
text
محتوى الرسالة الذي نريد إرساله.




إرسال رسائل القوالب

بعد الخطوات السابقة، لإرسال رسائل القوالب، يجب علينا إضافة معلمة الاستجابة في JSON مع التنسيق المحدد في وثائق API. في هذه الحالة، سيكون RAW الخاص بـ Webhook كما يلي:

Notes
{
    "channelId": "{woztell-platform-channel-id}",
    "recipientId": "{whatsapp-phone}",
    "response": [
        {
            "type": "TEMPLATE",
            "elementName": "{whatsapp-template-name}",
            "languageCode": "{whatsapp-template-language}",
            "components": [
                {components-json-value}
            ]
        }
    ]
}

ستكون معلمة الاستجابة عبارة عن JSON يحتوي على القيم التالية:


type
هذه القيمة ستكون دائمًا TEMPLATE
elementName
هذا هو الاسم الفريد الذي يتم إنشاؤه عند إنشاء القالب. يمكننا الحصول على هذه القيمة من القناة في المنصة أو من مدير WhatsApp على مدير أعمال فيسبوك.
languageCode
هذا هو لغة القالب. يمكننا التحقق من لغات القالب من القناة في منصة Woztell أو من مدير WhatsApp على مدير أعمال فيسبوك. بالإضافة إلى ذلك، يمكنك التحقق من اللغات المتاحة في هذه المقالة.
components
معلمات القالب ستختلف بناءً على ما إذا كان القالب يحتوي على رأس، صور، صوت، فيديو، معلمات، تذييل و/أو أزرار. للقيام بذلك، قمنا بإعداد بعض الخطوات أدناه لإنشاء JSON لحقل المكونات.

إنشاء JSON للقوالب

يمكنك بسهولة الحصول على JSON لقالب من المنصة لإرساله عبر API. للقيام بذلك، ما عليك سوى اتباع الخطوات التالية:

2. ابحث عن الموارد ثم انقر على الردود.


3. انقر على "استجابة جديدة" لإنشاء استجابة جديدة.


4. بما أننا نريد إنشاء قالب WhatsApp جديد، في النافذة المعروضة يمكننا اختيار الخيارات المختلفة للقنوات المتاحة من خلال النقر على التبويب على اليسار.


5. في هذه القائمة، سنختار منصة WhatsApp Cloud باستخدام زر "المنصة".





6. الآن، في نوع الرسالة يمكننا اختيار قالب WhatsApp.


7. ثم، في القالب نختار التكامل الذي هو WABA الذي يحتوي على رقم الهاتف، ثم نضغط على زر "تحديث قالب الرسالة".


8. عند الضغط على الزر، يجب علينا اختيار القالب (قالب الرسالة)


9. بعد اختيارها، نترك خيار سياسة اللغة كما هو محدد، ثم نختار اللغة المطلوبة (اللغة).


10. بناءً على القالب، سيعرض المعلمات التي يجب أن نحددها. في حالتنا، لدينا معلمة في الجسم وزرين. نقوم بملئها بالقيم المطلوبة.


11. بمجرد ملء جميع بيانات القالب، انقر على زر "تأكيد".
12. الآن بعد أن تم ملء القالب، يمكننا الحصول على معلمات JSON من خلال النقر على متقدم.


13. في هذا القسم الجديد، يمكننا رؤية JSON الكامل للقالب، ولكننا مهتمون فقط بقيمة components و elementName و languageCode. يمكننا نسخ قيمة هذه المعلمات ولصقها في Webhook الخاص بـ Zoho CRM. سيبدو الأمر كما يلي مع جميع البيانات:




14. أخيرًا، يمكننا إضافة المتغيرات التي نريدها في المكونات في Webhook الخاص بـ Zoho CRM.


بمجرد الانتهاء من ذلك، يمكننا تطبيق هذا الـ Webhook في قاعدة سير العمل (Workflow Rule) على Zoho CRM.