چگونه یک صندوق ورودی واتس اپ در گپیفای پیکربندی کنم؟# اسکرین

می توانید مکالمات حساب تجاری واتس اپ خود را از طریق گپیفای مدیریت کنید. برای تنظیم میتوانید از بین ارائه دهنده های زیر یکی را انتخاب کنید:
‌‌۱− API مبوط به WhatsApp Cloud

۲− Twilio
ما تمام مراحل را در این راهنما توضیح خواهیم داد.

پیش نیازها

قبل از تنظیم صندوق ورودی WhatsApp خود در گپیفای ، باید مواردی در فراهم کننده API تنظیم کنید. این پیش نیازها در زیر توضیح داده شده است.

استفاده API مربوط به WhatsApp Cloud

اگر قصد دارید API مرتبط با فضای ابری واتساپ استفاده کنید، دو پیش نیاز زیر مورد نیاز است.

۱. Developer App فیس بوک خود را پیکربندی کنید

ابتدا باید Facebook Developer App خود را در حالی که WhatsApp Product فعال است ، ایجاد کنید. در راهنمای مرتبط با API مربوط به WhatsApp Cloud در این لینک بروید.

به قسمتی به نام Set up Developer Assets and Platform Access بروید و مراحل را دنبال کنید.

پس از اتمام این مرحله، اکنون می توانید شماره تلفن های مورد نیاز خود را در بخش واتساپ درFacebook developer app خود پیکربندی کنید. اگر مراحل را با موفقیت انجام دهید، باید بتوانید همانطور که در تصویر زیر نشان داده شده است ، شناسه شماره تلفن و شناسه حساب تجاری واتساپ را دریافت کنید. گپیفای برای ایجاد صندوق ورودی واتساپ به مقادیر زیر نیاز دارد.

۲. یک کاربر سیستم را جهت مدیریت کسب و کار فیس بوک خود تنظیم کنید

یک کاربر سیستم در مدیریت کسب و کار خود با دسترسی به برنامه واتساپ ایجاد کنید (راهنما). یک access token برای کاربر ایجاد کنید، که به عنوان کلید API برای تنظیم صندوق ورودی در گپیفای مورد نیاز است.

هنگام تولید access token ، مطمئن شوید که مجوزهای whatsapp_business_management و whatsapp_business_messaging انتخاب شده اند.

مرحله ۱. درصفحه مدیریت کسب و کار ، یک کاربر سیستم در tab System Users ایجاد کنید.

مرحله ۲. کاربر سیستم را اضافه کنید. در تب حساب‌های واتس‌اپ، «افزودن افراد» را انتخاب کنید و یک کاربر سیستمی را برای دسترسی به حساب تجاری واتساپ انتخاب کنید.

مرحله ۳. access token را ایجاد کنید و برای مجوزها را درخواست دهید.

برای راهنمایی بیشتر به این ویدیو مراجعه کنید.

استفاده از Twilio

اگر قصد استفاده از API های Twilio را دارید، برای استفاده از صندوق ورودی واتساپ، نیاز به موارد زیر است:
برای اتصال به صندوق ورودی واتساپ ، باید یک (Callback URL) را در صندوق ورودی Twilio تنظیم کنید. به مراحل زیر توجه کنید:

۱. وارد کنسول Twilio شوید.

۲. به قسمت Programmable SMS −>‌ Whatsapp −> Senders بروید.

۳. شماره تلفن خود را مشاهده خواهید کرد. بر روی آن کلیک کنید. یک فیلد مشابه زیر نمایش داده می‌شود.

لطفاً از این آدرس URL برای زمانی که یک پیام دریافت می‌شود در تنظیمات Twilio استفاده کنید: https://app.gapify.ai/twilio/callback

Twilio Studio

اگر از Twilio Studio برای گفتگو سفارشی استفاده می‌کنید، به‌روزرسانی URL webhook به صورت مستقیم ممکن است اتصال موجود شما را خراب کند.

برای موارد این گونه، می‌توانید مراحل زیر را دنبال کنید:

۱. مرحله‌ای را که می‌خواهید در ان ، واگذاری ایجنت اتفاق بیفتد را شناسایی کنید.

۲. make http request widget را با مقادیر داده شده به شکل زیر اضافه کنید.

REQUEST METHOD : POST

REQUEST URL: https://app.gapify.ai/twilio/callback

CONTENT TYPE: Application/JSON

REQUEST BODY: {{trigger.message | to_json }}

نکته: تغییرات مورد نیاز را بر اساس flow variables خود انجام دهید.

"ویجت ، درخواست HTTP پیام را به گپیفای ارسال خواهد کرد. این عمل باعث ایجاد یک گفتگو در گپیفای می‌شود که ایجنت می‌تواند به آن پاسخ دهد."

۳. اطمینان حاصل کنید که روند شما قادر به مدیریت مکالمه بین کاربر و ایجنت می باشد.

تنظیم صندوق ورودی واتساپ در گپیفای

برای راه‌اندازی صندوق ورودی واتساپ پر گپیفای ، با اطمینان از اینکه پیش‌نیازهای لازم را فراهم کرده‌اید، می‌توانید مراحل زیر را دنبال کنید.

مرحله ۱. به داشبورد گپیفای خود وارد شوید. به تنظیمات ->صندوق‌های ورودی -> افزودن صندوق ورودی بروید.

مرحله ۲. روی ایکون "WhatsApp" کلیک کنید.

مرحله ۳. یک ارائه دهنده API را انتخاب کنید. بر اساس انتخاب خود، مجموعه متفاوتی از فیلدها را مشاهده خواهید کرد که در ادامه توضیح داده شده اند.

انتخاب api های مرتبط با WhatsApp Cloud

«WhatsApp Cloud» را به عنوان ارائه‌دهنده API انتخاب کنید.

فیلدها در این قسمت توضیح داده شده است.

عنوان صندوق ورودی: یک نام برای صندوق خود انتخاب کنید. مثلاً نام کسب و کار شما.

شماره تلفن: شماره تلفنی که در facebook developer app تنظیم کرده‌اید را وارد کنید.

شناسه شماره همراه: شناسه شماره تلفن برای شماره مورد نظر، که در پیش‌نیازها به دست آمده است.

شناسه حساب تجاری: آیدی حساب تجاری برای شماره تلفن، که در پیش‌نیازها به دست آمده است.

کلید API: کلید API را وارد کنید.

access token webhook:

access token کاربر حساب تجاری برای شماره تلفن، که در پیش‌نیازها به دست آمده است.
این توکن درهنگام تنظیم webhook در facebook developer app مورد نیاز است. یک رشته امن که ترکیبی از حروف و اعداد باشد را به دلخواه وارد کنید.

مراحل دریافت Webhook Callback URL برای واتساپ به پایان رسید٫

فعال‌سازی webhook

webhook را در Facebook Developer App تنظیم کنید.

به بخش WhatsApp در Facebook Developer App بازگردید. به زیرمجموعه Configuration بروید و Callback URL را تنظیم کنید.

مقدار URL باید همان مقدار باشد که در پایان ایجاد صندوق ورودی گپیفای خود دریافت کرده‌اید و به این شکل خواهد بود:

https://app.chatwoot.com/webhooks/whatsapp/+{phone_number}

مقدار verify token باید همان مقداری باشد که برای Webhook Verify Token در زمان ایجاد صندوق ورودی تنظیم کرده‌اید.

همچنین باید در Facebook Developer App خود در زیر قسمت webhooks fields، message field events را تنظیم کنید.

وقتی همه مراحل را به پایان رساندید، این بخش باید مانند تصویر زیر باشد.

انتخاب Twilio

"Twilio" را به عنوان ارائه‌دهنده API انتخاب کنید.

فیلدها، در زیر توضیح داده شده‌اند.

نام صندوق ورودی :

این نام صندوق ورودی است که در سراسر برنامه استفاده خواهد شد.

شماره تلفن: از این شماره برای ارتباط با مشتری استفاده خواهد شد.توجه داشته باشید این شماره باید در twilio احراز هویت شود. در داشبورد twilio میتوانید این شماره را تنظیم کنید.

SID اکانت: SID اکانت در twilio است.پس از اینکه وارد حساب twilio شوید قادر خواهید بود تا SID اکانت و auth token را مشاهده کنید.

Auth token: پس از اینکه وارد حساب twilio شوید قادر خواهید بود تا auth token را مشاهده کنید.پس از وارد کردن اطلاعات، روی "ساخت کانال twilio" کلیک کنید.

مرحله ۴. ایجنت ها را به صندوق ورودی خود اضافه کنید.

شما با موفقیت یک صندوق ورودی واتساپ ایجاد کرده‌اید.

تنظیمات اضافی صندوق ورودی

صندوق ورودی واتساپ که تازه تنظیم کرده‌اید باید اکنون در لیست صندوق ورودی شما ظاهر شود. برای مشاهده و انجام تنظیمات اضافی در صندوق ورودی واتساپ خود، به مسیر زیر بروید:

تنظیمات -> صندوق های ورودی سپس روی آیکون چرخ‌دنده مربوط به صندوق ورودی واتساپ کلیک کنید.

انواع رسانه‌های پشتیبانی شده

صندوق ورودی واتساپ شما از انواع مختلف رسانه‌ها پشتیبانی می‌کند که به صورت زیر خلاصه شده‌اند.

صدا

فرمت های پشتیبانی‌شده:

aac
mp4
mpeg
amr
ogg

پشتیبانی‌شده برای: هر دو کاربر نهایی و ایجنت در گپیفای

اسناد

فرمت های پشتیبانی‌شده:

text/plain
application/pdf
application/vnd.ms-powerpoint
application/msword
application/vnd.ms-excel
application/vnd.openxmlformats-officedocument.wordprocessingml.document
application/vnd.openxmlformats-officedocument.presentationml.presentation
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

پشتیبانی‌شده برای: هر دو کاربر نهایی و ایجنت در گپیفای

تصویر

فرمت های پشتیبانی‌شده:

jpeg
png

پشتیبانی‌شده برای: هر دو کاربر نهایی و ایجنت در گپیفای

ویدئو

فرمت های پشتیبانی‌شده:

پشتیبانی‌شده برای: mp4 برای هر دو کاربر نهایی و ایجنت در گپیفای ، و 3gp فقط برای کاربر نهایی.

استیکر

فرمت های پشتیبانی‌شده: image/webp

پشتیبانی‌شده برای: فقط کاربر نهایی

سوالات متداول

چگونه چندین شماره را تحت یک اپلیکیشن فیس‌بوک تنظیم کنیم؟

اپلیکیشن فیس‌بوک فقط اجازه تنظیم یک Webhook endpoint را می‌دهد. بنابراین، در گپیفای برای تمامی شماره‌های مورد نیاز صندوق ورودی ایجاد کنید. شما باید URL وب‌هوکی که برای یکی از این صندوق های ورودی ارائه شده است را در اپلیکیشن فیس‌بوک تنظیم کنید تا تمامی صندوق های ورودی دیگر نیز کار کنند.

چه نوعی از قالب واتساپ توسط گپیفای پشتیبانی می‌شود؟

در حال حاضر، گپیفای فقط از قالب متنی پشتیبانی می‌کند. اگر قالب شما دارای سربرگ‌های رسانه‌ای یا اجزای سفارشی مانند دکمه‌ها، فرم‌ها و... باشد، در انتخابگر قالب گپیفای نمایش داده نخواهد شد.