AWS social-messaging documentation change
Summary
Complete restructuring of billing documentation - removed detailed fee type explanations, examples, and ISO code mapping table. Added simplified structure with links to separate topics.
Security assessment
The changes appear to be documentation restructuring/streamlining rather than addressing security issues. No security vulnerabilities or security-related features are mentioned. Changes focus on billing structure explanation and content organization.
Diff
diff --git a/social-messaging/latest/userguide/billing.md b/social-messaging/latest/userguide/billing.md index 50a57acd0..e896b8734 100644 --- a//social-messaging/latest/userguide/billing.md +++ b//social-messaging/latest/userguide/billing.md @@ -5,2 +4,0 @@ -When does the Authentication-International FeeType applyExample 1: Sending a Marketing template messageExample 2: Opening a Service conversationBilling ISO codes - @@ -9,81 +7 @@ When does the Authentication-International FeeType applyExample 1: Sending a Mar -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](https://developers.facebook.com/docs/whatsapp/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](https://aws.amazon.com/end-user-messaging/pricing/) 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](https://aws.amazon.com/end-user-messaging/pricing/#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](https://developers.facebook.com/docs/whatsapp/pricing/authentication-international-rates#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](https://developers.facebook.com/docs/whatsapp/pricing/authentication-international-rates#primary-business-location) in the _WhatsApp Business Platform Developer Guide_. - - 3. The conversation was opened on or after your start time for that country - +There are two types of WhatsApp billing and usage reports for AWS End User Messaging Social: @@ -90,0 +9 @@ If Meta determines that your business is eligible for `Authentication-Internatio + * Charged per conversation @@ -91,0 +11 @@ If Meta determines that your business is eligible for `Authentication-Internatio + * Charged per message @@ -93 +12,0 @@ If Meta determines that your business is eligible for `Authentication-Internatio -## Example 1: Sending a Marketing template message @@ -95 +13,0 @@ If Meta determines that your business is eligible for `Authentication-Internatio -For example, if you send a marketing template message to a customer, you are billed for one WhatsApp `ConversationFee` and one AWS per `MessageFee`. @@ -98,2 +16 @@ For example, if you send a marketing template message to a customer, you are bil - Marketing Template Message 1: APS1-WhatsApp-CA-ConversationFee-Marketing - Marketing Template Message 1: APS1-WhatsApp-CA-MessageFee-Standard +For more information about these billing and report types, see the following topics. @@ -101 +18 @@ For example, if you send a marketing template message to a customer, you are bil -## Example 2: Opening a Service conversation +###### Topics @@ -103 +20 @@ For example, if you send a marketing template message to a customer, you are bil -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. + * [Charged per conversation](./charged-per-conversation.html) @@ -104,0 +22 @@ A service conversation fee applies when a business responds to a user's inbound + * [Charged per message](./charged-per-message.html) @@ -106,4 +23,0 @@ A service conversation fee applies when a business responds to a user's inbound - 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 @@ -111 +24,0 @@ A service conversation fee applies when a business responds to a user's inbound -## AWS End User Messaging Social billing ISO codes and WhatsApp Conversation Fee mapping @@ -113,249 +25,0 @@ A service conversation fee applies when a business responds to a user's inbound -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