Skip to content

Commit 8dc7a80

Browse files
committed
Edited per admin requests
Edited to fix blockers in text and to fix broken links to headings within files.
1 parent 260dfb7 commit 8dc7a80

11 files changed

+214
-195
lines changed

articles/communication-services/quickstarts/advanced-messaging/whatsapp/connect-whatsapp-business-account.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -12,16 +12,16 @@ ms.service: azure-communication-services
1212
ms.subservice: advanced-messaging
1313
---
1414

15-
# Quickstart: Register WhatsApp business account
15+
# Register WhatsApp business account
1616

1717
Get started with the Azure Communication Services Advanced Messaging, which extends messaging to users on WhatsApp. This feature enables your organization to send and receive messages with WhatsApp users using a WhatsApp Business Account. The Advanced Communication Messages SDK extends your communications to interact with the large global WhatsApp community for common scenarios:
1818

19-
- Receive inquiries from your customers for product feedback or support, price quotes, and reschedule appointments.
20-
- Send your customer's notifications like appointment reminders, product discounts, transaction receipts, and one-time passcodes.
19+
- Receive inquiries from your customers for product feedback or support, price quotes, and reschedule appointments.
20+
- Send your customer's notifications like appointment reminders, product discounts, transaction receipts, and one-time passcodes.
2121

2222
## Overview
2323

24-
This document provides information about registering a WhatsApp Business Account with Azure Communication Services. The following video demonstrates this process.
24+
This article provides information about registering a WhatsApp Business Account with Azure Communication Services. The following video demonstrates this process.
2525
> [!VIDEO https://learn-video.azurefd.net/vod/player?id=04c63978-6f27-4289-93d6-625d8569ee28]
2626
2727
## Prerequisites
@@ -47,13 +47,14 @@ This document provides information about registering a WhatsApp Business Account
4747
1. After selecting Meta Business Account, you need to **create/select** a WhatsApp Business profile. Fill out the required information.
4848

4949
> [!NOTE]
50-
> A WhatsApp Business Account can only be registered with Advanced Messaging one time. Selecting a WhatsApp Business Account already in use will result in an error when trying to create the channel.
50+
> You can only register a WhatsApp Business Account with Advanced Messaging one time. If you select a WhatsApp Business Account already in use, it results in an error when you try to create the channel.
5151
5252
:::image type="content" source="./media/register-whatsapp-account/whatsapp-business-account-details.png" lightbox="./media/register-whatsapp-account/whatsapp-business-account-details.png" alt-text="Screenshot that shows WhatsApp Business account details.":::
5353

5454
2. Once you complete the form, select **Next** to continue.
5555

5656
## Verify your WhatsApp business number
57+
5758
[!INCLUDE [Verify WhatsApp Business Phonenumber](./includes/register-whatsapp-account/verify-phone-number.md)]
5859

5960
## View your WhatsApp account in the Azure Communication Services Resource
@@ -74,7 +75,7 @@ You can see the status of your WhatsApp Business account in the Azure portal. Ac
7475
|**Disconnected**| A WhatsApp account is disconnected from the Azure portal side. | If you no longer want to use the WhatsApp Business account, you need to go to WhatsApp manager portal to unshare the WhatsApp Business Account or delete the phone number or delete the WhatsApp Business Account for a complete disconnection. If you still want the WhatsApp Business account connected, you need to redo the registration process by disconnecting then reconnecting the account. |
7576
|**Phone number deleted**| A WhatsApp business phone number is deleted from the WhatsApp side. | If you no longer want to use the WhatsApp Business account, you can disconnect the account. If you still want the WhatsApp Business account connected, you need to redo the registration process by disconnecting then reconnecting the account with adding the same phone number. |
7677
|**Business account review rejected**| WhatsApp disabled the business account because it doesn't comply with WhatsApp Business's Commerce Policy. | Check details on WhatsApp manager portal and request a review if you believe that this rejection is incorrect. |
77-
|**Display name review not started**| WhatsApp hasn't started WhatsApp Business display name review for your business phone number. Typically, the review didn't start because your Meta business account has not yet finish Meta Business Verification. [See this link for details about Meta Business Verification.](https://www.facebook.com/business/help/2058515294227817) | WhatsApp Business display name review isn't required to get started. You can immediately start sending messages to customers. You have limited number of messages and recipients per day until WhatsApp Business display name review is approved. |
78+
|**Display name review not started**| WhatsApp didn't start a WhatsApp Business display name review for your business phone number. Typically, the review didn't start because your Meta business account has not yet finish Meta Business Verification. [See this link for details about Meta Business Verification.](https://www.facebook.com/business/help/2058515294227817) | WhatsApp Business display name review isn't required to get started. You can immediately start sending messages to customers. You have limited number of messages and recipients per day until WhatsApp Business display name review is approved. |
7879
|**Display name review pending**| The WhatsApp business phone number display name is under review by WhatsApp. | WhatsApp Business display name review isn't required to get started. You can immediately start sending messages to customers. You have limited number of messages and recipients per day until WhatsApp Business display name review is approved. |
7980
|**Display name review rejected**| WhatsApp rejects the WhatsApp business phone number display name. | Check details and submit a new phone number display name on WhatsApp manager portal. WhatsApp Business display name review isn't required to get started. You can immediately start sending messages to customers. You have limited number of messages and recipients per day until WhatsApp Business display name review is approved. |
8081

@@ -91,14 +92,14 @@ Provide the company details to be used in your Meta Business Account then select
9192
Once Business account is created, continue with [**Set up WhatsApp Profile**](#select-whatsapp-business-profile) step.
9293

9394
> [!NOTE]
94-
> More details on how-to and required information on Meta Business Account can be found [Here](https://www.facebook.com/business/tools/meta-business-suite)
95+
> For details about how-to and required information for Meta Business Account, see can be found [Meta Business Suite](https://www.facebook.com/business/tools/meta-business-suite).
9596
9697
## Next steps
9798

98-
In this quickstart, you learned how to register your WhatsApp Business Account with Azure Communication Services. Now, you're ready to send and receive WhatsApp messages.
99+
This article described how to register your WhatsApp Business Account with Azure Communication Services. Now you're ready to send and receive WhatsApp messages.
99100

100101
> [!div class="nextstepaction"]
101-
> [Get Started With Advanced Messages SDK](../../../quickstarts//advanced-messaging/whatsapp/get-started.md)
102+
> [Get started With Advanced Messages SDK](../../../quickstarts//advanced-messaging/whatsapp/get-started.md)
102103
103104
You might also want to see the following articles:
104105

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/dot-net-application-setup.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,13 +32,13 @@ dotnet run
3232

3333
#### [.NET CLI](#tab/dotnet-cli)
3434

35-
First, create your project.
35+
Create your project.
3636

3737
```console
3838
dotnet new console -o AdvancedMessagingQuickstart
3939
```
4040

41-
Next, navigate to your project directory and build your project.
41+
Navigate to your project directory and build your project.
4242

4343
```console
4444
cd AdvancedMessagingQuickstart

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/get-started/messages-get-started-net.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,9 +17,9 @@ ms.author: memontic
1717
- Active WhatsApp phone number to receive messages.
1818
- .NET development environment, such as [Visual Studio](https://visualstudio.microsoft.com/downloads/), [Visual Studio Code](https://code.visualstudio.com/Download), or [.NET CLI](https://dotnet.microsoft.com/download).
1919

20-
## Setting up
20+
## Set up environment
2121

22-
[!INCLUDE [Setting up for .NET Application](../dot-net-application-setup.md)]
22+
[!INCLUDE [Set up environment for .NET Application](../dot-net-application-setup.md)]
2323

2424
## Object model
2525

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/interactive/messages-quickstart-interactive-messages-net.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,10 @@ ms.author: shamkh
1313

1414
## Prerequisites
1515

16-
## Setting up
16+
- [WhatsApp Business Account registered with your Azure Communication Services resource](../../connect-whatsapp-business-account.md).
17+
- Active WhatsApp phone number to receive messages.
18+
- .NET development environment, such as [Visual Studio](https://visualstudio.microsoft.com/downloads/), [Visual Studio Code](https://code.visualstudio.com/Download), or [.NET CLI](https://dotnet.microsoft.com/download).
1719

18-
[!INCLUDE [Setting up for .NET Application](../dot-net-application-setup.md)]
20+
## Set up environment
21+
22+
[!INCLUDE [Set up environment for .NET application](../dot-net-application-setup.md)]

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/reactions/messages-quickstart-reaction-messages-net.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,10 @@ ms.author: shamkh
1313

1414
## Prerequisites
1515

16-
## Setting up
16+
- [WhatsApp Business Account registered with your Azure Communication Services resource](../../connect-whatsapp-business-account.md).
17+
- Active WhatsApp phone number to receive messages.
18+
- .NET development environment, such as [Visual Studio](https://visualstudio.microsoft.com/downloads/), [Visual Studio Code](https://code.visualstudio.com/Download), or [.NET CLI](https://dotnet.microsoft.com/download).
1719

18-
[!INCLUDE [Setting up for .NET Application](../dot-net-application-setup.md)]
20+
## Set up environment
21+
22+
[!INCLUDE [Set up environment for .NET application](../dot-net-application-setup.md)]

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/stickers/messages-quickstart-sticker-messages-net.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,10 @@ ms.author: shamkh
1313

1414
## Prerequisites
1515

16-
## Setting Up
16+
- [WhatsApp Business Account registered with your Azure Communication Services resource](../../connect-whatsapp-business-account.md).
17+
- Active WhatsApp phone number to receive messages.
18+
- .NET development environment, such as [Visual Studio](https://visualstudio.microsoft.com/downloads/), [Visual Studio Code](https://code.visualstudio.com/Download), or [.NET CLI](https://dotnet.microsoft.com/download).
19+
20+
## Set up environment
1721

1822
[!INCLUDE [Setting up for .NET Application](../dot-net-application-setup.md)]

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/templates/messages-quickstart-template-messages-java.md

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -18,12 +18,13 @@ To set up an environment for sending messages, complete the steps in the followi
1818
[!INCLUDE [Setting up for Java Application](../java-application-setup.md)]
1919

2020
## Code examples
21+
2122
Follow these steps to add required code snippets to the main function of your `App.java` file.
2223
- [List WhatsApp templates in the Azure portal](#list-whatsapp-templates-in-the-azure-portal).
23-
- [Send Template message with text parameters in the body](#send-template-message-with-text-parameters-in-the-body).
24-
- [Send Template message with media parameter in the header](#send-template-message-with-media-parameter-in-the-header).
25-
- [Send Template message with quick reply buttons](#send-template-message-with-quick-reply-buttons).
26-
- [Send Template message with call to action buttons](#send-template-message-with-call-to-action-buttons).
24+
- [Send template message with text parameters in the body](#send-template-message-with-text-parameters-in-the-body).
25+
- [Send template message with media parameter in the header](#send-template-message-with-media-parameter-in-the-header).
26+
- [Send template message with quick reply buttons](#send-template-message-with-quick-reply-buttons).
27+
- [Send Template message with call to action buttons and dynamic link](#send-template-message-with-call-to-action-buttons-and-dynamic-link).
2728

2829
### List WhatsApp templates in the Azure portal
2930

@@ -64,7 +65,7 @@ public static void getMessageTemplateWithConnectionString() {
6465
}
6566
```
6667

67-
### Send Template message with text parameters in the body
68+
### Send template message with text parameters in the body
6869

6970
If the template takes no parameters, you don't need to supply any values or bindings when creating the `MessageTemplate`.
7071

@@ -108,7 +109,7 @@ private static void sendTemplateMessage() {
108109
}
109110
```
110111

111-
### Send Template message with media parameter in the header
112+
### Send template message with media parameter in the header
112113

113114
Use `MessageTemplateImage`, `MessageTemplateVideo`, or `MessageTemplateDocument` to define the media parameter in a header.
114115

@@ -132,7 +133,7 @@ The `"format"` can be on of four different media types supported by WhatsApp. In
132133
For more information about supported media types and size limits, see [WhatsApp's documentation for message media](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#supported-media-types).
133134

134135

135-
#### Examples
136+
#### Example
136137

137138
`sample_happy_hour_announcement` template:
138139

@@ -217,15 +218,15 @@ private static void sendTemplateMessageWithVideo() {
217218
}
218219
```
219220

220-
### Send Template message with quick reply buttons
221+
### Send template message with quick reply buttons
221222

222223
Use `MessageTemplateQuickAction` to define the payload for quick reply buttons and `MessageTemplateQuickAction` objects have the following three attributes.
223224

224225
| Properties | Description | Type |
225226
| --- | --- | --- |
226227
| Name | The `name` used to look up the value in `MessageTemplateWhatsAppBindings`. | string |
227228
| Text | The option quick action `text`. | string |
228-
| Payload| The `payload` assigned to a button available in a message reply if the user selects the button. | string |
229+
| Payload | The `payload` assigned to a button available in a message reply if the user selects the button. | string |
229230

230231
Template definition with quick reply buttons:
231232
```json
@@ -317,8 +318,9 @@ private static void sendTextTemplateMessageWithQuickReply() {
317318
}
318319
```
319320

320-
### Send Template message with call to action buttons with dynamic link
321-
Use `MessageTemplateQuickAction` to define the url suffix for call to action buttons and `MessageTemplateQuickAction` object have the following two attributes.
321+
### Send Template message with call to action buttons and dynamic link
322+
323+
Use `MessageTemplateQuickAction` to define the URL suffix for call to action buttons and `MessageTemplateQuickAction` object have the following two attributes.
322324

323325
| Properties | Description | Type |
324326
| --- | --- | --- |

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/templates/messages-quickstart-template-messages-python.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ To list out your templates programmatically, you can fetch all templates for you
5858

5959
[!INCLUDE [List templates with Python](./template-messages-list-templates-python.md)]
6060

61-
### Send Template message with no parameters
61+
### Send template message with no parameters
6262

6363
If the template doesn't require parameters, you don't need to supply the values or bindings when creating the `MessageTemplate`.
6464

@@ -118,7 +118,7 @@ template_options = TemplateNotificationContent(
118118
)
119119
```
120120

121-
### Send Template message with media parameter in the header
121+
### Send template message with media parameter in the header
122122

123123
Use `MessageTemplateImage`, `MessageTemplateVideo`, or `MessageTemplateDocument` to define the media parameter in a header.
124124

@@ -191,15 +191,15 @@ template_options = TemplateNotificationContent(
191191
channel_registration_id=self.channel_id, to=[self.phone_number], template=sample_movie_ticket_confirmation)
192192
```
193193

194-
### Send Template message with quick reply buttons
194+
### Send template message with quick reply buttons
195195

196196
Use `MessageTemplateQuickAction` to define the payload for quick reply buttons and `MessageTemplateQuickAction` objects have the following three attributes.
197197

198-
| Properties | Description | Type |
198+
| Properties | Description | Type |
199199
| --- | --- | --- |
200-
| Name | The `name` to look up the value in `MessageTemplateWhatsAppBindings`. | string |
201-
| Text | The option quick action `text`. | string |
202-
| Payload| The `payload` assigned to a button available in a message reply if the user selects the button. | string |
200+
| Name | The `name` to look up the value in `MessageTemplateWhatsAppBindings`. | string |
201+
| Text | The option quick action `text`. | string |
202+
| Payload | The `payload` assigned to a button available in a message reply if the user selects the button. | string |
203203

204204
Template definition with quick reply buttons:
205205

@@ -276,7 +276,7 @@ template_options = TemplateNotificationContent(
276276
)
277277
```
278278

279-
### Send Template message with location in the header
279+
### Send template message with location in the header
280280

281281
Use `MessageTemplateLocation` to define the location parameter in a header.
282282

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/templates/template-messages-quick-reference-net.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -381,7 +381,7 @@ The order that the buttons appear in the template definition must match the orde
381381

382382
This sample template adds a button with a dynamic URL link to the message. It also uses an image in the header and a text parameter in the body.
383383

384-
:::image type="content" source="../../media/template-messages/edit-sample-purchase-feedback-whatsapp-manager.png" lightbox="../../media/template-messages/edit-sample-purchase-feedback-whatsapp-manager.png" alt-text="Screenshot that shows editing URL Type in the WhatsApp manager.":::
384+
:::image type="content" source="../../media/template-messages/edit-sample-purchase-feedback-whatsapp-manager.png" lightbox="../../media/template-messages/edit-sample-purchase-feedback-whatsapp-manager.png" alt-text="Screen capture of the WhatsApp manager Buttons editor Call to action panel that shows the URL Type button you can use to choose between Static and Dynamic.":::
385385

386386
In this sample, the header of the template requires an image:
387387

@@ -440,7 +440,8 @@ purchaseFeedbackTemplate.Bindings = bindings;
440440
```
441441

442442
### Send Template message with call to action buttons with static link
443-
For static link we need not to include `MessageTemplateQuickAction` model as WhatsApp template has static `CallToAction` link and no input from user is required.
443+
444+
For static links, you don't need to include `MessageTemplateQuickAction` model because the WhatsApp template has a static `CallToAction` link with no input required from the user.
444445

445446
Template definition buttons:
446447
```json
@@ -462,7 +463,7 @@ Template definition buttons:
462463

463464
This sample template adds a button with a static URL link to the message. It also uses an image in the header and a text parameter in the body.
464465

465-
:::image type="content" source="../../media/template-messages/purchase_feedback_static_link_template.png" lightbox="../../media/template-messages/purchase_feedback_static_link_template.png" alt-text="Screenshot that shows editing URL Type in the WhatsApp manager.":::
466+
:::image type="content" source="../../media/template-messages/purchase_feedback_static_link_template.png" lightbox="../../media/template-messages/purchase_feedback_static_link_template.png" alt-text="Screen capture that shows details for the purchase_feedback_static template.":::
466467

467468
In this sample, the header of the template requires an image:
468469

0 commit comments

Comments
 (0)