WhatsApp

WhatsApp – це програма для обміну миттєвими повідомленнями та передачі голосу через IP, яка дозволяє користувачам надсилати повідомлення, здійснювати дзвінки та ділитися вмістом. Компанії можуть використовувати WhatsApp Business, щоб спілкуватися зі своїми клієнтами за допомогою текстових повідомлень, надсилати документи та надавати підтримку.

Попередження

WhatsApp - це лише програма Odoo Enterprise, яка не працює у версії Odoo Community. Щоб зареєструватися для випуску Odoo Enterprise, натисніть тут: Безкоштовна пробна версія Odoo.

Дивись також

Щоб отримати додаткові відомості про перехід із версії Odoo Community на версію Odoo Enterprise, перегляньте цю документацію: Перейдіть із Community на Enterprise.

За допомогою додатку Odoo WhatsApp компанія може підключити обліковий запис WhatsApp Business (WABA) до бази даних Odoo, що дозволяє:

  • Отримуйте та відповідайте на повідомлення WhatsApp безпосередньо з бази даних Odoo

  • Створіть нові шаблони з динамічними заповнювачами/змінними

  • Надсилайте попередньо схвалені шаблони, які використовують динамічні змінні, наприклад:

    • Комерційні позиції з додатку Продажі

    • Квитанції та рахунки-фактури з додатку Точка продажу

    • Квитки з додатку Події

WhatsApp – це служба обміну повідомленнями, якою керує Meta, яка є материнською компанією Facebook. WhatsApp широко використовується як засіб спілкування в багатьох країнах і багатьма компаніями. Ця документація стосується інтеграції бізнес-облікового запису WhatsApp із Odoo. Мета-акаунт компанії налаштовано в Odoo через з’єднання API.

Конектор WhatsApp підтримує два потоки: ініційований компанією та ініційований клієнтом. Компанія може ініціювати обговорення, надіславши шаблон одній або кільком людям. Після надсилання шаблону одержувач може відповісти, щоб ініціювати обговорення між відправником і одержувачем (якщо клієнт відповість протягом 15 днів, з’явиться вікно чату Обговорення).

Якщо обговорення ініційовано клієнтом (наприклад, шляхом відправлення на загальнодоступний номер WhatsApp компанії), Odoo відкриє груповий чат з усіма операторами, відповідальними за цей канал WhatsApp.

Порада

Рекомендується налаштувати кілька облікових записів WhatsApp для різних відділів. Наприклад, команда служби підтримки та відділи продажів можуть спілкуватися в чаті на різних каналах.

Конфігурація WhatsApp у Meta

Інтеграція WhatsApp з Odoo використовує стандартне з’єднання API і налаштовується на Meta за такими кроками:

  1. Створити бізнес-акаунт Meta

  2. Створити Meta обліковий запис розробника

  3. Налаштуйте додаток і продукт WhatsApp на консолі розробника Meta

  4. Перевірте підключення API.

Після підключення повідомлення надсилаються та отримуються через додаток Odoo Обговорення за допомогою WhatsApp API.

Налаштування Meta бізнес-облікового запису

Щоб створити обліковий запис Business у Meta (власник Facebook), перейдіть до: Facebook Business Manager. Почніть із натискання Створити обліковий запис, а потім введіть назву компанії, ім’я адміністратора та робочу електронну адресу. Потім натисніть Далі, і з’явиться спливаюче вікно з проханням підтвердити адресу електронної пошти. Після підтвердження натисніть Готово, щоб закрити вікно.

Далі виконайте інструкції в електронному листі, надісланому Facebook, щоб підтвердити створення бізнес-облікового запису та завершити процес налаштування.

Важливо

Якщо обліковий запис компанії пов’язано з особистим обліковим записом Facebook, адміністратор повинен переключатися між особистим обліковим записом і обліковим записом компанії протягом решти конфігурації.

Щоб перейти до бізнес-облікового запису, перейдіть до Facebook Developer Console і натисніть ім’я облікового запису у верхньому правому куті. Під заголовком Бізнес-акаунти клацніть потрібний бізнес, у якому має відбутися налаштування WhatsApp. Це буде обліковий запис, для якого Odoo надсилатиме та отримуватиме повідомлення WhatsApp.

Перемикання між особистим і бізнес-акаунтом Meta.

Важливо

Щоб створити обліковий запис Meta Business, користувач уже повинен мати особистий обліковий запис Facebook, який існував щонайменше одну годину до налаштування облікового запису Facebook Business. Спроба створити бізнес-акаунт раніше цього часу призведе до помилки.

Створення додатку

На інформаційній панелі Meta for Developers увійдіть за допомогою облікового запису розробника Meta. Якщо обліковий запис ще не налаштовано, прив’яжіть обліковий запис Facebook, щоб створити обліковий запис метарозробника.

Примітка

Обліковий запис розробника Facebook відрізняється від облікового запису бізнес Facebook. Хоча облікові записи розробників складаються з особистих облікових записів Facebook, бізнес-акаунти не, оскільки вони представляють бізнес і керують усіма активами бізнесу в Meta, наприклад програмами.

Натисніть Мої додатки у верхньому правому куті після успішного входу в обліковий запис Meta розробника. Це перенаправить адміністратора до всіх програм, які розробник налаштував у цьому конкретному обліковому записі розробника. Натисніть Створити додаток, щоб розпочати процес налаштування нового додатку Meta.

Тип додатку

На сторінці Create an app виберіть Other під розділом, Looking for something else?, а потім натисніть Next, щоб перейти на іншу сторінку, щоб вибрати тип програми. Потім клацніть перший параметр із списку під міткою Select an app type під назвою Business. Цей вибір дозволяє створювати та керувати WhatsApp API.

Тепер натисніть Next, щоб налаштувати програму за бажанням. Коли тип програми буде налаштовано, адміністратор перейде до розділу подробиць додатку.

Деталі додатку

У розділі Details процесу Create an app введіть Odoo у полі під міткою Add an app name.

Примітка

За потреби назву додатку можна змінити пізніше в налаштуваннях.

Попередження

У цьому текстовому розділі заборонено використовувати товарні знаки та фірмові елементи. До них відноситься група компаній Мета. Не включайте слово: WhatsApp, інакше система позначить це як помилку.

Далі введіть адресу електронної пошти розробника в полі під міткою Контактна електронна адреса додатку.

Нарешті, встановіть у полі Business Account - Optional профіль Мета-бізнес-акаунту за допомогою спадного меню. Щоб завершити, натисніть Create app. Ця дія призведе до створення програми та запиту Meta Platform Terms та Developer Policies угод.

Щоб прийняти угоди, введіть пароль Facebook з міркувань безпеки та натисніть Submit, щоб завершити створення програми. Потім браузер переспрямовує на панель інструментів Meta for Developers.

Примітка

Якщо бізнес-акаунт Meta заборонено рекламувати, вимагати додаток не буде дозволено. Щоб вирішити цю проблему, перейдіть за допомогою до https://business.facebook.com/business.

Для отримання додаткової інформації перегляньте документацію Meta щодо рекламних обмежень <https://www.facebook.com/business/help/975570072950669>`_.

Додайте продукт WhatsApp до додатку

Тепер, коли базову структуру додатку створено, потрібно буде додати продукт до додатку. Почніть із доступу до інформаційної панелі додатку Meta, перейшовши до https://developers.facebook.com/apps і клацнувши додаток, який налаштовується.

На наступній сторінці: оскільки використовуватиметься WhatsApp, клацніть Налаштувати біля поля, що містить WhatsApp, розташованого внизу сторінки.

Потім сторінка спрямовує на сторінку конфігурації для WhatsApp Business Platform API. Використовуйте спадне меню, щоб вибрати Meta-бізнес, який потрібно налаштувати для параметра Виберіть обліковий запис Meta Business, а потім натисніть Continue, щоб підтвердити вибір.

Примітка

Коли натиснуто Continue, адміністратор погоджується з умовами Meta, посилання на які розміщено на Meta App Dashboard.

Примітка

Коли продукт WhatsApp буде додано до додатку, Meta надасть тестовий номер телефону WhatsApp із 5 тестовими повідомленнями.

Почніть використовувати API WhatsApp

Після завершення попереднього майстра продукту WhatsApp і натискання Continue, браузер повинен був перейти на сторінку WhatsApp Quickstart; на цій сторінці Quickstart можна почати налаштування WhatsApp API, додавши номер телефону та надіславши початкове тестове повідомлення.

Перехід до майстра швидкого запуску WhatsApp на інформаційній панелі Meta for Developer.

Примітка

Якщо веб-переглядач не знаходиться на сторінці Quickstart для WhatsApp, перейдіть до https://developers.facebook.com/apps і клацніть додаток, який налаштовується (назва додатку – Odoo, якщо ви дотримувались інструкцій вище).

Потім у меню ліворуч на сторінці натисніть піктограму v (перемикач меню) поруч із заголовком розділу WhatsApp. Відкриється невелике меню з такими параметрами:

  • Швидкий старт

  • Налаштування API

  • Конфігурація

Натисніть опцію Quickstart, а потім натисніть Start using the API.

Налаштування API

Після натискання Start using the API сторінка переходить до API Setup. Тепер, коли тестовий номер створено, можна надіслати тестове повідомлення, щоб підтвердити, що WhatsApp працює належним чином. Для початку перейдіть до розділу на сторінці з позначкою Send and receive messages та клацніть спадне меню поруч із Кому під Step 1 Select phone numbers.

Тепер виберіть єдину доступну опцію: Manage phone number list. Дотримуйтеся вказівок і додайте до п’яти номерів, на які потрібно надіслати безкоштовні тестові повідомлення. Після введення відповідного коду країни та номера телефону натисніть Next.

Важливо

Додавання номера телефону для надсилання на цьому кроці дозволить терміналу надіслати успішний тест. Це дуже важливо для того, щоб переконатися, що API WhatsApp працює.

Потім на номер телефону надсилається код підтвердження з WhatsApp Business, який потрібно ввести на наступному екрані, щоб підтвердити право власності на номер. Введіть код підтвердження та натисніть Next, щоб підтвердити номер.

Надіслати тестове повідомлення через термінал

Далі надішліть тестове повідомлення через термінал. У розділі з позначкою Step 2 Send messages with the API натисніть Send Message. Потім на номер телефону, указаний у попередньому розділі, буде надіслано тестове повідомлення.

Після успішного отримання повідомлення на номер перейдіть до наступного розділу, щоб створити та налаштувати веб-хуки.

Конфігурація WhatsApp в Odoo

Наступні кроки, налаштовані в цьому розділі, виконуються в базі даних Odoo. Кілька різних значень для маркера, номера телефону та ідентифікаторів облікових записів потрібно налаштувати в Odoo; ці значення необхідні для створення URL-адреси зворотного виклику та Маркер перевірки веб-хука, які потім використовуються для налаштування веб-хуків (щоб отримувати повідомлення назад у базу даних).

В Odoo перейдіть до WhatsApp ‣ Конфігурація ‣ WhatsApp Business Accounts. Потім натисніть Новий, щоб налаштувати бізнес-акаунт WhatsApp в Odoo.

На іншій вкладці веб-переглядача перейдіть до https://developers.facebook.com ‣ Мої додатки ‣ WhatsApp ‣ Конфігурація API, а потім скопіюйте наступні значення з консолі розробника Meta у відповідні поля в Odoo:

Ім’я

Консоль Meta

Інтерфейс Odoo

Телефон

ID номера телефону

ID номер телефону

Токен

Тимчасовий маркер доступу

Токен доступу

ID додатка

ID додатку

ID додатку

ID облікового запису

ID бізнес-облікового запису WhatsApp

ID облікового запису

Щоб отримати Секрет додатку, перейдіть до Meta -консолі розробника https://developers.facebook.com/apps і виберіть додаток, у якій налаштовано Odoo. Потім у меню зліва в Налаштування виберіть Основні.

Потім натисніть Показати поруч із полем Секрет додатку і введіть пароль облікового запису, щоб підтвердити право власності. Скопіюйте Секрет додатку, а потім вставте це скопійоване значення в поле Секрет додатку на інформаційній панелі Odoo Бізнес-акаунт WhatsApp.

Щоб завершити налаштування бізнес-облікового запису WhatsApp в Odoo, натисніть Тестувати з’єднання. Якщо конфігурацію встановлено правильно, у верхньому правому куті інформаційної панелі з’явиться зелене повідомлення про успішне виконання.

Налаштування веб-хуків

Щоб налаштувати веб-хуки для WhatsApp в Odoo, перейдіть до https://developers.facebook.com/apps і виберіть додаток, у якій Odoo налаштовується. Далі під заголовком меню WhatsApp ліворуч на екрані натисніть пункт меню API Setup. Нарешті перейдіть до розділу з позначкою Step 3: Configure webhooks to receive messages і натисніть Configure webhooks.

Порада

Ще один спосіб налаштувати Webhooks - це перейти до https://developers.facebook.com/apps і вибрати додаток, у якому налаштовано Odoo. Потім виберіть Webhooks у меню ліворуч.

Ручний перехід до конфігурації веб-хуків Whatsapp.

На сторінці Налаштування Webhook клацніть Редагувати, куди буде додано значення URL зворотного виклику та Маркер перевірки веб-хука з Odoo.

Примітка

Обидва значення URL зворотного виклику і Маркер перевірки веб-хука були автоматично заповнені після натискання Тестувати з’єднання на попередньому кроці.

В окремому вікні браузера отримайте необхідні значення в Odoo, перейшовши до WhatsApp ‣ Налаштування ‣ WhatsApp Business Accounts та виберіть обліковий запис, який налаштовується. Знайдіть значення під розділом Отримання повідомлень.

Скопіюйте та вставте URL зворотного виклику з Odoo у поле Callback URL в Meta. Так само скопіюйте та вставте Маркер перевірки веб-хука у поле Verify Token на консолі Meta-розробника.

Нарешті, клацніть Verify and save, щоб записати значення на консолі розробника Meta.

Поля веб-хука

Тепер введіть окремі поля вебхуку в консоль розробника Meta в розділі Webhook fields. Натисніть Manage, і коли з’явиться спливаюче вікно, поставте прапорці в стовпці Subscribe для таких назв полів:

  • account_update

  • message_template_quality_update

  • message_template_status_update

  • messages

  • template_category_update

After making the selections, click Done.

Готова конфігурація Webhooks відображатиметься так у консолі розробника Meta:

Веб-хуки WhatsApp, налаштовані на консолі розробника Meta.

Важливо

Webhook fields з’являться лише після підтвердження підписки за допомогою Callback URL і Webhook Verify Token.

Додайте номер телефону

Щоб налаштувати номер телефону для використання WhatsApp в Odoo, поверніться до консолі розробника Meta (<https://developers.facebook.com/apps>`_) і знову виберіть програму, у якій налаштовується Odoo. Під заголовком меню WhatsApp ліворуч на екрані натисніть пункт меню API Setup. Звідти перейдіть до розділу з позначкою: Step 5: Add a phone number та натисніть Add phone number.

У полях введіть Business name, а також Business website or profile page.

Порада

Поле Business website or profile page може бути URL сторінки в соціальних мережах.

Завершіть заповнення інформації про компанію, вибравши країну, у якій компанія веде бізнес, зі спадного меню в розділі Country. За бажанням додайте адресу, однак ця інформація необов’язкова. Після додавання розташування натисніть Next, щоб продовжити.

Наступна сторінка містить інформацію про WhatsApp Business profile. Заповніть наступні розділи відповідно:

  • Відображуване ім’я профілю компанії в WhatsApp

  • Часовий пояс

  • Категорія

  • Опис підприємства (необов’язково)

Заповнивши ці розділи, натисніть Next. Сторінка оновиться, а потім запропонує адміністратору Add a phone number for WhatsApp у відповідному полі. Тут введіть номер телефону для налаштування в WhatsApp.

Далі виберіть спосіб підтвердження номера телефону. Виберіть Text message або Phone call, а потім натисніть Далі для продовження.

Залежно від вибраного методу перевірки на введений номер телефону WhatsApp надійде текстове повідомлення або телефонний дзвінок із кодом. Введіть цей код підтвердження в поле Verification code і натисніть Next, щоб завершити.

Попередження

Якщо спосіб оплати не було додано, це необхідно для продовження. Відвідайте документацію Meta про те, як додати спосіб оплати в Meta’s Business Manager. Це частина системи виявлення шахрайства Meta, щоб переконатися, що обліковий запис/компанія справжні, потрібен спосіб оплати, щоб продовжити.

Дивись також

Meta for Developers: Add a Phone Number.

Постійний токен

Після завершення налаштування та тестування слід створити постійний маркер, який замінить Тимчасовий токен.

Почніть із переходу до https://business.facebook.com/, а потім перейдіть до Business settings ‣ User ‣ System Users. Виберіть існуючого користувача системи або створіть нового користувача системи, натиснувши Add.

Активи тепер потрібно додати до користувача системи, а потім можна буде створити постійний токен.

Натисніть Add assets, а коли з’явиться спливаюче вікно, виберіть Apps у Select asset type. Потім виберіть додаток Odoo та перемкніть дозволи на On під опцією Full control. Встановіть цей новий параметр дозволу, натиснувши Save Changes, після чого з’явиться вікно підтвердження, що підтверджує додавання ресурсу до користувача системи. Завершіть, натиснувши Done.

Далі буде згенеровано постійний маркер. Натисніть Generate new token, і з’явиться спливаюче вікно із запитанням, для якого додатку цей токен потрібно створити. Виберіть App, для якої призначений цей токен. Потім визначте термін дії 60 days або Never.

Нарешті, коли Meta запитає, які дозволи має надати користувач системи, додайте всі наступні дозволи:

  • WhatsApp_business_messaging

  • WhatsApp_business_management

Коли дозволи встановлено, натисніть Generate token. Скопіюйте значення токена, яке заповнюється на наступному екрані.

З цим значенням маркера оновіть поле Access Token в бізнес-акаунті WhatsApp в Odoo, перейшовши до WhatsApp ‣ Конфігурація ‣ WhatsApp Business Accounts.

Запустіть трансляцію з додатком Meta

Нарешті, щоб запустити додаток, Meta-додаток має бути встановлена на Live на консолі розробника Meta. Перейдіть до https://developers.facebook.com/apps і клацніть додаток, який налаштовується. У верхньому меню перемкніть поле App Mode з Development на Live.

Важливо

Якщо для статусу додатку не встановлено значення live, база даних зможе зв’язуватися лише з номерами тестів, указаними на консолі розробника.

Попередження

URL-адресу політики конфіденційності потрібно встановити, щоб додаток був активний. Перейдіть до консолі розробника Meta https://developers.facebook.com/apps і виберіть додаток, у якому налаштовано Odoo. Потім за допомогою меню в лівій частині екрана перейдіть до App Settings ‣ Basic. Потім введіть адресу гіперпосилання на політику конфіденційності в поле Privacy Policy URL форми. Натисніть Save changes, щоб застосувати політику конфіденційності до додатку.

Після запуску додатка на консолі розробника Meta адміністратору надсилається електронний лист із підтвердженням.

Шаблони WhatsApp

Шаблони WhatsApp - це збережені повідомлення, які багаторазово використовуються для надсилання повідомлень із бази даних. Вони дозволяють користувачам надсилати якісні повідомлення без необхідності багаторазово писати той самий текст.

Creating different templates that are tailored to specific situations lets users choose the right message for the right audience. This increases the quality of the message and the overall engagement rate with the customer.

Шаблони WhatsApp можна створювати як на консолях Odoo, так і на Meta. У наведеному нижче процесі буде описано процес створення шаблонів в Odoo, а потім у Meta.

Важливо

У WhatsApp є процес затвердження, який потрібно завершити, перш ніж можна буде використовувати шаблон. Meta template approval.

Створення шаблонів в Odoo

Щоб отримати доступ до шаблонів WhatsApp і створити їх, почніть із переходу до панелі інструментів WhatsApp app ‣ Templates.

Унизу форми окремого шаблону є три вкладки: Body, Buttons та Variables; ці три вкладки разом створюють шаблон WhatsApp.

Текст вводиться у вкладку Body, а динамічний вміст, який викликається у вкладці Body, вказується у вкладці Variables. Кожна частина динамічного вмісту (наприклад, заповнювачі) у повідомленні (тілі) спеціально викликається та вказується на вкладці Variables.

Шаблони - це готові макети, які дозволяють користувачам надсилати клієнтам повідомлення професійного вигляду. Ці шаблони можуть містити динамічні дані, які заповнюються в кінцевому повідомленні за допомогою змінних, установлених у конфігурації шаблону. Наприклад, повідомлення можуть містити ім’я кінцевого користувача, називати конкретні продукти або посилатися на замовлення на продаж, щоб назвати кілька зручних і впливових змінних.

Щоб створити шаблон WhatsApp, перейдіть на панель WhatsApp ‣ Шаблони та натисніть Новий. У формі введіть Назва для шаблону та виберіть Мова.

Важливо

Щоб виконати наступне завдання, потрібні права доступу адміністратора для редагування поля Застосовується до. Перегляньте цю документацію щодо прав доступу для отримання додаткової інформації.

У спадному меню Account виберіть WhatsApp business account в Odoo, до якого має бути пов’язаний цей шаблон. Далі в полі Applies to виберіть модель, до якої дія сервера буде застосована для цього шаблону.

Порада

До цих моделей також можна отримати доступ у режим розробника. У контактній формі (або подібній відповідній формі в Odoo) перейдіть до моделі, на яку буде посилатися, і наведіть курсор на назву будь-якого поля. Відкриється вікно з інформацією про бекенд із конкретною назвою Odoo Модель у бекенді. Знайдіть цю модель (за назвою інтерфейсу) у спадному меню Застосовується до у шаблоні WhatsApp.

Попередження

Часто під час зміни моделі або поля Застосовується до, Поле телефону може викликати помилку. Поле телефону завжди має бути встановлено на модель Телефон або Мобільний.

Щоб шукати доступні поля, введіть ім’я інтерфейсу в поле Пошук…. Буде знайдено результат з усіх доступних полів для моделі (Застосовується до), для якої створено шаблон.

Примітка

Щоб знайти певні поля, може знадобитися навігація кількома рівнями у полі результатів пошуку. Використовуйте значки > (правий шеврон) і ⬅️ (стрілка вліво) для навігації між рівнями меню.

Пошук поля телефону в рядку пошуку.

Змініть Категорія, щоб вона відповідала категорії Маркетинг, Утиліти або Автентифікація. У більшості випадків використовуватимуться перші два варіанти, якщо користувач не бажає надіслати скидання пароля чи щось, пов’язане з безпекою. Встановіть значення Маркетинг, якщо надсилається щось рекламне, і встановіть значення Утиліта, якщо надсилаються загальні транзакційні повідомлення (наприклад, замовлення на продаж, квиток на подію тощо).

Важливо

Вказівка неправильної категорії може спричинити статус прапора/відхилення від Meta під час процесу затвердження.

Додайте будь-яких Користувачі, яким дозволено використовувати цей шаблон. У правій колонці Тип заголовка можна налаштувати разом із Повідомлення заголовка.

Доступні Типи заголовків такі:

  • Текст

  • Зображення

  • Відео

  • Документ

  • Розташування (потрібно встановити змінні)

Перейдіть до вкладки Body, щоб налаштувати основне повідомлення шаблону.

Коли всі необхідні зміни буде внесено до шаблону, натисніть кнопку Submit for approval у верхньому лівому куті. Це спричинить зміну статусу шаблону на Pending.

Статус залишатиметься Pending, доки Meta не прийме рішення, після чого буде надіслано електронний лист із підтвердженням про те, що шаблон схвалено (або відхилено). Після цього шаблони потрібно буде синхронізувати з базою даних Odoo.

Перегляньте цей розділ, щоб дізнатися більше про синхронізовані шаблони.

Порада

В Odoo доступні попередньо налаштовані шаблони демонстраційних даних, які можна використовувати або змінювати. Ці шаблони можна використовувати як є або змінювати відповідно до потреб конкретного бізнесу.

Щоб використовувати ці шаблони, перейдіть до WhatsApp ‣ Шаблони і виберіть попередньо налаштований шаблон. Натисніть Надіслати на затвердження, щоб розпочати процес затвердження. Після схвалення шаблону адміністратору Meta-облікового запису буде надіслано електронний лист.

Кнопки

Кнопки можна додати до повідомлення з вкладки Кнопки. Введіть Тип (або Відвідати веб-сайт, Номер виклику або Швидка відповідь), а потім укажіть Текст кнопки, Номер виклику або URL-адресу веб-сайту (включаючи Тип URL-адреси), залежно від Типу кнопки.

Примітка

Кнопки також можна додати на бізнес-консоль Meta. Перегляньте інформаційну панель шаблону WhatsApp Meta, перейшовши за адресою https://business.facebook.com/wa/manage/home. Потім перейдіть до Інструменти облікового запису ‣ Шаблони повідомлень.

Використання заповнювачів і змінних

Динамічні змінні посилаються на певні поля в базі даних Odoo, щоб створити унікальні дані в повідомленні WhatsApp під час використання шаблону. Динамічні змінні кодуються для відображення полів із бази даних, посилаючись на поля з моделі.

Example

Багато компаній люблять налаштовувати свої повідомлення WhatsApp персоналізованою інформацією про клієнта, щоб привернути увагу. Це можна зробити в Odoo, посилаючись на поле в моделі, встановивши динамічну змінну. Наприклад, ім’я клієнта можна вказати в електронному листі з поля Клієнт у моделі Замовлення на продаж.

Повідомлення WhatsApp із виділеними динамічними змінними.

Динамічні змінні можна додати до Body, додавши заповнювачі у текст. Щоб додати заповнювач у основі повідомлення, введіть такий текст {{1}}. Для другого заповнювача введіть {{2}} і поступово збільшуйте його, коли до тексту додається більше заповнювачів.

Example

Нижче наведено текст із основного шаблону квитанції про оплату:

Шановний {{1}},

Ось ваш рахунок {{2}} від {{3}} на загальну суму {{4}}{{5}}.
Щоб переглянути свій рахунок-фактуру або оплатити онлайн: {{6}}

Дякуємо

Дивись також

Шаблони WhatsApp.

Ці заповнювачі мають бути налаштовані на вкладці Змінні шаблону перед поданням на затвердження в Meta. Щоб редагувати динамічні змінні в шаблоні, спочатку змініть Тип на Поле моделі. Це дозволяє Odoo посилатися на поле в моделі, щоб створити унікальні дані в повідомленні, що надсилається.

Далі відредагуйте Field динамічних змінних. Поле Applies to в шаблоні має бути відредаговано перед тим, як переконатися, що вказано правильну модель і поле.

Щоб здійснити пошук у доступних полях, введіть зовнішню назву поля у вікні пошуку. Буде знайдено результат з усіх доступних полів для моделі (Applies to), для якої створено шаблон. Може бути кілька рівнів, які потрібно налаштувати.

Example

Нижче наведено приклад змінних, установлених для заповнювачів вище в квитанції про оплату, зазначеної вище:

Ім’я

Зразок значення

Тип

Поле

body - {{1}}

Azure Interior

Поле моделі

Партнер

body - {{2}}

INV/2022/00001

Поле моделі

Номер

body - {{3}}

Моя компанія

Поле моделі

Компанія

body - {{4}}

$

Поле моделі

Валюта > Символ

body - {{5}}

4000

Поле моделі

Сума

body - {{6}}

https://..

Посилання на портал

Example

Наприклад, у вкладці Body, якщо введено наступне: «Hello {{1}},», то {{1}} має бути встановлено у вкладці Variables. Для цього конкретного випадку повідомлення має вітати клієнта за ім’ям, тому {{1}} має бути налаштовано на заповнення {{1}} Field ім’ям Клієнта.

Попередження

Налаштування шаблонів WhatsApp не входить до сфери підтримки Odoo.

Meta template approval

Після оновлення динамічних змінних у шаблоні його потрібно знову надіслати в Meta для затвердження. Натисніть Submit for Approval, щоб розпочати процес затвердження. Після схвалення шаблону адміністратору мета-облікового запису буде надіслано електронний лист.

Після схвалення від Meta знову синхронізуйте шаблони в базі даних Odoo. Перегляньте цю документацію: Синхронізація шаблонів.

Порада

Щоб переглянути статус інформаційної панелі шаблону WhatsApp Meta, перейдіть до https://business.facebook.com/wa/manage/home. Потім перейдіть до Account tools ‣ Message templates.

Синхронізація шаблонів

Шаблони мають бути синхронізовані в базі даних Odoo після їх схвалення командою Meta. Для цього перейдіть до WhatsApp app ‣ Configuration ‣ WhatsApp Business Accounts і виберіть конфігурацію, яку потрібно синхронізувати. Унизу в розділі Sending messages натисніть Sync Templates. Meta оновить схвалені шаблони, щоб їх можна було використовувати з різними програмами в базі даних.

Синхронізація шаблонів Meta WhatsApp із базою даних Odoo з виділенням 'Sync Templates'.

У верхньому правому куті з’явиться зелене повідомлення про успішне виконання з кількістю оновлених шаблонів.

Порада

Шаблони також можна синхронізувати окремо з самого шаблону. Перейдіть до панелі інструментів WhatsApp app ‣ Templates і виберіть шаблон для синхронізації. Потім натисніть кнопку Sync Template, розташовану у верхньому меню форми шаблону.

Створення шаблонів в Meta

Спочатку перейдіть до Meta’s WhatsApp template dashboard, а потім перейдіть до :menuselection: Account tools --> Message templates.

Інструменти облікового запису виділено в бізнес-менеджері з виділеним посиланням для керування шаблонами.

Щоб створити шаблон WhatsApp, натисніть синю кнопку Create template, а потім виберіть Category. Серед перелічених параметрів: Marketing, Utility та Authentication. У більшості випадків використовуватимуться перші два варіанти, якщо користувач не бажає надіслати скидання пароля чи щось, пов’язане з безпекою.

Введіть Name шаблону, а потім виберіть Language для шаблону.

Примітка

Можна вибрати кілька мов, ввівши назви мов і вибравши інші мови за потреби.

Перераховано параметри конфігурації шаблону з виділенням маркетингу, утиліти, назви та мови.

Зробивши відповідний вибір, натисніть Continue у верхньому правому куті. Сторінка перенаправляє на сторінку Edit template. Тут налаштовуються Header, Body, Footer і Buttons. Праворуч від шаблону є попередній перегляд того, як шаблон виглядатиме у виробництві.

Відредагуйте шаблон за допомогою верхнього, основного, нижнього колонтитулів і кнопок.

Коли всі необхідні зміни буде внесено до шаблону, натисніть кнопку Submit у верхньому правому куті. З’являється вікно підтвердження для підтвердження мови — клацніть Confirm, щоб підтвердити, а потім з’явиться інше вікно, у якому повідомляється, що шаблон буде надіслано в Meta для перевірки та затвердження.

Status шаблону залишатиметься в In review, доки Meta не прийме рішення. Щойно буде отримано електронний лист із підтвердженням затвердження шаблону, шаблони потрібно буде синхронізувати з бази даних Odoo.

Дивись також

Щоб отримати додаткові відомості про налаштування шаблонів на консолі розробника Meta, відвідайте Meta’s WhatsApp template documentation.

Сповіщення

Сповіщення в WhatsApp обробляються подібно до розмови в Odoo. З’являється спливаюче вікно з отриманою розмовою від клієнта. За замовчуванням сповіщення встановлюються в конфігурації бізнес-облікового запису WhatsApp в Odoo.

Параметри сповіщень можна налаштувати, перейшовши до WhatsApp app ‣ Configuration ‣ WhatsApp Business Accounts. Звідти виберіть обліковий запис і прокрутіть вниз до розділу Control, де обробляються сповіщення. Під заголовком Notify users введіть у полі, якого користувача (користувачів) слід повідомити для цього конкретного каналу WhatsApp.

Примітка

Після початку розмови між користувачем і клієнтом сповіщення для всіх користувачів, указаних у конфігурації бізнес-облікового запису WhatsApp, не надходитимуть. Відображатимуться лише сповіщення користувачам(ам) у розмові. Якщо користувач не відповість протягом 15 днів, відповідь клієнта через 15 днів буде знову заповнена для всіх користувачів, указаних у конфігурації WhatsApp.

Додавання користувачів до чату

Користувачів можна додати до чату WhatsApp, розгорнувши спливаюче вікно WhatsApp. Розмови WhatsApp знаходяться в додатку Обговорення. Натисніть піктограму 👤+ (додати користувача) поруч, і з’явиться вікно для запрошення користувачів до розмови.

Додавання користувачів до бесіди WhatsApp із виділеним значком додавання користувача.

WhatsApp API FAQ

Перевірка

Станом на 1 лютого 2023 року, якщо програмі Meta потрібен розширений доступ до дозволів, може знадобитися завершити повну перевірку бізнесу. Це включає в себе подання офісних ділових документів до Meta. Перегляньте цю документацію.

Помилки шаблону

Редагування шаблонів може спричинити повторне відстеження та помилки, якщо не буде дотримано точного процесу, описаного вище, тут: (Шаблони WhatsApp).

Подвійна помилка перевірки

Під час синхронізації шаблонів може бути випадок, коли в бізнес-менеджері Meta та в Odoo є кілька шаблонів з однаковою назвою. Це спричиняє подвійну помилку перевірки. Щоб виправити цю проблему, перейменуйте дубльоване ім’я шаблону на Odoo та синхронізуйте шаблони ще раз, дотримуючись наведених тут кроків: Синхронізація шаблонів.

Помилка користувача заповнюється в Odoo, коли існує повторюваний шаблон.

Помилки токену

Помилка користувача

Якщо тимчасовий токен не буде замінено на постійний, під час тестування з’єднання після невдалого надсилання в Odoo з’явиться помилка користувача. Щоб усунути цю проблему, перегляньте Постійний токен.

Помилка користувача заповнюється в Odoo, коли термін дії токена закінчується.

Системна помилка користувача 100

Якщо користувач системи є Співробітник під час налаштування постійного токена, буде заповнено помилку користувача 100.

Щоб виправити цю помилку, створіть системного користувача Адміністратор, дотримуючись процесу, описаного тут: Постійний токен.

Помилка користувача заповнюється в Odoo, коли генерується маркер співробітника замість користувача адміністратора.