메시지 템플릿

마케팅, 유틸리티 및 인증 대화를 시작하려면 메시지 템플릿이 필요합니다. 이러한 대화의 예로는 고객 관리 메시지나 예약 알림, 결제 또는 배송 업데이트, 알림 등이 있습니다.

요구 사항

• 메시지 템플릿은 승인을 받아야 대화를 시작하는 데 사용할 수 있습니다. 더 알아보기.
• 마케팅, 유틸리티 및 인증과 관련하여 고객과 대화를 시작하려면 고객이 비즈니스에서 메시지를 수신하도록 옵트인했어야 합니다. 자세히 알아보세요.

지원되는 템플릿 카테고리

카테고리를 참조하세요.

번역

메시지 템플릿을 전송할 때는 language 필드를 사용하여 언어를 지정해야 합니다. 사용하려는 모든 번역에 대한 책임은 비즈니스에 있습니다.

지원되는 언어

언어 팩

메시지 템플릿은 언어 팩에 저장됩니다. 언어 팩은 특정 언어 또는 로캘의 메시지 템플릿 요소로 구성된 번들입니다. 비즈니스가 어떤 언어 또는 로캘에 대한 번역을 하나 이상 지원할 경우, 해당 언어 또는 로캘에 대한 팩이 생성됩니다.

메시지 템플릿 네임스페이스는 특정 비즈니스의 언어 팩으로 구성된 번들입니다.

언어 정책 옵션

language: policy 필드를 기본값인 deterministic으로 설정하고 메시지 템플릿을 전송할 경우, WhatsApp은 요청된 해당 언어 및 로캘로 메시지 템플릿을 전송합니다. 그런 다음, 기기가 해당 언어의 언어 팩을 서버에 쿼리합니다.

이 메시지가 기기에 전송되면 기기가 다음과 같이 동작합니다.

• 정책/코드 검사 - "policy": "deterministic" 및 "code": "en"일 때 기기에 캐시된 en 팩이 있나요?

  • 해당 팩이 있다면 요소 검사로 이동합니다.
  • 해당 팩이 없다면 en 팩을 서버에서 찾을 수 있나요?

    • 해당 팩을 서버에서 찾을 수 있다면 로컬 캐시를 업데이트하고 요소 검사로 이동합니다.
    • 해당 팩을 서버에서 찾을 수 없다면 실패를 로깅하고 서버가 Webhooks를 통해 structure_unavailable 오류를 반환하며, 기기에서 메시지가 렌더링되지 않습니다.

• 요소 검사 - "element": "hello_world" 요소가 있나요?

  • 해당 요소가 있을 경우 매개변수의 압축을 풀고 기기에서 메시지를 렌더링합니다.
  • 해당 요소가 없을 경우:

    • 언어 팩이 로컬 캐시에서 제공된다면 서버에서 최신 en 팩을 다운로드하고 요소 검사를 반복합니다.
    • 최근 언어 팩을 서버에서 다운로드했다면 실패를 로깅하고 서버가 Webhooks를 통해 structure_unavailable 오류를 반환하며, 기기에서 메시지가 렌더링되지 않습니다.

기기 언어/로캘 설정을 완전히 무시합니다.

deterministic 정책을 사용할 때 요청하는 언어/로캘이 존재하지 않을 경우 문제가 발생할 수 있습니다. 이때 다음을 확인해야 합니다.

• 네임스페이스가 올바른지 확인하세요.
• 요소 이름이 올바른지 확인하세요.
• 해당 요소에 언어/로캘 번역본이 있는지 확인하세요.
• 전송된 매개변수 개수가 메시지 템플릿에 지정된 것과 일치하는지 확인하세요.

현지화

메시지 템플릿은 기기 로캘 설정에 따라 메시지를 현지화하여 즉시 현지화 지원을 제공합니다.

현지화 가능한 매개변수

템플릿은 메시지에 동적으로 포함되는 매개변수가 있습니다. 이 문서에서 사용된 예시의 경우 메시지 템플릿은 다음과 같습니다.

"You made a purchase for {{1}} using a credit card ending in {{2}}."

"element_name": "purchase_with_credit_card"를 포함한 "namespace": "cdb2df51_9816_c754_c5a4_64cdabdcad3e"의 경우, 첫 번째로 기재한 값은 템플릿 메시지의 {{1}} 변수를 대체하고 두 번째로 기재한 값은 {{2}} 변수를 대체합니다.

일부 매개변수(예: date_time 또는 currency)는 현지화가 가능하며, 고객의 언어와 로캘 기본 설정에 따라 적절히 표시됩니다. 기기에서 매개변수를 현지화하지 못했을 경우에는 fallback_value로 기본 설정됩니다.

fallback_value 외에 통화와 날짜를 지정하려면 currency 및 date_time 개체를 사용하세요. 이렇게 하면 고객이 이 데이터를 가능한 한 최적의 방법으로 현지화할 수 있으며 데이터를 현지화하지 못할 경우에만 fallback_value로 기본 설정됩니다.

localizable_params 옵션은 아래의 표와 같습니다.

매개변수

currency 개체

Whatsapp Business API 클라이언트는 지정된 현지화에 따라 통화 형식을 지정하려고 시도합니다.

예

{
    "type": "currency",
    "currency" : {
        "fallback_value": "$230.99",
        "code": "USD",
        "amount_1000": 230990
    }
}  

date_time 개체

Whatsapp Business API 클라이언트는 지정된 현지화에 따라 날짜/시간 형식을 지정하려고 시도합니다. 지원되는 날짜 및 시간 형식은 다음과 같습니다.

• 구성 요소 시간 - 구성 요소를 조합한 시간입니다(즉, 요일, 월, 시간 등). 클라이언트의 시간대와 상관없이 지정된 시간은 동일합니다.
• Unix 시간 - 표시될 시간은 클라이언트의 시간대에 따릅니다.

DateTime

DateTimeComponent

예

{
    "type": "date_time",
    "date_time" : {
        "fallback_value": "October 25, 2020",
        "day_of_week": "Saturday",
        "day_of_month": 25,
        "year": 2020,
        "month": 10,
        "hour": 12,
        "minute": 0
    }
}

DateTimeUnixEpoch

다음 단계

이 문서에는 메시지 템플릿에 대한 참고 정보가 포함되어 있습니다. 템플릿을 만들고 보내는 방법에 대한 가이드는 메시지 템플릿 보내기를 참조하세요. 메시지 템플릿에서 사용할 수 있는 모든 매개변수는 메시지, 메시지 템플릿에서 확인할 수 있습니다.

https://developers.facebook.com/docs/whatsapp/message-templates/creation#step-1--create-template-using-the-whatsapp-manager