وب هوک یک تماس HTTPS ایجاد شده توسط شریک است که مشخص می کند نماینده شما چگونه باید به پیام ها و رویدادها پاسخ دهد. مگر اینکه از یک راه حل خودکار از پیش ساخته شده مانند Dialogflow استفاده کنید، باید یک وب هوک سفارشی تنظیم کنید تا رفتار نماینده خود را تعریف کند.
وب هوک در سطح شریک و نماینده
شما می توانید وب هوک خود را در سطح شریک یا در سطح نماینده تنظیم کنید. وب‌قلاب‌های سطح شریک برای هر عاملی که شما نگهداری می‌کنید اعمال می‌شود، در حالی که وبک‌هوک‌های سطح عامل هر کدام برای یک نماینده خاص اعمال می‌شوند.
اگر چندین عامل را با رفتار متمایز کار می کنید، ممکن است بخواهید با استفاده از تنظیمات سطح عامل، یک وب هوک متفاوت برای هر عامل تنظیم کنید. از طرف دیگر، اگر نمایندگان شما رفتار مشابهی دارند، یا اگر فقط یک نماینده دارید، می توانید از webhook در سطح شریک استفاده کنید.
اگر هم یک وب هوک در سطح شریک و هم وبکهک در سطح عامل پیکربندی شده‌اید، وب‌هوک سطح عامل بر عامل خاص خود اولویت دارد، در حالی که وبکهک در سطح شریک برای نمایندگانی اعمال می‌شود که وب هوک در سطح عامل ندارند.
وب هوک در سطح شریک خود را تنظیم کنید
برای تنظیم وب هوک در سطح شریک، این مراحل را دنبال کنید:
- کنسول توسعه‌دهنده Business Communications را باز کنید و با حساب Google Business Messages خود وارد شوید.
- تنظیمات حساب را باز کنید.
- مطمئن شوید که حساب شریک صحیح انتخاب شده است.
- برای نشانی اینترنتی وب هوک پیام‌های تجاری ، روی پیکربندی کلیک کنید.
- برای URL نقطه پایانی Webhook ، URL برنامه خود را + "/callback/" وارد کنید. برای مثال، ممکن است چیزی شبیه به "https://PROJECT_ID.appspot.com/callback/" باشد.
- به ارزش
clientTokenخود توجه کنید. برای تأیید اینکه پیام‌هایی که دریافت می‌کنید از Google ارسال می‌شوند به آن نیاز دارید. وب هوک خود را طوری پیکربندی کنید که درخواست POST را با پارامتر
clientTokenمشخص شده بپذیرد و یک پاسخ200 OKبا مقدار متن ساده پارامتر مخفی به عنوان بدنه پاسخ ارسال کند. به عنوان مثال، فرض کنید وب هوک شما یک درخواست POST با محتوای بدنه زیر دریافت می کند:{
"clientToken":"SJENCPGJESMGUFPY",
"secret":"0123456789"
}در آن صورت، webhook شما باید مقدار
clientTokenرا تأیید کند و اگرclientTokenدرست باشد، یک پاسخ200 OKبا0123456789به عنوان بدنه پاسخ برگرداند.در کنسول، روی تأیید کلیک کنید. هنگامی که Business Messages وب هوک شما را تأیید می کند، کادر گفتگو بسته می شود.
یک وب هوک در سطح عامل تنظیم کنید
شما پیام هایی را دریافت می کنید که برای نماینده خود در وب هوک در سطح شریک خود ارسال می شوند. اگر می‌خواهید پیام‌هایی برای یک عامل خاص به وب‌هوک دیگری برسد، می‌توانید یک وبکهک در سطح عامل تنظیم کنید.
- کنسول توسعه‌دهنده Business Communications را باز کنید و با حساب Google Business Messages خود وارد شوید.
- روی نماینده خود کلیک کنید
- روی Integrations کلیک کنید.
- برای Webhook ، روی پیکربندی کلیک کنید.
- برای URL نقطه پایانی Webhook ، نشانی اینترنتی وب هوک خود را وارد کنید که با "https://" شروع می شود.
- به ارزش
clientTokenخود توجه کنید. برای تأیید اینکه پیام‌هایی که دریافت می‌کنید از Google ارسال می‌شوند به آن نیاز دارید. وب هوک خود را طوری پیکربندی کنید که درخواست POST را با پارامتر
clientTokenمشخص شده بپذیرد و یک پاسخ OK 200 با مقدار پارامتر مخفی ارسال کند. به عنوان مثال، فرض کنید وب هوک شما یک درخواست POST با محتوای بدنه زیر دریافت می کند:{
"clientToken":"SJENCPGJESMGUFPY",
"secret":"0123456789"
}در آن صورت، وب هوک شما باید مقدار
clientTokenرا تأیید کند و اگرclientTokenدرست باشد، یک پاسخ200 OKبا پارامتر URL مخفی تنظیم شده روی0123456789برگرداند.در کنسول، روی تأیید کلیک کنید. هنگامی که Business Messages وب هوک شما را تأیید می کند، کادر گفتگو بسته می شود.