왓츠앱

WhatsApp 은 사용자가 메시지를 보내고, 전화를 걸고, 콘텐츠를 공유할 수 있는 인스턴트 메시징 및 VoIP (Voice-over-IP) 앱입니다. 기업에서는 WhatsApp 비즈니스 를 사용하여 고객과 문자로 소통하고 문서를 보내거나 고객 지원 서비스를 할 수 있습니다.

경고

WhatsApp is an Odoo Enterprise-only application that does not work in Odoo Community edition. To sign up for Odoo Enterprise edition, click here: Odoo Free Trial.

더 보기

For more information on migrating from Odoo Community version to Odoo Enterprise version see this documentation: 커뮤니티에서 엔터프라이즈로 전환하기.

With the Odoo WhatsApp app, a company can connect a WhatsApp Business Account (WABA) to an Odoo database, which allows for the following:

  • Receive and reply to WhatsApp messages directly from an Odoo database

  • Create new templates with dynamic placeholders/variables

  • Send pre-approved templates that use dynamic variables, such as:

    • Quotations from the Sales app

    • Receipts and invoices from the Point of Sale app

    • Tickets from the Events app

WhatsApp은 Facebook의 모회사인 Meta에서 운영하는 메시지 서비스입니다. 일반적으로 많은 국가 및 기업에서 WhatsApp을 커뮤니케이션 도구로 사용하고 있습니다. 이 문서에서는 WhatsApp 비즈니스 계정과 Odoo를 통합시키는 내용을 검토합니다. 회사의 Meta 계정은 API 연결을 통해 Odoo에서 설정됩니다.

WhatsApp 커넥터에서는 회사 개시 및 고객 개시라는 두 가지 흐름을 지원합니다. 한 명 이상 서식을 전송하면 회사에서 대화를 시작할 수 있습니다. 서식 전송이 완료되면, 수신자가 답변하면 발신자와 수신자 간 대화가 연계 작동되도록 할 수 있습니다 (고객이 15일 이내에 응답하면 *메일 및 채팅*의 채팅 창이 팝업으로 표시됩니다).

클라이언트가 대화를 시작한 경우 (예: 회사의 공개 WhatsApp 번호로 전송) Odoo는 이 WhatsApp 채널을 담당하는 전체 운영자와 그룹 채팅을 엽니다.

It is recommended to set up multiple WhatsApp accounts for different departments. For example, the help desk team and sales teams can chat on different channels.

Meta에서 WhatsApp 설정하기

A WhatsApp integration with Odoo uses a standard API connection, and is configured on Meta in the following steps:

  1. Meta 비즈니스 계정 만들기

  2. Meta 개발자 계정 만들기

  3. Setup an app and WhatsApp product on Meta’s developer console

  4. API 연결을 테스트합니다.

Once connected, messages are then sent and received through Odoo’s Discuss application using the WhatsApp API.

Meta business account setup

Meta (Facebook 소유) 비즈니스 계정을 만드는 방법은 다음과 같습니다: `Facebook 비즈니스 관리자 <https://business.facebook.com/overview>`_로 이동합니다. :guilabel:`계정 생성`을 클릭한 다음 비즈니스 이름, 관리자 이름, 업무용 이메일 주소를 입력합니다. 그런 다음 :guilabel:`다음`을 클릭하면 이메일 주소를 확인하라는 팝업창이 나타납니다. 확인 후 :guilabel:`완료`를 클릭하여 창을 닫습니다.

그런 다음, Facebook에서 발송된 이메일 안내에 따라서 비즈니스 계정이 만들어진 것을 확인하고 설정 프로세스를 완료하세요.

중요

비즈니스 계정이 Facebook 개인 계정에 연결되어 있는 경우에는 관리자가 나머지 설정을 하기 위해서 반드시 개인 계정과 비즈니스 계정 간 전환을 해야 합니다.

비즈니스 계정으로 전환하려면 Facebook 개발자 콘솔 로 이동하여 오른쪽 상단에 있는 *계정 이름*을 클릭하세요. 비즈니스 계정 제목 아래에, WhatsApp 설정을 할 비즈니스를 클릭합니다. 이 계정은 Odoo에서 WhatsApp 메시지를 송수신하는 계정으로 쓰이게 됩니다.

Meta 개인 계정과 비즈니스 계정 간에 전환합니다.

중요

Meta 비즈니스 계정을 만들려면 사용자가 Facebook 비즈니스 계정을 설정하기 최소 1시간 전에 개인 Facebook 계정을 이미 가지고 있어야 합니다. 해당 시간 이전에 비즈니스 계정을 생성하려는 경우에는 오류가 발생합니다.

앱 생성하기

개발자용 Meta 현황판에서 Meta 개발자 계정으로 로그인합니다. 아직 계정 설정이 되어 있지 않은 경우에는 Facebook 계정을 연결하여 Meta 개발자 계정을 생성하세요.

참고

Facebook 개발자 계정은 Facebook 비즈니스 계정과 다릅니다. 개발자 계정은 Facebook 개인 계정으로 설정되지만, 비즈니스 계정은 그렇지 않으며 비즈니스를 대표하고 앱과 같은 모든 비즈니스 자산을 메타에서 관리합니다.

Meta 개발자 계정으로 로그인한 후에 오른쪽 상단의 ‘나의 앱’을 클릭합니다. 그러면 개발자가 해당 특정 개발자 계정에서 설정해놓은 앱 전체로 관리자가 리디렉션됩니다. :guilabel:`앱 만들기`를 클릭하면 새로운 Meta 애플리케이션을 설정하는 프로세스를 시작합니다.

앱 종류

앱 만들기 페이지에서 기타`라고 표시된 섹션에서 :guilabel:`다른 것을 찾고 있으신가요?”를 선택한 다음 :guilabel:`다음`을 클릭하여 앱 유형을 선택할 수 있는 다른 페이지로 이동합니다. 그런 다음 :guilabel:`앱 유형 선택 레이블 아래에 있는 첫 번째 옵션인 :guilabel:`비즈니스`를 클릭합니다. 이 선택을 통해 WhatsApp :abbr:`API (애플리케이션 프로그래밍 인터페이스)`를 생성 및 관리할 수 있습니다.

Now, click Next to configure the app, as desired. When the app type has been configured, the administrator will move onto the app details section.

App details

On the Details section of the Create an app process, enter Odoo in the field under the Add an app name label.

참고

The app name can be changed at a later time in the settings, if necessary.

경고

상표 및 브랜드 요소는 이 텍스트 섹션에서는 사용할 수 없습니다. 사용할 수 없는 회사로는 Meta 그룹이 포함됩니다. ‘WhatsApp’ 이라는 단어가 포함되지 않도록 합니다. 포함될 경우 시스템에서 오류로 표시됩니다.

Next, enter the developer email address in the field under the App contact email label.

마지막으로 드롭다운 메뉴를 사용하여 비즈니스 계정 - 선택 항목 필드를 메타 비즈니스 계정 프로필로 설정합니다. 완료하려면 앱 만들기 를 클릭합니다. 이렇게 하면 앱이 생성되고 메타 플랫폼 약관개발자 정책 동의 문서가 표시됩니다.

약관에 동의하려면 보안을 위해 Facebook 비밀번호를 입력하고 제출 을 클릭하여 앱 생성을 완료합니다. 그러면 브라우저가 개발자용 Meta 현황판으로 이동합니다.

참고

If the Meta business account is prohibited from advertising, claiming an app won’t be allowed. To resolve this issue navigate to https://business.facebook.com/business for assistance.

For more information, see Meta’s documentation on advertising restrictions.

Add a WhatsApp product to the app

이제 앱의 기본 구조가 생성되었으므로 앱에 품목을 추가해야 합니다. 먼저 https://developers.facebook.com/apps 로 이동하여 Meta 앱 현황판에 액세스하고 설정 중인 앱을 클릭하는 것부터 시작합니다.

On the next page: since WhatsApp will be used, click Set up next to the box containing WhatsApp, located towards the bottom of the page.

그런 다음 페이지가 WhatsApp 비즈니스 플랫폼 API 에 대한 환경 설정 페이지로 이동합니다. 드롭다운 메뉴를 사용하여 Meta 비즈니스 계정 선택 옵션에서 설정할 Meta 비즈니스를 선택한 다음 계속 을 클릭하여 선택한 내용을 확인합니다.

참고

When Continue is clicked, the administrator agrees to Meta’s terms and conditions as linked on the Meta App Dashboard.

참고

Once the WhatsApp product is added to the app, Meta will provide a WhatsApp test phone number with 5 test messages.

Start using the WhatsApp API

이전 WhatsApp 제품 마법사를 마치고 계속 을 클릭하면 브라우저에서 WhatsApp 빠른 시작 페이지로 이동해야 합니다. 빠른 시작 페이지에서는 전화번호를 추가한 다음 초기 테스트 메시지를 전송하여 WhatsApp API 환경 설정을 시작할 수 있습니다.

Navigating to the WhatsApp quickstart wizard in Meta for Developer dashboard.

참고

브라우저가 WhatsApp 빠른 시작 페이지에 없을 경우에는 https://developers.facebook.com/apps 로 이동하여 설정 중인 앱을 클릭합니다 (위의 내용대로 진행했을 경우 앱 이름 ‘Odoo’ 로 되어 있습니다).

그런 다음 페이지 왼쪽 메뉴에서 WhatsApp 섹션 제목 옆에 있는 v (메뉴 토글) 아이콘을 클릭합니다. 다음과 같은 항목이 표시된 작은 메뉴가 열립니다.

  • Quickstart

  • API Setup

  • 환경 설정

Click the Quickstart option, and then click Start using the API.

API Setup

API 사용 시작`을 클릭하면, :guilabel:`API 설정`으로 페이지를 이동합니다. 이제 테스트 번호가 생성되었으므로, 테스트 메시지를 보내어 WhatsApp이 제대로 작동하는지 확인할 수 있습니다. 시작하려면, 페이지에서 :guilabel:`메시지 보내기 및 받기``라고 표시된 섹션으로 이동하여 :guilabel:`1단계 전화번호 선택 아래에 있는 받는 사람 옆의 드롭다운 메뉴를 클릭합니다.

이제 유일한 사용 옵션인 :guilabel:`전화번호 목록 관리`를 선택합니다. 단계에 따라서 무료 테스트 메시지를 보낼 번호를 최대 5개까지 추가하세요. 해당 국가 코드와 전화번호를 입력한 후 :guilabel:`다음`을 클릭합니다.

중요

이 단계에서 보낼 전화번호를 추가하면 단말기에서 테스트 메시지를 성공적으로 보낼 수 있게 됩니다. WhatsApp :abbr:`API (Application Programming Interface)`의 작동 여부를 확인하기 위해 매우 중요합니다.

WhatsApp 비즈니스에서 인증 코드가 전화번호로 전송되며, 다음 화면에서 해당 인증 코드를 입력하여 해당 번호의 소유자임을 확인해야 합니다. 인증 코드를 입력한 후 번호를 승인하려면 :guilabel:`다음`을 클릭하세요.

단말기를 통해 테스트 메시지 보내기

다음으로, 단말기를 통해 테스트 메시지를 전송합니다. 2단계 API를 사용하여 메시지 보내기 아래에 있는 :guilabel:`메시지 보내기`를 클릭하세요. 그러면 이전 섹션에서 설정한 전화번호로 테스트 메시지가 전송됩니다.

메시지가 해당 번호로 성공적으로 수신되면 다음 섹션으로 이동하여 웹훅을 생성 및 설정합니다.

Odoo에서 WhatsApp 설정하기

이 섹션에서 설정되어 있는 다음의 단계는 모두 Odoo 데이터베이스 안에 있습니다. 몇 가지 다른 토큰, 전화번호 및 계정 ID 값을 모두 Odoo에서 설정해야 하는데, 이러한 값은 콜백 URL 및 :guilabel:`웹훅 확인 토큰`을 생성하는 데 필요하며, 이 값은 웹훅을 설정하기 위해 사용합니다 (데이터베이스로 메시지를 재수신하기 위함).

In Odoo, navigate to WhatsApp app ‣ Configuration ‣ WhatsApp Business Accounts. Then click New to configure the WhatsApp business account in Odoo.

다른 브라우저 탭에서 https://developers.facebook.com ‣ 내 앱 ‣ WhatsApp ‣ API 환경 설정 으로 이동한 후 Meta 개발자 콘솔에서 다음 값을 해당하는 Odoo의 필드에 복사합니다.

이름

Meta Console

Odoo Interface

전화번호

Phone number ID

Phone Number ID

토큰

Temporary access token

Access Token

앱 ID

App ID

App ID

계정 ID

WhatsApp Business Account ID

Account ID

:guilabel:`앱 비밀번호`를 확인하려면 Meta 개발자 콘솔인 `<https://developers.facebook.com/apps>`_로 이동하여 Odoo에서 설정한 앱을 선택하세요. 그런 다음 왼편에 있는 메뉴의 :guilabel:`앱 설정`에서 :guilabel:`기본`을 선택합니다.

그 다음, 앱 비밀번호 옆에 있는 보이기`를 클릭하고 계정 비밀번호를 입력하여 소유자임을 확인하세요. :guilabel:`앱 비밀번호`를 복사한 다음, 복사한 값을 Odoo :guilabel:`WhatsApp 비즈니스 계정 설정 현황판의 앱 비밀번호 필드에 붙여넣습니다.

Odoo에서 WhatsApp 비즈니스 계정 설정을 완료하려면 :guilabel:`테스트 연결`을 클릭하세요. 설정 내용이 올바르게 되어 있는 경우에는, 현황판의 오른쪽 상단에 초록색 성공 메시지가 나타납니다.

웹훅 설정하기

Odoo에서 WhatsApp의 웹훅을 설정하려면 <https://developers.facebook.com/apps>`_로 이동하여 Odoo에서 설정 중인 앱을 선택합니다. 다음으로 화면 왼쪽에 있는 :guilabel:`WhatsApp 메뉴 제목 아래에서 API 설정 메뉴 항목을 클릭합니다. 마지막으로 :guilabel:`3단계: 메시지 수신을 위한 웹훅 설정`이라고 표시된 섹션으로 이동하여 :guilabel:`웹훅 설정`을 클릭하세요.

다른 웹훅 설정 방법으로는, `<https://developers.facebook.com/apps>`_로 이동하여 Odoo가 설정 중인 앱을 선택하는 것입니다. 그런 다음 왼쪽 메뉴에서 :guilabel:`웹훅`를 선택합니다.

직접 Whatsapp 웹훅 설정으로 이동합니다.

웹훅 설정 페이지에서 수정`을 클릭합니다. 여기서 Odoo의 :guilabel:`콜백 URL웹훅 확인 토큰 값이 모두 추가되어 있습니다.

참고

이전 단계에서 테스트 연결`을 클릭하여 :guilabel:`콜백 URL웹훅 확인 토큰 값이 자동으로 채워져 있습니다.

별도의 브라우저 창에서 WhatsApp 앱 ‣ 환경 설정 ‣ WhatsApp 비즈니스 계정`으로 이동하여 Odoo에서 필요한 값을 검색하고 설정 중인 계정을 선택합니다. :guilabel:`메시지 수신 섹션 아래에 있는 값을 확인하세요.

Odoo의 콜백 URL`을 복사하여 Meta의 :guilabel:`콜백 URL 필드로 붙여넣습니다. 마찬가지로, 웹훅 검증 토큰`을 복사하여 Meta 개발자 콘솔의 :guilabel:`토큰 확인 필드에 붙여넣으세요.

마지막으로, :guilabel:`확인 및 저장`을 클릭하여 Meta 개발자 콘솔에 값을 기록합니다.

웹훅 필드

이제 Meta 개발자 콘솔의 웹훅 필드 섹션 아래에 있는 각각의 웹훅 필드를 입력하세요. 관리e`를 클릭하여 팝업 창이 나타나면 다음 *필드 이름*에 대한 :guilabel:`구독 열의 상자를 선택하세요.

  • account_update

  • message_template_quality_update

  • message_template_status_update

  • messages

  • template_category_update

After making the selections, click Done.

The finished Webhooks configuration will appear like this in the Meta developer console:

WhatsApp webhooks set in the Meta developer console.

중요

The Webhook fields will only appear once the subscription is confirmed using the Callback URL and Webhook Verify Token.

Add phone number

WhatsApp에 사용할 전화번호를 Odoo에서 설정하려면 Meta 개발자 콘솔(https://developers.facebook.com/apps)로 다시 이동하여 Odoo가 설정 중인 앱을 다시 선택합니다. 화면 왼쪽의 WhatsApp 메뉴 제목 아래에 있는 API 설정 메뉴 항목을 클릭합니다. 거기에서 :guilabel:`5단계: 전화번호 추가`라고 표시된 섹션으로 이동한 후 :guilabel:`전화번호 추가`를 클릭합니다.

In the fields, enter a Business name as well as a Business website or profile page.

The Business website or profile page field can be a social media page’s URL.

국가 섹션의 드롭다운 메뉴에서 회사가 사업을 운영하는 국가를 선택하여 비즈니스 관련 정보를 입력합니다. 원하는 경우 주소를 추가할 수 있으나, 이 내용은 선택 사항입니다. 위치를 추가한 후 계속하려면 다음 을 클릭합니다.

The following page contains information for the WhatsApp Business profile. Complete the following sections, accordingly:

  • WhatsApp 비즈니스 프로필 표시 이름

  • 시간대

  • 카테고리

  • 비즈니스 설명 (선택 사항)

이 섹션이 완료되면 다음 을 클릭합니다. 페이지 새로고침을 하면 관리자에게 해당 필드에 WhatsApp에 전화번호 추가 를 하라는 메시지가 표시됩니다. 여기에 WhatsApp에서 설정할 전화번호를 입력합니다.

Next, choose a verification method for the phone number. Select either Text message or Phone call, and then click Next proceed.

입력한 전화번호로 선택한 인증 방식에 따라 WhatsApp을 통해 문자 메시지 혹은 전화로 코드를 받게 됩니다. 해당 인증 코드를 인증 코드 필드에 입력하고 다음 을 클릭하여 완료합니다.

경고

결제 방법을 추가하지 않은 경우, 이는 진행에 필수 사항입니다. Meta 비즈니스 관리자로 결제 방법을 추가하는 방법에 대한 Meta 문서를 확인해 보세요. 이는 Meta의 사기 탐지 시스템의 일부로, 계정이나 회사가 진짜인지 확인하기 위해 결제 방법이 진행을 위해 필수입니다.

영구 토큰

설정 및 테스트 완료 후 :guilabel:`임시 토큰`을 대체하기 위해 영구 토큰을 생성해야 합니다.

먼저 `<https://business.facebook.com/>`_으로 이동한 다음 :menuselection:`비즈니스 설정 –> 사용자 –> 시스템 사용자`로 이동합니다. 기존 시스템 사용자를 선택하거나 :guilabel:`추가`를 클릭하여 시스템 사용자를 신규 생성하세요.

이제 시스템 사용자에게 반드시 자산을 추가해야 영구 토큰을 생성할 수 있습니다.

자산 추가`를 클릭하여 팝업 창이 나타나면 :guilabel:`자산 유형 선택 아래에서 앱`을 선택합니다. 그런 다음, Odoo 앱을 선택하고 :guilabel:`전체 제어 옵션에서 권한을 *켜기*로 전환합니다. :guilabel:`변경 사항 저장`을 클릭하여 해당하는 새로운 권한 설정을 지정하면 시스템 사용자에게 자산 추가를 승인하는 확인 창이 나타납니다. :guilabel:`완료`를 클릭하여 종료합니다.

그 다음, 영구 토큰이 생성됩니다. 새 토큰 생성`을 클릭하면 해당 토큰을 생성할 앱을 묻는 팝업창이 나타납니다. 토큰을 사용할 :guilabel:`앱`을 선택하세요. 그런 다음 만료 날짜를 :guilabel:`60일 또는 하지 않음 중에서 선택합니다.

마지막으로, Meta에서 시스템 사용자에게 어떤 권한을 허용할지 선택할 때 다음 권한을 모두 추가합니다.

  • WhatsApp_business_messaging

  • WhatsApp_business_management

권한 설정이 완료되면, :guilabel:`토큰 생성`을 클릭합니다. 다음 화면에 표시되는 토큰 값을 복사하세요.

해당 토큰 값을 사용하여 WhatsApp 앱 ‣ 환경 설정 ‣ WhatsApp 비즈니스 계정`으로 이동하여 Odoo의 WhatsApp 비즈니스 계정에서 :guilabel:`액세스 토큰 필드를 업데이트하세요.

Meta 앱을 이용한 실시간 스트리밍

마지막으로 앱을 실행하려면 Meta 개발자 콘솔에서 Meta 앱을 실시간`으로 설정해야 합니다. `<https://developers.facebook.com/apps>`_로 이동하여 설정 중인 앱을 클릭하세요. 상단 메뉴에서 :guilabel:`앱 모드 필드를 :guilabel:`개발`에서 :guilabel:`살사건`으로 전환하세요.

중요

앱 상태가 *실시간*으로 설정되지 않은 경우에는, 데이터베이스는 개발자 콘솔에 지정된 테스트 번호에만 연락할 수 있습니다.

경고

앱을 실시간 상태로 설정하려면 개인정보 처리방침 URL을 설정해야 합니다. Meta 개발자 콘솔`<https://developers.facebook.com/apps>`_로 이동하여 Odoo에서 설정 중인 앱을 선택합니다. 그런 다음, 화면 왼쪽의 메뉴를 사용하여 앱 설정 ‣ 기본`으로 이동합니다. 그런 다음 양식의 :guilabel:`개인정보 c처리방침 URL 필드 아래에 개인정보 처리방침 하이퍼링크 주소를 입력합니다. :guilabel:`변경 사항 저장`을 클릭하여 개인정보 처리방침을 앱에 적용합니다.

앱이 Meta 개발자 콘솔로 발행되면 관리자에게 확인 이메일이 전송됩니다.

WhatsApp 서식

WhatsApp 서식은 데이터베이스에서 메시지를 보낼 때 반복적으로 사용할 수 있습니다. 이를 통해 사용자는 동일한 텍스트를 반복해서 작성할 필요 없이 고품질의 커뮤니케이션을 할 수 있게 됩니다.

특정한 상황에 맞추어 다양한 서식을 생성해 놓으면 적절한 대상에게 보낼 적합한 메시지를 선택할 수 있습니다. 이를 통해 메시지의 품질과 고객과의 전반적인 참여율을 높일 수 있습니다.

WhatsApp 서식은 Odoo 및 Meta 콘솔에서 모두 생성할 수 있습니다. 다음 프로세스에서는 Odoo에서 서식을 생성한 다음 나중에 Meta에서 서식을 생성하는 프로세스를 전체적으로 확인합니다.

중요

WhatsApp에는 서식을 사용 전에 완료해야 하는 Meta 서식 승인.승인 프로세스가 있습니다.

Odoo에서 서식 만들기

WhatsApp 서식에 액세스하여 생성하려면 먼저 WhatsApp 앱 ‣ 서식 현황판으로 이동합니다.

서식별로 양식의 하단에는 세 개의 탭이 있습니다: 본문, 버튼, 변수; 이 세 개의 탭을 조합하여 WhatsApp 서식을 생성합니다.

본문 탭에 텍스트를 입력하고 본문 탭에서 호출되는 동적 내용은 변수 탭에서 지정됩니다. 메시지 (본문)의 모든 동적 콘텐츠 (예: 자리표시자)는 특정하게 호출되어 세부 옵션 탭에 지정됩니다.

서식이란 사용자가 고객에게 전문적인 메시지를 보낼 수 있도록 사전 제작되어 있는 레이아웃입니다. 이와 같은 서식에는 서식을 구성하기 위해 설정된 변수를 사용하여 최종적으로 메시지에 들어갈 동적 데이터가 포함될 수 있습니다. 예를 들어, 메시지에 최종 사용자의 이름이 포함되거나, 특정 제품을 언급하거나, 판매주문서를 참조하여 편리하고 영향력 있는 변수의 이름 등을 지정할 수 있습니다.

WhatsApp 서식을 생성하려면 WhatsApp 앱 ‣ 서식 현황판으로 이동하여 :guilabel:`새로 만들기`를 클릭하세요. 양식에서 서식 :guilabel:`이름`을 입력하고 :guilabel:`언어`를 선택합니다.

중요

해당하는 다음 작업을 완료하기 위해 적용 대상 필드를 편집하려면 관리자 액세스 권한이 있어야 합니다. 자세한 내용은 이 액세스 권한 문서 를 참조하세요.

계정`의 드롭다운 메뉴에서 해당 서식을 연결할 Odoo의 *WhatsApp 비즈니스 계정*을 선택하세요. 다음으로, :guilabel:`적용 대상 필드에서 서식에 서버 작업을 적용할 *모델*을 선택합니다.

이 모델은 개발자 모드 <developer-mode>`에서도 액세스할 수 있습니다. 문의 양식 (또는 Odoo에서의 유사한 관련 양식)에서 참조할 모델로 이동하여 필드 이름 위로 마우스를 가져갑니다. 백엔드 정보 상자는 백엔드의 특정 Odoo :guilabel:`모델 이름과 함께 표시됩니다. WhatsApp 서식의 적용 대상 드롭다운 메뉴에서 이 모델을 검색 (프론트엔드 이름 사용)합니다.

경고

모델 또는 적용 대상 필드를 변경할 때 전화 필드`에서 오류가 발생하는 경우가 종종 있습니다. :guilabel:`전화 필드`는 항상 `전화 또는 모바일 모델로 설정되어야 합니다.

사용할 수 있는 필드를 검색하려면 검색… 상자에 프론트엔드 이름을 입력합니다. 서식이 생성된 모델 (적용 대상)에 대해 사용 가능한 필드 전체에서 결과를 검색합니다.

참고

특정 필드를 찾아보려면, 검색 결과창에서 수준을 다양하게 하여 검색해야 할 수도 있습니다. > (오른쪽 갈매기형)⬅️(왼쪽 화살표) 아이콘을 사용하여 메뉴 레벨 사이를 이동합니다.

검색창에서 전화번호를 검색해보세요.

카테고리`를 :guilabel:`마케팅, 유틸리티 또는 인증 카테고리에 맞게 변경합니다. 대부분의 경우 사용자가 비밀번호 재설정이나 보안 관련 메시지를 보내려는 경우를 제외하고는 처음의 두 가지 옵션을 사용하게 됩니다. 홍보물을 전송하는 경우에는 :guilabel:`마케팅`으로 설정하고, 일반 거래 메시지 (예: 판매주문서, 이벤트 티켓 등)를 전송되는 경우에는 :guilabel:`유틸리티`로 설정합니다.

중요

Specifying an incorrect category can cause a flag/rejected status from Meta during the approval process.

Add any Users that are allowed to use this template. In the right-side column, a Header type can be configured along with a Header message, as well.

The available Header types are as follows:

  • 문자

  • 이미지

  • 동영상

  • 문서

  • Location (variables need to be set)

Navigate to the Body tab to configure the main message of the template.

변경해야 할 사항을 템플릿에서 모두 적용한 다음에는 왼쪽 상단에 있는 승인 요청 제출 버튼을 클릭합니다. 그러면 템플릿 상태가 보류 중 으로 변경됩니다.

Meta에서 결정될 때까지 상태는 계속 보류 중 이며, 템플릿이 승인 (또는 거부)되었음을 안내하면 확인 이메일이 전송됩니다. 그런 다음 템플릿을 Odoo 데이터베이스에서 동기화해야 합니다.

See this section for more information on syncing templates.

There are pre-configured demo data templates available in Odoo to use or modify. These templates can be used as-is or modified to suit a specific business need.

이 템플릿을 사용하려면 WhatsApp 앱 ‣ 템플릿 으로 이동하여 사전 구성되어 있는 템플릿을 선택합니다. 승인 요청 제출 을 클릭하여 승인 프로세스를 시작합니다. 템플릿이 승인되면 메타 계정 관리자에게 이메일이 전송됩니다.

버튼

버튼 탭에서 메시지에 버튼을 추가할 수 있습니다. 유형 (웹사이트 방문, 전화 통화 또는 빠른 답신)을 입력하고 버튼 텍스트, 전화번호 or 웹사이트 URL (Url 유형 포함), 을 버튼 유형 에 따라 지정합니다.

참고

Buttons can also be added on the Meta business console. See Meta’s WhatsApp template dashboard by navigating to https://business.facebook.com/wa/manage/home. Then go to Account tools ‣ Message templates.

Using placeholders and variables

동적 변수는 Odoo 데이터베이스 내에 있는 특정 필드를 참조하여, 서식을 사용할 경우 WhatsApp 메시지에 고유한 데이터를 생성합니다. 동적 변수는 모델 내의 필드를 참조하여 데이터베이스 내의 필드를 표시하도록 인코딩됩니다.

Example

관심을 끌기 위해서 많은 기업에서 맞춤형 고객 정보로 WhatsApp 메시지를 맞춤 설정하는 것을 선호합니다. 이는 Odoo에서 동적 변수를 설정하여 모델 내의 필드를 참조하여 수행될 수 있습니다. 예를 들어, 고객의 이름은 이메일에서 판매주문서 모델의 고객 필드에서 참조할 수 있습니다.

동적 변수가 강조 표시되어 있는 WhatsApp 메시지입니다.

*텍스트*에 자리표지자`를 추가하여 :guilabel:`본문`에 동적 변수를 추가할 수 있습니다. *메시지 본문*에 자리표시자를 추가하려면 `{{1}} 텍스트를 입력하세요. 두 번째 자리 표시자에는 `{{2}}`를 입력하고 자리 표시자가 텍스트에 더 추가됨에 따라 숫자가 점차적으로 커집니다.

Example

다음은 결제 영수증 서식 본문 텍스트입니다.

안녕하세요 {{1}} 님,

다음은 {{3}}*에서 발행한 총 금액 *{{4}}{{5}} {{2}} 청구서입니다.
청구서를 확인하거나 온라인으로 결제하려면 다음을 참조하세요: {{6}}

감사합니다.

더 보기

WhatsApp 서식.

이와 같은 자리표시자는 Meta에서 승인용으로 제출하기 전에 서식의 변수 탭에서 설정해야 합니다. 서식의 동적 변수를 편집하려면 먼저 :guilabel:`유형`을 :guilabel:`모델 필드`로 변경하세요. 이를 통해 Odoo는 모델 내의 필드를 참조하여 전송되는 메시지에서 고유한 데이터를 생성할 수 있습니다.

다음으로, 동적 변수 필드`를 수정하세요. 모델과 필드가 바르게 참조되는지 확인하기 전에 서식의 :guilabel:`적용 대상 필드를 수정해야 합니다.

사용할 수 있는 필드를 검색하려면 검색창에 필드의 프론트엔드 이름을 입력합니다. 서식이 생성된 모델 (적용 대상)에 대해 사용 가능한 필드 전체에서 결과를 검색합니다. 설정해야 할 수준이 여러 개 있을 수 있습니다.

Example

다음은 위에서 설명한 결제 영수증의 위쪽 자리표시자 설정 변수의 예시입니다.

이름

샘플값

유형

필드

본문 - {{1}}

Azure Interior

모델 필드

협력사

본문 - {{2}}

INV/2022/00001

모델 필드

숫자

본문 - {{3}}

내 회사

모델 필드

회사

본문 - {{4}}

$

모델 필드

통화 > 기호

본문 - {{5}}

4000

모델 필드

금액

본문 - {{6}}

https://..

포털 링크

Example

예를 들어, 본문 탭에 “안녕하세요 {{1}} 님”을 입력한 경우 {{1}}`를 :guilabel:`변수 탭에 설정해야 합니다. 이와 같은 특정 사례의 경우에 메시지에서 고객의 이름을 지칭해야 하므로 {{1}}`는 `{{1}} 필드`를 :guilabel:`고객 이름으로 채우도록 설정해야 합니다.

경고

WhatsApp 서식을 커스터마이징하는 것은 Odoo 지원 범위를 벗어납니다.

Meta 서식 승인

서식의 동적 변수를 업데이트한 후, 승인을 받기 위해 서식을 Meta에 다시 제출해야 합니다. :guilabel:`승인용 제출하기`를 클릭하여 승인 프로세스를 시작하세요. 서식이 승인되면 Meta 계정 관리자에게 이메일이 전송됩니다.

Meta의 승인을 받은 후에는 Odoo 데이터베이스에서 서식을 다시 동기화합니다. 다음의 문서를 참조하세요: 서식 동기화하기.

`<https://business.facebook.com/wa/manage/home>`_으로 이동하여 Meta의 WhatsApp 서식 현황표에서 상태를 확인합니다. 그런 다음 :menuselection:`계정 도구 –> 메시지 서식`으로 이동합니다.

서식 동기화하기

Meta 팀의 승인을 받은 후 반드시 서식을 Odoo 데이터베이스에서 동기화해야 합니다. 그렇게 하려면 먼저 :menuselection:`WhatsApp 앱 –> 환경 설정 –> WhatsApp 비즈니스 계정`으로 이동하여 동기화할 설정 항목을 선택하세요. :menuselection:`메시지 전송`이라고 표시된 섹션 아래쪽 하단에서 :guilabel:`동기화 서식`을 클릭합니다. Meta는 승인 완료된 서식이 데이터베이스의 다양한 앱에서 활용할 수 있도록 업데이트합니다.

'서식 동기화'가 강조 표시된 Meta WhatsApp 서식을 Odoo 데이터베이스에 동기화하는 중입니다.

초록색으로 성공했다는 메시지가 서식 업데이트 수와 함께 오른쪽 상단에 나타납니다.

서식을 자체 서식에서 개별적으로 동기화할 수도 있습니다. WhatsApp 앱 ‣ 서식 현황판으로 이동하여 동기화할 서식을 선택하세요. 그런 다음 서식 양식 상단 메뉴에 있는 서식 동기화 버튼을 클릭하세요.

Meta에서 서식 만들기

먼저 `Meta의 WhatsApp 서식 현황판<https://business.facebook.com/wa/manage/home>`_으로 이동한 다음 :menuselection:`계정 도구 –> 메시지 서식`으로 이동합니다.

서식 관리 링크에 대한 강조 표시와 함께 비즈니스 관리자에서 계정 도구가 강조 표시되었습니다.

WhatsApp 서식을 생성하려면 파란색 서식 만들기 버튼을 클릭한 다음 카테고리`를 선택합니다. 나열된 옵션 중에는 :guilabel:`마케팅, 유틸리티 및 :guilabel:`인증`이 포함되어 있습니다. 대부분의 경우, 사용자가 비밀번호 재설정이나 보안 관련 메시지를 보내려는 경우를 제외하고는 처음에 있는 두 옵션을 사용합니다.

서식 :guilabel:`이름`을 입력한 다음 서식 :guilabel:`언어`를 선택하세요.

참고

언어명을 입력하고 필요에 따라 다른 언어를 선택하는 방식으로 여러 가지의 언어를 선택할 수 있습니다.

마케팅, 유틸리티, 이름 및 언어가 강조 표시되어 있는 서식 구성 옵션이 나열됩니다.

알맞게 선택한 후, 오른쪽 상단에 있는 계속`을 클릭합니다. 페이지가 :guilabel:`서식 편집 페이지로 리디렉션됩니다. 여기서 제목, 본문, 바닥글 및 :guilabel:`버튼`을 설정합니다. 서식 우측에는 프로덕션에서 서식이 어떻게 보이는지 확인할 수 있도록 미리보기가 있습니다.

머리글, 본문, 바닥글 및 버튼을 사용하여 서식을 편집합니다.

서식에서 필요한 내용이 모두 변경되면 우측 상단에 있는 제출 버튼을 클릭하세요. 언어를 확인하는 확인창이 나타납니다. :guilabel:`확인`을 클릭하여 승인하면 서식이 검토 및 승인을 위해 Meta에 제출된다는 내용이 또 다른 창으로 표시됩니다.

서식 :guilabel:`상태`는 Meta에서 결정을 내릴 때까지 :guilabel:`검토 중`이 됩니다. 서식이 승인되었다는 확인 이메일을 받으면 서식을 Odoo 데이터베이스 내에서 동기화해야 합니다.

더 보기

Meta 개발자 콘솔에서 서식을 설정하는 자세한 방법은 `Meta의 WhatsApp 서식 문서 <https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/>`_를 참조하세요.

알림

WhatsApp에서의 알림은 Odoo의 메시지 대화와 유사하게 처리됩니다. 고객으로부터 받은 대화 내용이 팝업창으로 표시됩니다. 기본적으로 알림은 Odoo의 WhatsApp 비즈니스 계정 구성에 설정되어 있습니다.

알림 설정을 조정하려면 WhatsApp 앱 ‣ 환경 설정 ‣ WhatsApp 비즈니스 계정`으로 이동합니다. 거기에서 계정을 선택하고 알림이 처리되는 :menuselection:`제어 섹션까지 아래로 스크롤하세요. 사용자에게 알림 제목 아래에 특정 WhatsApp 채널에 대해 알림을 받을 사용자 필드를 입력하세요.

참고

사용자와 고객 간에 대화가 시작되면 WhatsApp 비즈니스 계정에 설정되어 있는 전체 사용자에 대해 알림이 발생하지 않습니다. 알림은 대화에 참여하는 사용자에게만 전송됩니다. 사용자가 15일 이내에 응답하지 않으면 15일 이후 고객의 응답이 WhatsApp 설정에 지정되어 있는 전체 사용자에게 다시 한 번 표시됩니다.

채팅에 사용자 추가하기

WhatsApp 팝업 창을 확장하여 WhatsApp 채팅에 사용자를 추가할 수 있습니다. WhatsApp 대화창은 메일 및 채팅 앱에 있습니다. 옆에 있는 👤+ (사용자 추가) 아이콘을 클릭하면 대화에 사용자를 초대할 수 있는 창이 나타납니다.

사용자 추가 아이콘이 강조 표시되어 있는 WhatsApp 대화창으로 사용자를 추가합니다.

WhatsApp API FAQ

승인

2023년 2월 1일부터 Meta 앱에서 고급 수준의 액세 권한이 필요한 경우에는, 전체 비즈니스 인증을 완료해야 합니다. Meta에 회사의 비즈니스 관련 문서를 제출하는 사항도 포함됩니다. 관련 문서 를 참조하세요.

서식 오류

Editing templates can cause tracebacks and errors unless the exact process is followed above, here: (WhatsApp 서식).

중복 유효성 검사 오류

서식 동기화를 할 때 Meta의 비즈니스 관리자와 Odoo에 이름이 같은 템플릿이 여러 개 있는 경우가 있습니다. 이로 인해 중복 유효성 검사 오류가 발생합니다. 이 문제를 해결하려면 Odoo에서 중복된 서식의 이름을 바꾸고 다음 단계에 따라 서식을 다시 동기화하세요: 서식 동기화하기.

User error populated in Odoo when a duplicate template exists.

Token errors

User error

임시 토큰을 영구 토큰으로 교체하지 않을 경우 전송 실패 후 연결을 테스트할 때 Odoo에서 사용자 오류로 표시됩니다. 이 문제를 해결하려면 영구 토큰 을 참조하세요.

User error populated in Odoo when token expires.

System user error 100

Should the system user be an Employee when setting up the permanent token, a user error 100 will populate.

To correct this error, create an Admin system user, following the process outlined here: 영구 토큰.

User error populated in Odoo when an employee token is generated instead of a Admin user.