Understanding WhatsApp billing and usage reports for AWS End User Messaging Social - AWS End User Messaging Social
When does the Authentication-International FeeType applyExample 1: Sending a Marketing template messageExample 2: Opening a Service conversationBilling ISO codes

Understanding WhatsApp billing and usage reports for AWS End User Messaging Social

The AWS End User Messaging Social channel generates a usage type that contains five fields in the following format: Region code–MessagingType–ISO–FeeDescription–FeeType. There are two possible billing items for each WhatsApp conversation the WhatsApp ConversationFee, and the AWS per MessageFee.

When you initiate a conversation by sending a template message, you are billed for one WhatsApp ConversationFee and one AWS per MessageFee. This opens a 24-hour window where each message that you send or receive from the same customer is billed as an AWS per MessageFee.

The WhatsApp Conversation type and pricing detail can be found at Conversation-Based Pricing in the WhatsApp Business Platform Developer Guide.

The following table displays the possible values and descriptions for the fields in the usage type. For more information about AWS End User Messaging Social pricing, see WhatsApp in AWS End User Messaging Pricing.

Field Options Description
Region code

  • USE1 – US East (N. Virginia) Region

  • USE2 – US East (Ohio) Region

  • USW1 – US West (Oregon) Region

  • APS1 – Asia Pacific (Mumbai) Region

  • APSE1 – Asia Pacific (Singapore) Region

  • EUW1 – Europe (Ireland) Region

  • EUW2 – Europe (London) Region

 The AWS Region prefix that indicates where the WhatsApp message was sent or received from.
MessagingType WhatsApp This field identifies the message type being sent.
ISO See supported countries The two–digit ISO country code that the message was sent to.
FeeDescription

ConversationFee, MessageFee

This field specifies either the WhatsApp ConversationFee or the AWS per MessageFee.
FeeType

Authentication, Authentication-International, Marketing, Service, Utility, Standard

This field displays the type of conversation type was used, or specifies standard for the per message fee

Business initiated ConversationFee categories

  • Marketing – Used to achieve a wide range of goals, from generating awareness to driving sales and retargeting customers. Examples include new product, service, or feature announcements, targeted promotions/offers, and cart abandonment reminders.

  • Utility – Used to follow up on user actions or requests. Examples include opt-in confirmation, order/delivery management (for example a delivery update); account updates or alerts (for example a payment reminder); or feedback surveys.

  • Authentication – Used to authenticate users with one-time passcodes, potentially at multiple steps in the login process (for example account verification, account recovery, and integrity challenges).

  • Authentication-International – Used the same as Authentication but your business is eligible for Authentication-International rates, based in another country, and the conversation was opened on or after the start time for the country.

  • Service – Used to resolve customer inquiries.

User initiated ConversationFee categories

  • Service – Used to resolve customer inquiries.

MessageFee categories

  • Standard – Per message sent or received fee.

When you initiate a conversation by sending a template message, you are billed for one ConversationFee and one MessageFee. This opens a 24-hour window where each template message that you send to the same customer is billed as an individual MessageFee. During the 24-hour window, the template messages must be the same type or a new conversation is started.

For example, if you send a marketing template message to a customer you are billed for the ConversationFee and MessageFee.

Marketing Template Message 1: APS1-WhatsApp-CA-ConversationFee-Marketing
Marketing Template Message 1: APS1-WhatsApp-CA-MessageFee-Standard
Marketing Template Message 2: APS1-WhatsApp-CA-MessageFee-Standard

If the customer sends you a message and you respond, then you are billed for opening a new Service conversation and message.

Service Message 1: APS1-WhatsApp-CA-ConversationFee-Service
Service Message 1: APS1-WhatsApp-CA-MessageFee-Standard
Service Message 2: APS1-WhatsApp-CA-MessageFee-Standard
Service Message 3: APS1-WhatsApp-CA-MessageFee-Standard

When does the Authentication-International FeeType apply

For a list of countries with an Authentication-International FeeType, see WhatsApp in AWS End User Messaging Pricing.

If you open an Authentication conversation with a WhatsApp user whose country calling code has an Authentication-International FeeType, you will be billed that country's Authentication-International rate if:

  1. Your business opens more than 750K conversations in a moving 30-day period across all of your WhatsApp Business Accounts with WhatsApp users whose country calling codes are for a country that has an Authentication-International rate. For more information, see Eligibility in the WhatsApp Business Platform Developer Guide.

    Important

    If Meta determines that your business is eligible for Authentication-International then they will attempt to send you an email notification with applicable countries and moving 30-day period start times.

  2. Your business is based in another country. For more information on managing your business's location, see Primary business location in the WhatsApp Business Platform Developer Guide.

  3. The conversation was opened on or after your start time for that country

Example 1: Sending a Marketing template message

For example, if you send a marketing template message to a customer, you are billed for one WhatsApp ConversationFee and one AWS per MessageFee.

Marketing Template Message 1: APS1-WhatsApp-CA-ConversationFee-Marketing
Marketing Template Message 1: APS1-WhatsApp-CA-MessageFee-Standard

Example 2: Opening a Service conversation

A service conversation fee applies when a business responds to a user's inbound message that falls outside of any active 24-hour conversation window initiated by the business. In this scenario, you are billed one WhatsApp ConversationFee and an AWS MessageFee for each inbound and outbound message.

Service Message 1: APS1-WhatsApp-CA-ConversationFee-Service
Service Message 1: APS1-WhatsApp-CA-MessageFee-Standard
Service Message 2: APS1-WhatsApp-CA-MessageFee-Standard
Service Message 3: APS1-WhatsApp-CA-MessageFee-Standard

AWS End User Messaging Social billing ISO codes and WhatsApp Conversation Fee mapping

Supported countries
Two-digit ISO country code Country name WhatsApp conversation billing region
AF Afghanistan Rest of Asia Pacific
AX Aland Islands Other
AL Albania Rest of Central & Eastern Europe
DZ Algeria Rest of Africa
AS American Samoa Other
AD Andorra Other
AO Angola Rest of Africa
AI Anguilla Other
AQ Antarctica Other
AG Antigua and Barbuda Other
AR Argentina Argentina
AM Armenia Rest of Central & Eastern Europe
AW Aruba Other
AC Ascension Island Other
AU Australia Rest of Asia Pacific
AT Austria Rest of Western Europe
AZ Azerbaijan Rest of Central & Eastern Europe
BS Bahamas Other
BH Bahrain Rest of Middle East
BD Bangladesh Rest of Asia Pacific
BB Barbados Other
BY Belarus Rest of Central & Eastern Europe
BE Belgium Rest of Western Europe
BZ Belize Other
BJ Benin Rest of Africa
BM Bermuda Other
BT Bhutan Other
BO Bolivia Rest of Latin America
BQ Bonaire Other
BA Bosnia and Herzegovina Other
BW Botswana Rest of Africa
BV Bouvet Island Other
BR Brazil Brazil
IO British Indian Ocean Territory Other
VG British Virgin Islands Other
BN Brunei Darussalam Other
BG Bulgaria Rest of Central & Eastern Europe
BF BurkinaFaso Rest of Africa
BI Burundi Rest of Africa
KH Cambodia Rest of Asia Pacific
CM Cameroon Rest of Africa
CA Canada North America
CV Cape Verde Other
KY Cayman Islands Other
CF Central African Republic Other
TD Chad Rest of Africa
CL Chile Chile
CN China Rest of Asia Pacific
CX Christmas Island Other
CC Cocos(Keeling) Islands Other
CO Colombia Colombia
KM Comoros Other
CK Cook Islands Other
CR Costa Rica Rest of Latin America
CI Cote d'Ivoire Rest of Africa
HR Croatia Rest of Central & Eastern Europe
CW Curacao Other
CY Cyprus Other
CZ Czech Republic Rest of Central & Eastern Europe
CD Democratic Republic of the Congo Rest of Africa
DK Denmark Rest of Western Europe
DJ Djibouti Other
DM Dominica Other
DO Dominican Republic Rest of Latin America
EC Ecuador Rest of Latin America
EG Egypt Egypt
SV El Salvador Rest of Latin America
GQ Equatorial Guinea Other
ER Eritrea Rest of Africa
EE Estonia Other
ET Ethiopia Rest of Africa
SZ Eswatini Rest of Africa
FK Falkland Islands Other
FO Faroe Islands Other
FJ Fiji Other
FI Finland Rest of Western Europe
FR France France
GF French Guiana Other
PF French Polynesia Other
TF French Southern Territories Other
GA Gabon Rest of Africa
GM Gambia Rest of Africa
GE Georgia Rest of Central & Eastern Europe
DE Germany Germany
GH Ghana Rest of Africa
GI Gibraltar Other
GR Greece Rest of Central & Eastern Europe
GL Greenland Other
GD Grenada Other
GP Guadeloupe Other
GU Guam Other
GT Guatemala Rest of Latin America
GG Guernsey Other
GN Guinea Other
GW Guinea-Bissau Rest of Africa
GY Guyana Other
HT Haiti Rest of Latin America
HM Heard and McDonald Islands Other
HN Honduras Rest of Latin America
HK Hong Kong Rest of Asia Pacific
HU Hungary Rest of Central & Eastern Europe
IS Iceland Other
IN India India
ID Indonesia Indonesia
IQ Iraq Rest of Middle East
IE Ireland Rest of Western Europe
IM Isle of Man Other
IL Israel Israel
IT Italy Italy
JM Jamaica Rest of Latin America
JP Japan Rest of Asia Pacific
JE Jersey Other
JO Jordan Rest of Middle East
KZ Kazakhstan Other
KE Kenya Rest of Africa
KI Kiribati Other
XK Kosovo Other
KW Kuwait Rest of Middle East
KG Kyrgyzstan Other
LA Lao PDR Rest of Asia Pacific
LV Latvia Rest of Central & Eastern Europe
LB Lebanon Rest of Middle East
LS Lesotho Rest of Africa
LR Liberia Rest of Africa
LY Libya Rest of Africa
LI Liechtenstein Other
LT Lithuania Rest of Central & Eastern Europe
LU Luxembourg Other
MO Macao Other
MK Macedonia Rest of Central & Eastern Europe
MG Madagascar Rest of Africa
MW Malawi Rest of Africa
MY Malaysia Malaysia
MV Maldives Other
ML Mali Rest of Africa
MT Malta Other
MH Marshall Islands Other
MQ Martinique Other
MR Mauritania Rest of Africa
MU Mauritius Other
YT Mayotte Other
MX Mexico Mexico
FM Micronesia Other
MD Moldova Rest of Central & Eastern Europe
MC Monaco Other
MN Mongolia Rest of Asia Pacific
ME Montenegro Other
MS Montserrat Other
MA Morocco Rest of Africa
MZ Mozambique Rest of Africa
MM Myanmar Other
NA Namibia Rest of Africa
NR Nauru Other
NP Nepal Rest of Asia Pacific
NL Netherlands Netherlands
NC New Caledonia Other
NZ New Zealand Rest of Asia Pacific
NI Nicaragua Rest of Latin America
NE Niger Rest of Africa
NG Nigeria Nigeria
NU Niue Other
NF Norfolk Island Other
MP Northern Mariana Islands Other
NO Norway Rest of Western Europe
OM Oman Rest of Middle East
PK Pakistan Pakistan
PW Palau Other
PS Palestinian Territory Other
PA Panama Rest of Latin America
PG Papua New Guinea Rest of Asia Pacific
PY Paraguay Rest of Latin America
PE Peru Peru
PH Philippines Rest of Asia Pacific
PN Pitcairn Other
PL Poland Rest of Central & Eastern Europe
PT Portugal Rest of Western Europe
PR Puerto Rico Rest of Latin America
QA Qatar Rest of Middle East
CG Republic of Congo Other
RE Reunion Other
RO Romania Rest of Central & Eastern Europe
RU Russian Federation Russia
RW Rwanda Rest of Africa
SH Saint Helena Other
KN Saint Kitts and Nevis Other
LC Saint Lucia Other
PM Saint Pierre and Miquelon Other
VC Saint Vincent and Grenadines Other
BL Saint-Barthelemy Other
MF Saint-Martin Other
WS Samoa Other
SM San Marino Other
ST Sao Tome and Principe Other
SA Saudi Arabia Saudi Arabia
SN Senegal Rest of Africa
RS Serbia Rest of Central & Eastern Europe
SC Seychelles Other
SL Sierra Leone Rest of Africa
SG Singapore Rest of Asia Pacific
SX Sint Maarten Other
SK Slovakia Rest of Central & Eastern Europe
SI Slovenia Rest of Central & Eastern Europe
SB Solomon Islands Other
SO Somalia Rest of Africa
ZA South Africa South Africa
GS South Georgia and the South Sandwich Islands Other
KR South Korea Other
SS South Sudan Rest of Africa
ES Spain Spain
LK Sri Lanka Rest of Asia Pacific
SR Suriname Other
SJ Svalbard and Jan Mayen Islands Other
SE Sweden Rest of Western Europe
CH Switzerland Rest of Western Europe
TW Taiwan Rest of Asia Pacific
TJ Tajikistan Rest of Asia Pacific
TZ Tanzania Rest of Africa
TH Thailand Rest of Asia Pacific
TL Timor-Leste Other
TG Togo Rest of Africa
TK Tokelau Other
TO Tonga Other
TT Trinidad and Tobago Other
TA Tristan da Cunha Other
TN Tunisia Rest of Africa
TR Turkey Turkey
TM Turkmenistan Rest of Asia Pacific
TC Turks and Caicos Islands Other
TV Tuvalu Other
UG Uganda Rest of Africa
UA Ukraine Rest of Central & Eastern Europe
AE United Arab Emirates United Arab Emirates
GB United Kingdom United Kingdom
US United States North America
UY Uruguay Rest of Latin America
UM US Minor Outlying Islands Other
UZ Uzbekistan Rest of Asia Pacific
VU Vanuatu Other
VA Vatican City State Other
VE Venezuela Rest of Latin America
VN Vietnam Rest of Asia Pacific
VI Virgin Islands Other
WF Wallis and Futuna Islands Other
EH Western Sahara Other
YE Yemen Rest of Middle East
ZM Zambia Rest of Africa
ZW Zimbabwe Other