왓츠앱¶
WhatsApp 은 사용자가 메시지를 보내고, 전화를 걸고, 콘텐츠를 공유할 수 있는 인스턴트 메시징 및 VoIP (Voice-over-IP) 앱입니다. 기업에서는 WhatsApp 비즈니스 를 사용하여 고객과 문자로 소통하고 문서를 보내거나 고객 지원 서비스를 할 수 있습니다.
경고
WhatsApp 은 Odoo 엔터프라이즈 전용 애플리케이션으로 Odoo 커뮤니티 버전에서는 사용할 수 없습니다. Odoo 엔터프라이즈 버전을 등록하려면 Odoo 무료 평가판 을 클릭하세요.
더 보기
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:
Odoo 데이터베이스에서 직접 WhatsApp 메시지를 수신하고 답장합니다.
동적 자리 표시자/변수로 새 템플릿 만들기
다음과 같은 동적 변수를 사용하는 사전 승인된 템플릿을 전송합니다.
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:
Meta 비즈니스 계정 만들기
Meta 개발자 계정 만들기
Meta 개발자 콘솔에서 앱 및 WhatsApp 제품 설정하기
API 연결을 테스트합니다.
Once connected, messages are then sent and received through Odoo’s Discuss application using the WhatsApp API.
Meta 비즈니스 계정 설정¶
Meta (Facebook 소유) 비즈니스 계정을 만드는 방법은 다음과 같습니다: `Facebook 비즈니스 관리자 <https://business.facebook.com/overview>`_로 이동합니다. :guilabel:`계정 생성`을 클릭한 다음 비즈니스 이름, 관리자 이름, 업무용 이메일 주소를 입력합니다. 그런 다음 :guilabel:`다음`을 클릭하면 이메일 주소를 확인하라는 팝업창이 나타납니다. 확인 후 :guilabel:`완료`를 클릭하여 창을 닫습니다.
그런 다음, Facebook에서 발송된 이메일 안내에 따라서 비즈니스 계정이 만들어진 것을 확인하고 설정 프로세스를 완료하세요.
더 보기
중요
비즈니스 계정이 Facebook 개인 계정에 연결되어 있는 경우에는 관리자가 나머지 설정을 하기 위해서 반드시 개인 계정과 비즈니스 계정 간 전환을 해야 합니다.
비즈니스 계정으로 전환하려면 Facebook 개발자 콘솔 로 이동하여 오른쪽 상단에 있는 계정 이름 을 클릭합니다. 비즈니스 계정 제목 아래에서 WhatsApp 설정을 할 비즈니스를 클릭합니다. 이 계정을 Odoo에서 WhatsApp 메시지를 송수신하는 계정으로 사용하게 됩니다.

중요
Meta 비즈니스 계정을 만들려면 사용자가 Facebook 비즈니스 계정을 설정하기 최소 1시간 전에 개인 Facebook 계정을 이미 가지고 있어야 합니다. 해당 시간 이전에 비즈니스 계정을 생성하려는 경우에는 오류가 발생합니다.
앱 생성하기¶
개발자용 Meta 현황판에서 Meta 개발자 계정으로 로그인합니다. 아직 계정 설정이 되어 있지 않은 경우에는 Facebook 계정을 연결하여 Meta 개발자 계정을 생성하세요.
참고
Facebook 개발자 계정은 Facebook 비즈니스 계정과 다릅니다. 개발자 계정은 Facebook 개인 계정으로 설정되지만, 비즈니스 계정은 그렇지 않으며 비즈니스를 대표하고 앱과 같은 모든 비즈니스 자산을 메타에서 관리합니다.
Meta 개발자 계정에 로그인한 다음 오른쪽 상단에 있는 내 앱 을 클릭합니다. 그러면 관리자가 리디렉션되어 개발자가 해당 개발자 계정에서 설정해놓은 모든 앱으로 이동할 수 있습니다. 앱 만들기 를 클릭하면 새 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.
앱 세부 정보¶
On the Details section of the Create an app process, enter Odoo
in the
field under the Add an app name label.
참고
필요한 경우 나중에 설정 메뉴에서 앱 이름을 변경할 수 있습니다.
경고
상표 및 브랜드 요소는 이 텍스트 섹션에서는 사용할 수 없습니다. 사용할 수 없는 회사로는 Meta 그룹이 포함됩니다. ‘WhatsApp’ 이라는 단어가 포함되지 않도록 합니다. 포함될 경우 시스템에서 오류로 표시됩니다.
다음으로, :guilabel:`앱 이메일 연락처 ` 라벨 아래에 있는 필드에 개발자 이메일 주소를 입력합니다.
마지막으로 드롭다운 메뉴를 사용하여 비즈니스 계정 - 선택 항목 필드를 메타 비즈니스 계정 프로필로 설정합니다. 완료하려면 앱 만들기 를 클릭합니다. 이렇게 하면 앱이 생성되고 메타 플랫폼 약관 및 개발자 정책 동의 문서가 표시됩니다.
약관에 동의하려면 보안을 위해 Facebook 비밀번호를 입력하고 제출 을 클릭하여 앱 생성을 완료합니다. 그러면 브라우저가 개발자용 Meta 현황판으로 이동합니다.
참고
If the Meta business account is prohibited from advertising, claiming an app is not allowed. To resolve this issue navigate to https://business.facebook.com/business for assistance.
자세한 내용은 광고 제한에 대한 Meta 문서 를 참조하세요.
WhatsApp 품목을 앱에 추가하기¶
이제 앱의 기본 구조가 생성되었으므로 앱에 품목을 추가해야 합니다. 먼저 https://developers.facebook.com/apps 로 이동하여 Meta 앱 현황판에 액세스하고 설정 중인 앱을 클릭하는 것부터 시작합니다.
On the next page: since WhatsApp is 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.
WhatsApp API 사용 시작하기¶
이전 WhatsApp 제품 마법사를 마치고 계속 을 클릭하면 브라우저에서 WhatsApp 빠른 시작 페이지로 이동해야 합니다. 빠른 시작 페이지에서는 전화번호를 추가한 다음 초기 테스트 메시지를 전송하여 WhatsApp API 환경 설정을 시작할 수 있습니다.

참고
If the browser is not on the Quickstart page for WhatsApp, navigate to
https://developers.facebook.com/apps and click on the app that is being configured, (the
app name is Odoo
if the instructions above were followed).
그런 다음 페이지 왼쪽 메뉴에서 WhatsApp 섹션 제목 옆에 있는 v (메뉴 토글) 아이콘을 클릭합니다. 다음과 같은 항목이 표시된 작은 메뉴가 열립니다.
Quickstart
APi 설정
환경설정
빠른 시작 옵션을 클릭한 다음 API 사용 시작 을 클릭합니다.
APi 설정¶
API 사용 시작 을 클릭하면, API 설정 페이지로 이동합니다. 이제 테스트 번호가 생성되었으므로, 테스트 메시지를 보내어 WhatsApp 작동 여부를 확인할 수 있습니다. 시작하려면, 페이지에서 메시지 보내기 및 받기 제목의 섹션으로 이동하여 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 New to configure the WhatsApp business account in Odoo.
. Then click다른 브라우저 탭에서
으로 이동한 후 Meta 개발자 콘솔에서 다음 값을 해당하는 Odoo의 필드에 복사합니다.이름 |
메타 콘솔 |
Odoo 인터페이스 |
---|---|---|
전화번호 |
전화번호 ID |
전화번호 ID |
토큰 |
임시 액세스 토큰 |
액세스 토큰 |
앱 ID |
앱 ID |
앱 ID |
계정 ID |
WhatsApp 비즈니스 계정 ID |
계정 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:`웹훅`를 선택합니다.

On the Edit, where both the Callback URL and Webhook Verify Token values from Odoo are added.
page, click on참고
이전 단계에서 테스트 연결`을 클릭하여 :guilabel:`콜백 URL 및 웹훅 확인 토큰 값이 자동으로 채워져 있습니다.
별도의 브라우저 창에서
섹션 아래에 있는 값을 확인하세요.Odoo의 콜백 URL`을 복사하여 Meta의 :guilabel:`콜백 URL 필드로 붙여넣습니다. 마찬가지로, 웹훅 검증 토큰`을 복사하여 Meta 개발자 콘솔의 :guilabel:`토큰 확인 필드에 붙여넣으세요.
마지막으로, :guilabel:`확인 및 저장`을 클릭하여 Meta 개발자 콘솔에 값을 기록합니다.
웹훅 필드¶
Now input individual webhook fields into Meta’s developer console, under the Webhook fields section. Click Manage and when the pop-up window appears, check the boxes in the Subscribe column for the following field names:
account_update
message_template_quality_update
message_template_status_update
messages
template_category_update
선택한 후 완료 를 클릭합니다.
웹훅 환경설정이 끝나면 Meta 개발자 콘솔에 다음과 같이 표시됩니다.

중요
The Webhook fields will only appear once the subscription is confirmed using the Callback URL and Webhook Verify Token.
전화번호 추가¶
WhatsApp에 사용할 전화번호를 Odoo에서 설정하려면 Meta 개발자 콘솔(https://developers.facebook.com/apps)로 다시 이동하여 Odoo가 설정 중인 앱을 다시 선택합니다. 화면 왼쪽의 WhatsApp 메뉴 제목 아래에 있는 API 설정 메뉴 항목을 클릭합니다. 거기에서 :guilabel:`5단계: 전화번호 추가`라고 표시된 섹션으로 이동한 후 :guilabel:`전화번호 추가`를 클릭합니다.
필드에 회사 이름 과 회사 웹사이트 또는 프로필 페이지 를 입력합니다.
팁
The Business website or profile page field can be a social media page’s URL.
국가 섹션의 드롭다운 메뉴에서 회사가 사업을 운영하는 국가를 선택하여 비즈니스 관련 정보를 입력합니다. 원하는 경우 주소를 추가할 수 있으나, 이 내용은 선택 사항입니다. 위치를 추가한 후 계속하려면 다음 을 클릭합니다.
다음 페이지는 WhatsApp 비즈니스 프로필 에 대한 내용입니다. 다음 섹션을 알맞게 완료하세요.
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:`추가`를 클릭하여 시스템 사용자를 신규 생성하세요.
이제 시스템 사용자에게 반드시 자산을 추가해야 영구 토큰을 생성할 수 있습니다.
경고
This is a mandatory step. If the permanent token is not added, the Odoo database shows a token error.
자산 추가 를 클릭하여 팝업창이 나타나면 자산 유형 선택 아래에 있는 앱 을 선택합니다. 그런 다음, Odoo 앱을 선택하고 전체 제어 옵션에서 권한을 켜기 로 전환합니다. 변경 사항 저장 을 클릭하여 새로운 권한 설정 메뉴를 확정하면 시스템 사용자에게 자산 추가를 승인하는 확인창이 나타납니다. 완료 를 클릭하여 절차를 종료합니다.
그런 다음 영구 토큰이 생성됩니다. 새 토큰 생성 을 클릭하면 토큰이 사용될 앱을 지정하라는 팝업창이 나타납니다. 이 토큰을 사용할 앱 을 선택합니다. 이어서 만료일을 60일 또는 사용 안 함 중에서 지정합니다.
마지막으로, Meta에서 시스템 사용자에게 어떤 권한을 허용할지 선택할 때 다음 권한을 모두 추가합니다.
business_management
whatsapp_business_messaging
whatsapp_business_management
권한 설정이 완료되면, :guilabel:`토큰 생성`을 클릭합니다. 다음 화면에 표시되는 토큰 값을 복사하세요.
해당 토큰 값을 사용하여
필드를 업데이트하세요.Meta 앱을 이용한 실시간 스트리밍¶
마지막으로 앱을 실행하려면 Meta 개발자 콘솔에서 Meta 앱을 실시간`으로 설정해야 합니다. `<https://developers.facebook.com/apps>`_로 이동하여 설정 중인 앱을 클릭하세요. 상단 메뉴에서 :guilabel:`앱 모드 필드를 :guilabel:`개발`에서 :guilabel:`살사건`으로 전환하세요.
중요
앱 상태가 *실시간*으로 설정되지 않은 경우에는, 데이터베이스는 개발자 콘솔에 지정된 테스트 번호에만 연락할 수 있습니다.
경고
앱을 실시간 상태로 설정하려면 개인정보 처리방침 URL을 설정해야 합니다. Meta 개발자 콘솔`<https://developers.facebook.com/apps>`_로 이동하여 Odoo에서 설정 중인 앱을 선택합니다. 그런 다음, 화면 왼쪽의 메뉴를 사용하여 필드 아래에 개인정보 처리방침 하이퍼링크 주소를 입력합니다. :guilabel:`변경 사항 저장`을 클릭하여 개인정보 처리방침을 앱에 적용합니다.
앱이 Meta 개발자 콘솔로 발행되면 관리자에게 확인 이메일이 전송됩니다.
WhatsApp 서식¶
WhatsApp 서식은 데이터베이스에서 메시지를 보낼 때 반복적으로 사용할 수 있습니다. 이를 통해 사용자는 동일한 텍스트를 반복해서 작성할 필요 없이 고품질의 커뮤니케이션을 할 수 있게 됩니다.
특정한 상황에 맞추어 다양한 서식을 생성해 놓으면 적절한 대상에게 보낼 적합한 메시지를 선택할 수 있습니다. 이를 통해 메시지의 품질과 전반적인 고객 참여율을 높일 수 있습니다.
WhatsApp 서식은 Odoo 및 Meta 콘솔에서 모두 생성할 수 있습니다. 다음 프로세스에서는 Odoo에서 서식을 생성한 다음 나중에 Meta에서 서식을 생성하는 프로세스를 전체적으로 확인합니다.
중요
WhatsApp에서는 서식 사용 전에 반드시 승인 절차를 완료해야 합니다. 참조: Meta 서식 승인
Odoo에서 서식 만들기¶
WhatsApp 서식에 액세스하여 생성하려면 먼저
현황판으로 이동합니다.서식별로 양식의 하단에는 세 개의 탭이 있습니다: 본문, 버튼, 변수; 이 세 개의 탭을 조합하여 WhatsApp 서식을 생성합니다.
본문 탭에 텍스트를 입력하고 본문 탭에서 호출되는 동적 내용은 변수 탭에서 지정됩니다. 메시지 (본문)의 모든 동적 콘텐츠 (예: 자리표시자)는 특정하게 호출되어 세부 옵션 탭에 지정됩니다.
서식이란 사용자가 고객에게 전문적인 메시지를 보낼 수 있도록 사전 제작되어 있는 레이아웃입니다. 이와 같은 서식에는 서식을 구성하기 위해 설정된 변수를 사용하여 최종적으로 메시지에 들어갈 동적 데이터가 포함될 수 있습니다. 예를 들어, 메시지에 최종 사용자의 이름이 포함되거나, 특정 제품을 언급하거나, 판매주문서를 참조하여 편리하고 영향력 있는 변수의 이름 등을 지정할 수 있습니다.
WhatsApp 서식을 생성하려면 `새로 만들기`를 클릭하세요. 양식에서 서식 :guilabel:`이름`을 입력하고 :guilabel:`언어`를 선택합니다.
현황판으로 이동하여 :guilabel:중요
해당하는 다음 작업을 완료하기 위해 적용 대상 필드를 편집하려면 관리자 액세스 권한이 있어야 합니다. 자세한 내용은 이 액세스 권한 문서 를 참조하세요.
계정`의 드롭다운 메뉴에서 해당 서식을 연결할 Odoo의 *WhatsApp 비즈니스 계정*을 선택하세요. 다음으로, :guilabel:`적용 대상 필드에서 서식에 서버 작업을 적용할 *모델*을 선택합니다.
팁
이 모델은 개발자 모드 에서도 액세스할 수 있습니다. 문의 양식(또는 Odoo에 있는 유사한 관련 양식)에서 참조할 모델로 이동하여 필드 이름 위로 마우스를 가져갑니다. 백엔드 정보 상자가 백엔드의 특정 Odoo 모델 이름과 함께 표시됩니다. WhatsApp 템플릿의 적용 대상 드롭다운 메뉴에서 이 모델을 검색합니다(프론트엔드 이름 입력).
경고
모델 또는 적용 대상 필드를 변경할 때 전화 필드`에서 오류가 발생하는 경우가 종종 있습니다. :guilabel:`전화 필드`는 항상 `전화 또는 모바일
모델로 설정되어야 합니다.
To search available fields, type in the front-end name in the search box. This finds a result from all of the available fields for the model (Applies to) that the template is created for.
참고
특정 필드를 찾아보려면, 검색 결과창에서 수준을 다양하게 하여 검색해야 할 수도 있습니다. > (오른쪽 갈매기형) 및 ⬅️(왼쪽 화살표) 아이콘을 사용하여 메뉴 레벨 사이를 이동합니다.

카테고리 를 마케팅, 유틸리티 또는 인증 카테고리에 맞게 변경합니다. 대부분의 경우 비밀번호를 재설정하거나 보안 관련 메시지를 전송하는 경우를 제외하고는 처음의 두 가지 옵션을 사용하게 됩니다. 프로모션 메시지를 전송하려는 경우에는 마케팅 으로 설정하고, 일반적인 메시지 (예: 판매주문서, 행사 티켓 등)를 전송하려는 경우에는 유틸리티 로 설정합니다.
중요
카테고리를 잘못 지정할 경우 승인 프로세스 중에 Meta에서 플래그/거부 상태가 발생할 수 있습니다.
이 템플릿을 사용할 수 있는 사용자 를 추가합니다. 오른쪽 열에서 헤더 유형 을 헤더 메시지 와 함께 환경설정할 수도 있습니다.
사용할 수 있는 머리글 유형 은 다음과 같습니다.
문자
이미지
동영상
문서
위치(변수 설정 필요)
템플릿에 기본 메시지를 설정하려면 본문 탭으로 이동합니다.
변경해야 할 사항을 템플릿에서 모두 적용한 다음에는 왼쪽 상단에 있는 승인 요청 제출 버튼을 클릭합니다. 그러면 템플릿 상태가 보류 중 으로 변경됩니다.
Meta에서 결정될 때까지 상태는 계속 보류 중 이며, 템플릿이 승인 (또는 거부)되었음을 안내하면 확인 이메일이 전송됩니다. 그런 다음 템플릿을 Odoo 데이터베이스에서 동기화해야 합니다.
이 섹션에서 템플릿 동기화 에 대한 자세한 내용을 확인해 보세요.
팁
Consider the preconfigured 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.
To use these templates, navigate to Submit for Approval to start the approval process. An email gets sent to the administrator of the Meta account when the template has been approved.
and select a preconfigured template. Click자리 표지자 및 변수 사용하기¶
동적 변수는 Odoo 데이터베이스 내에 있는 특정 필드를 참조하여, 서식을 사용할 경우 WhatsApp 메시지에 고유한 데이터를 생성합니다. 동적 변수는 모델 내의 필드를 참조하여 데이터베이스 내의 필드를 표시하도록 인코딩됩니다.
Example
관심을 끌기 위해서 많은 기업에서 맞춤형 고객 정보로 WhatsApp 메시지를 맞춤 설정하는 것을 선호합니다. 이는 Odoo에서 동적 변수를 설정하여 모델 내의 필드를 참조하여 수행될 수 있습니다. 예를 들어, 고객의 이름은 이메일에서 판매주문서 모델의 고객 필드에서 참조할 수 있습니다.

*텍스트*에 자리표지자`를 추가하여 :guilabel:`본문`에 동적 변수를 추가할 수 있습니다. *메시지 본문*에 자리표시자를 추가하려면 `{{1}} 텍스트를 입력하세요. 두 번째 자리 표시자에는 `{{2}}`를 입력하고 자리 표시자가 텍스트에 더 추가됨에 따라 숫자가 점차적으로 커집니다.
Example
다음은 결제 영수증 서식 본문 텍스트입니다.
안녕하세요 {{1}} 님,
감사합니다.
더 보기
이와 같은 자리표시자는 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 데이터베이스에서 동기화해야 합니다. 동기화를 진행하려면 먼저 동기화 서식 을 클릭합니다. Meta에서 승인 서식을 데이터베이스의 다양한 앱에서 활용할 수 있도록 업데이트합니다.
으로 이동하여 동기화할 설정 항목을 선택하세요. 이라고 표시된 섹션 아래쪽 하단에서
초록색으로 성공했다는 메시지가 서식 업데이트 수와 함께 오른쪽 상단에 나타납니다.
팁
서식을 자체 서식에서 개별적으로 동기화할 수도 있습니다. 서식 동기화 버튼을 클릭하세요.
현황판으로 이동하여 동기화할 서식을 선택하세요. 그런 다음 서식 양식 상단 메뉴에 있는Meta에서 서식 만들기¶
먼저 `Meta의 WhatsApp 서식 현황판<https://business.facebook.com/wa/manage/home>`_으로 이동한 다음 :menuselection:`계정 도구 –> 메시지 서식`으로 이동합니다.

WhatsApp 템플릿을 생성하려면 파란색 템플릿 만들기 버튼을 클릭한 다음 카테고리 를 선택합니다. 선택 항목으로는 마케팅, 유틸리티, 인증 이 있습니다. 대부분의 경우에는 처음 두 가지 항목을 선택하는 것이 보통이며, 비밀번호 재설정 또는 보안 관련 내용을 전송하는 경우에는 그렇지 않습니다.
서식 :guilabel:`이름`을 입력한 다음 서식 :guilabel:`언어`를 선택하세요.
참고
Multiple languages can be selected by typing the language names and selecting the other languages as needed.

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

변경할 내용이 템플릿에 모두 적용되었으면, 오른쪽 상단에 있는 제출 버튼을 클릭합니다. 언어를 확인하는 확인 창이 나타납니다. 확인 을 클릭하여 승인하면 템플릿이 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 비즈니스 계정에 설정되어 있는 전체 사용자에 대해 알림이 발송하지 않습니다. 알림은 해당하는 대화에 참여하는 사용자에게만 전송됩니다. 만약 사용자가 15일 이내에 응답하지 않을 경우, 15일이 경과된 후에는 고객의 응답은 WhatsApp 설정에서 지정된 모든 사용자에게 다시 한 번 표시됩니다.
채팅에 사용자 추가하기¶
WhatsApp 팝업 창을 확장하여 WhatsApp 채팅에 사용자를 추가할 수 있습니다. WhatsApp 대화창은 메일 및 채팅 앱에 있습니다. 옆에 있는 👤+ (사용자 추가) 아이콘을 클릭하면 대화에 사용자를 초대할 수 있는 창이 나타납니다.

WhatsApp API FAQ¶
승인¶
2023년 2월 1일부터 Meta 앱에서 고급 수준의 액세 권한이 필요한 경우에는, 전체 비즈니스 인증을 완료해야 합니다. Meta에 회사의 비즈니스 관련 문서를 제출하는 사항도 포함됩니다. 관련 문서 를 참조하세요.
서식 오류¶
템플릿을 편집할 때 위에 명시된 절차를 준수하지 않을 경우에는 트레이스백 및 오류가 발생할 수 있습니다. 참조: (WhatsApp 서식).
중복 유효성 검사 오류¶
서식 동기화를 할 때 동일한 이름인 템플릿이 Meta의 비즈니스 관리자와 Odoo에 여러 개 존재할 수 있습니다. 이로 인해 중복 유효성 검사 오류가 발생할 수 있습니다. 이 문제를 해결하려면 Odoo에서 중복된 서식의 이름을 바꾸고 다음 단계에 따라 서식을 다시 동기화해야 합니다: 서식 동기화하기.

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

시스템 사용자 오류 100¶
Should the system user be an Employee when setting up the permanent token, a user error 100 will populate.
해당 오류를 수정하려면 관리자 시스템 사용자를 생성합니다. 다음에서 생성 방법을 확인하세요: 영구 토큰
