MaviBot конструкторы WhatsApp Business ресми API-ін де қолдайды.

WhatsApp Business-ті қосу жолы

WhatsApp Business API (WABA) жобаңызға қосу үшін Messengers бөліміне өтіп, WhatsApp Business API таңдаңыз.

WhatsApp Business API қосылуда

Ашылған терезеде Facebook аккаунтыңызбен кіріңіз. Содан кейін «Facebook арқылы қосылу» түймесін басыңыз.

Қажет болса, жалғастыру үшін Facebook құпия сөзін енгізіңіз.

Орнату енді аяқталды. Телефоныңызды әрқашан онлайн ұстаудың қажеті жоқ; бот тұрақты және автономды жұмыс істейді.

WhatsApp Business API үшін хабарлама үлгілері

WhatsApp Business API пайдаланған кезде, пайдаланушылар сұр WhatsApp-қа ұқсас, 24 сағаттық тұтынушыларға қызмет көрсету терезесінен тыс, бот жасау кезінде күннің кез келген уақытында клиенттерге жаза алмайды және шексіз хабарлама жібере алмайды.

24 сағаттық терезеден тыс, тек WhatsApp хабарлама үлгілерін (немесе WhatsApp үлгі хабарламаларын) пайдалануға болады, оның барысында таңдалған санат аясында байланыс тегін жүзеге асырылады.

Бұл функция WhatsApp-та спам жіберудің алдын алу үшін қолданылады, белгілі бір уақыт аралығында рұқсат етілген хабарламалар санын шектеу, сондай-ақ үлгілерге санат тағайындау арқылы жүзеге асырылады.

Meta компаниясы WhatsApp Business API үшін келесі хабарлама санаттарын орнатқан:

1. Пайдалы үлгілер (транзакциялар, шот-фактуралар, төлемдер және т.б. туралы нақты ақпаратты қамтиды);

2. Маркетингке арналған үлгілер (компания, ұйым, стратегиялар, жарнама және жылжыту туралы ақпарат);

3. Тексеру және аутентификацияға арналған үлгілер.

WABA үшін жасалған үлгілер модерациядан өтеді.

Үлгіні қабылдамаудың негізгі себептері

Үлгілердің едәуір бөлігі бірнеше себептерге байланысты WhatsApp модерациясынан өтпейді:

  1. Шамадан тыс жарнама: WhatsApp Business жарнама мен жарнамалық контентпен шамадан тыс жүктелген үлгілерді қабылдамайды. Егер модераторлар немесе платформаның жасанды интеллекті жарнама негізгі хабарламаны көлеңкелейтінін анықтаса, үлгі бұғатталады.
  2. Өнім саясатын бұзу: есірткі, психотроптық заттар, алкоголь, темекі, интимдік қызметтер немесе адамның қадір-қасиетін төмендететін кез келген контентті насихаттайтын үлгілер қабылданбайды.
  3. Екіұштылық, оммиссия немесе жалғандық: егер WhatsApp модераторлары жасырын астарлы мәтінді, жаңылыстыратын ақпаратты немесе сіздің компанияңыз немесе қызметіңіз туралы нақты мәліметтердің жоқтығын анықтаса, үлгі мақұлданбайды.
  4. Құпия ақпаратты жинау: пайдаланушылардың құпия деректерін (мысалы, паспорт нөмірлері, банк картасының деректемелері, жеке сәйкестендіру нөмірлері, үй мекенжайлары) жинауға арналған үлгілер модерациядан өтпейді.
  5. Ренжітетін контент: нәсіліне, ұлтына, жынысына, сәйкестігіне немесе басқа критерийлерге байланысты пайдаланушыларды ренжітуі мүмкін кез келген ақпаратты қамтитын кез келген хабарлама қабылданбайды.
  6. Ықтиярлық қабылдамау: WhatsApp модераторлары нақты себеп көрсетпей-ақ үлгілерді қабылдамау құқығын өзінде сақтайды.

Хабарлама үлгілерін қалай орнатуға болады

Үлгілер блоктардан жасалғандықтан, оны WhatsApp Business API үлгісі үшін пайдаланбас бұрын, алдымен ағыныңызда блок жасауыңыз керек.

  • Құны және бірінші хабарлама: 24 сағаттық сөйлесу терезесі ішінде үлгі хабарламаларды жіберу тегін. Клиентке бірінші хабарлама тек Meta (Facebook) мақұлдаған үлгі болуы мүмкін.
  • 24 сағаттан кейін: Чат ашылғаннан бері 24 сағат өткеннен кейін, пайдаланушыны қайта тарту үшін тек басқа мақұлданған үлгіні жібере аласыз.
  • Модерация ескертуі: Үлгілерде айнымалылар болса (кириллица немесе латын әріптерімен), олар модерациядан өтпеуі мүмкін.

MaviBot-та үлгілерді жасау

  1. Channels бөліміне өтіп, WhatsApp Business API таңдаңыз, содан кейін Message templates таңдаңыз.

  1. «Create template» түймесін басыңыз. Бұл үлгі жасау бетін ашады.
  2. Үлгілер ағыныңыздағы блоктарға байланыстырылған. Әдепкі бойынша, үлгі мазмұны блоктан алынады, бірақ сіз теңшелетін мәтін мен түймелерді көрсете аласыз.

  1. Хабарлама үлгісі жасалғаннан кейін модерацияға жіберіледі. Сіз тек мақұлданған үлгілерді пайдалана аласыз. Модерация әдетте шамамен 8 сағатты алады, ең көбі 48 сағат.

Үлгі түрлері

Таңдауға болатын 3 түрлі үлгі бар.

MARKETING үлгісіне келесі форматтардағы суретті қосуға болады: SVG, PNG, JPG және GIF.

Үлгілерде айнымалыларды қалай беруге болады

Үлгілердегі айнымалылар MaviBot бойынша бірдей өңделеді, WhatsApp-тың жергілікті форматына сәйкес емес.

Біздің жүйе MaviBot айнымалыларына бейімделген және {{1}} форматындағы айнымалыларды қолдамайды

WhatsApp үлгі хабарламаларында айнымалыларды пайдалану

Хабарлама үлгілерінде айнымалыларды пайдалану қажет болса, мына ережені орындаңыз: айнымалы атауларды әрқашан тек латын әріптерімен жазыңыз, мысалы, #{example}. Жібергеннен кейін, айнымалылардың дұрыс өңделгенін тексеру үшін хабарламаны берілген сілтеме арқылы тексеріңіз.

Егер үлгіде айнымалы болса, бірақ бот оған мән тағайындамаса немесе мән жоқ болса, хабарлама жіберілмейді!

Үлгілерде түймелер қалай жұмыс істейді

Хабарлама үлгілері түймелерді қолдайды. MaviBot-та түймелер синтаксиске ұқсас орнатылады

Facebook API. Сіз онымен сілтеме арқылы таныса аласыз:

Түймелер JSON массив форматында орнатылады.

Түйме жасау параметрлері:

Параметр Міндетті Сипаттама
type Иә Мәндер: PHONE_NUMBER, URL және QUICK_REPLY
text Иә Түйме мәтіні
url Жоқ

Түйме басылғанда ашылатын URL

Динамикалық сілтемелер жасау үшін айнымалыларды пайдалануға болады.
phone_number Жоқ

Түйме басылғанда қоңырау шалуға болатын телефон нөмірі
example Жоқ

Үлгіңіз үшін ықтимал деректердің мысалын ұсынады. Бұл шолу және мақұлдау процесіне көмектеседі, осылайша сіз

қандай хабарлама жіберуді жоспарлап отырғаныңызды түсіне аласыз. Бұл мысалдар екеніне және құпия немесе жеке ақпаратты қамтымайтынына көз жеткізіңіз.

Мысалы: Екі түймесі бар хабарлама: [{"type":"QUICK_REPLY", "text": "Иә, ыңғайлы"}, {"type":"QUICK_REPLY", "text": "Ыңғайсыз"}]

Үлгілердегі түйме мүмкіндіктері

Үлгі хабарламаларда түймелердің екі түрі қолжетімді:

  1. Call-To-Action (CTA): Сілтеме немесе телефон нөміріне арналған түйме (мәтінінің жанында сілтеме немесе телефон тұтқасы белгішесімен көрсетіледі).
  2. Жылдам жауап: 20 таңбамен шектелген стандартты мәтіндік түймелер.

Шектеулер:

  • Бір үлгіде 3 Жылдам жауап түймесіне және 2 Call-to-Action түймесіне дейін болуы мүмкін. Дегенмен, бір уақытта екі сілтемені немесе екі телефон нөмірін пайдалана алмайсыз.
  • Түймелерге айнымалылар, жол тасымалдары, эмодзи немесе пішімдеу белгілері кірмейді.

Мінез-құлық:

  • Жылдам жауап түймесін басу оның мәтінін пайдаланушыдан жауап хабарлама ретінде жібереді.
  • Call-to-Action түймесі файлға сілтеме аша алады.
  • Телефон қоңырауына арналған Call-to-Action түймесін басу стандартты терушіні ашады. WhatsApp Web-те жұмыс үстелі нұсқасынан қоңырау шалу мүмкін еместігі туралы хабарландыру пайда болады.

Үлгі модерациясы қалай жұмыс істейді

Әрбір үлгі жасалғаннан кейін бірден модерацияға жіберіледі. Процесс әдетте шамамен 8 сағатты алады, ең көп шолу уақыты 48 сағат.

Модерация мәртебесін үлгілер тізімінде бақылай аласыз.

Егер үлгі қабылданбаса, қабылдамау себебі көрсетіледі.

Мақұлдану ықтималдығы жоғары үлгілер әдетте:

  • Анық, кәсіби тілді қолданады.
  • Нақты, заңды пайдалану жағдайына қызмет етеді (мысалы, кездесу еске салғыштары, тапсырыс жаңартулары).

Маңызды: Курсивпен жазылған мәтін айнымалы және теңшелетін болуы мүмкін.

Сәлеметсіз бе, біз сізге жете алмадық. Осы жерде сөйлесуді жалғастыру сізге ыңғайлы ма?

Сәлеметсіз бе, сіз веб-сайтта хабарлама қалдырдыңыз және менен сізбен байланысуды сұрадыңыз. (өзгертуге болады)

Сәлеметсіз бе, мен MaviBot-тан Джон Смитпін. Бұрын сіз чат-бот жасауға өтінім берген едіңіз. Бізде сізге арналған жаңалық бар екенін хабарлауға қуаныштымыз.

Модерациядан өтпейтін үлгілер:

кез келген жарнамалық мәтін

24 сағаттық терезе ішінде екеніңізді қалай тексеруге болады

Триггер шартыңызда days_from_last_message() функциясын пайдаланып, клиенттің соңғы хабарламасынан бері қанша күн өткенін анықтай аласыз.

24 сағаттық терезені тексеру мысалы:

days_from_last_message() == 0

Расталмаған аккаунттарға арналған шектеулер

Расталмаған Facebook Business аккаунттары келесі шектеулерге тап болады:

  • Күніне 50 үлгі хабарлама (айлық төлемге кіреді).
  • Кіретін хабарламаларға шектеулер жоқ.

Бұл шектеулерді алып тастау үшін сіздің компанияңыз Business Verification процесінен өтуі керек, ол әдетте 2–3 апта алады.

Төлем жүйелері

Расталмаған аккаунттар үшін кіретін және шығатын хабарламалардың бағасын реселлеріңізден тексеріңіз.

Төлем тікелей 360dialog компаниясына жүзеге асырылады.

Хабарлама жіберу қателері

Жеткізу сәтсіздігінің ықтимал себептері:

  1. Алушының телефон нөмірі WhatsApp-та тіркелмеген.
  2. «Authentication» санатындағы үлгіні +91 (Үндістан) ел коды бар WhatsApp пайдаланушысына жіберу әрекеті. Қазіргі уақытта Authentication санатындағы үлгілерді Үндістандағы пайдаланушыларға жеткізу мүмкін емес.
  3. Алушы жаңартылған Қызмет көрсету шарттарын және Құпиялылық саясатын қабылдамаған.
  4. Жоғары сапалы пайдаланушы тәжірибесін сақтау үшін хабарлама жеткізілмеді (бұл жалпы саясат блогы).

Click-to-WhatsApp жарнама түрлендірулері

fb_pixel_event() функциясының құжаттамасына қосымша.

Meta* Click-to-WhatsApp жарнамасындағы әрбір басуды ctwa_clid басу идентификаторымен белгілейді. Ол тұтынушының бірінші WhatsApp хабарламасымен бірге алынады және әңгімедегі түрлендіруді нақты жарнамаға жатқызу үшін пайдаланылады — веб-сайттағы басуды пиксель оқиғаларына жатқызу сияқты.

Қолтаңба

fb_pixel_event(
    event_name,
    pixel_id,
    access_token,
    event_source_url,
    action_source,
    fbc,
    test_event_code,
    data,
    ctwa_clid,
    messaging_channel
)

Жаңа параметрлер

Параметр Сипаттама
ctwa_clid Click-to-WhatsApp жарнамасы үшін басу идентификаторы. Егер бұл параметр берілмесе, бот автоматты түрде сақтайтын ctwa_clid клиенттік айнымалысы қолданылады. Міндетті емес.
messaging_channel Түрлендіру болған мессенджер арнасы. Әдепкі мән — whatsapp. Міндетті емес.

Жаңа action_source мәні

action_source мәндер кестесіне келесі жол қосылады:

Мән Сипаттама
business_messaging Түрлендіру тұтынушы Click-to-WhatsApp жарнамасын басқаннан кейінгі әңгімеде болды.

Оқиға келесі шарттардың кемінде біреуі орындалғанда мессенджер түрлендіруі ретінде жіберіледі:

  • action_source="business_messaging" берілген;
  • ctwa_clid берілген;
  • messaging_channel берілген.

Бұл жағдайда Meta* action_source + messaging_channel + ctwa_clid комбинациясын алады. Бұл комбинациясыз жарнаманы басу түрлендіруге есептелмейді.

website мәні мессенджер түрлендірулері үшін қолданылмауы керек: оқиға пиксельге жетеді, бірақ жарнамаға есептелмейді.

Клиенттік айнымалылар

Тұтынушы жарнаманы басқаннан кейін WhatsApp хабарламасын жібергенде, бот басу деректерін тұтынушының клиенттік айнымалыларына сақтайды. Бұл айнымалыларды қолмен толтырудың қажеті жоқ.

Айнымалы Сипаттама
ctwa_clid Басу идентификаторы. Оқиғаға автоматты түрде қосылады.
ctwa_clid_time Идентификатор алынған уақыт, Unix уақыт форматында. Оны басудан бері қанша уақыт өткенін анықтау үшін қолдануға болады.
wa_ads_data JSON форматындағы жарнама деректері: жарнама URL-і, жарнама ID-і (source_id), тақырыбы, сипаттамасы, креатив түрі және креатив URL-і.

Басу идентификаторы клиенттік айнымалыдан автоматты түрде алынады, сондықтан оны функцияға анық берудің қажеті жоқ.

Тұтынушының телефон нөмірі data ішінде берілмесе, оқиғаға автоматты түрде қосылады.

event_source_url параметрі мессенджер түрлендірулері үшін қолданылмайды.

Шектеулер

Басу идентификаторы тек тұтынушы жарнамадағы түймені басқаннан кейінгі бірінші хабарламасымен бірге алынады. Ол кейінгі хабарламаларға қосылмайды. Сондықтан оқиға әңгіме кезінде кез келген уақытта жіберілуі мүмкін, бірақ тек бірінші хабарлама жарнамадан шыққан жағдайда ғана.

Meta* Android және iOS жүйелеріндегі Facebook* және Instagram* қолданбаларындағы басулар үшін ctwa_clid ұсынады.

Идентификатор тұтынушы браузерден басқанда немесе жарнама түймесінің орнына кәдімгі жазбаны басқанда берілмейді. Мұндай өзара әрекеттесулерден болатын түрлендірулер жарнамаға есептелмейді.

Егер тұтынушы кейінірек басқа жарнаманы басса, айнымалылар қайта жазылады. Түрлендіру тұтынушы келген ең соңғы жарнамаға есептеледі.

Егер басу идентификаторы функция параметрлерінде де, клиенттік айнымалыларда да болмаса, функция No ctwa_clid variable in client variables қатесін қайтарады және оқиға жіберілмейді.