You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/communication-services/quickstarts/advanced-messaging/whatsapp/connect-whatsapp-business-account.md
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:
18
18
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.
21
21
22
22
## Overview
23
23
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.
@@ -47,13 +47,14 @@ This document provides information about registering a WhatsApp Business Account
47
47
1. After selecting Meta Business Account, you need to **create/select** a WhatsApp Business profile. Fill out the required information.
48
48
49
49
> [!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.
51
51
52
52
:::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.":::
53
53
54
54
2. Once you complete the form, select **Next** to continue.
55
55
56
56
## Verify your WhatsApp business number
57
+
57
58
[!INCLUDE [Verify WhatsApp Business Phonenumber](./includes/register-whatsapp-account/verify-phone-number.md)]
58
59
59
60
## 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
74
75
|**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. |
75
76
|**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. |
76
77
|**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. |
78
79
|**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. |
79
80
|**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. |
80
81
@@ -91,14 +92,14 @@ Provide the company details to be used in your Meta Business Account then select
91
92
Once Business account is created, continue with [**Set up WhatsApp Profile**](#select-whatsapp-business-profile) step.
92
93
93
94
> [!NOTE]
94
-
> More details on how-to and required information on Meta Business Accountcan 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).
95
96
96
97
## Next steps
97
98
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.
99
100
100
101
> [!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)
102
103
103
104
You might also want to see the following articles:
Copy file name to clipboardExpand all lines: articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/dot-net-application-setup.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -32,13 +32,13 @@ dotnet run
32
32
33
33
#### [.NET CLI](#tab/dotnet-cli)
34
34
35
-
First, create your project.
35
+
Create your project.
36
36
37
37
```console
38
38
dotnet new console -o AdvancedMessagingQuickstart
39
39
```
40
40
41
-
Next, navigate to your project directory and build your project.
41
+
Navigate to your project directory and build your project.
Copy file name to clipboardExpand all lines: articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/get-started/messages-get-started-net.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,9 +17,9 @@ ms.author: memontic
17
17
- Active WhatsApp phone number to receive messages.
18
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
19
20
-
## Setting up
20
+
## Set up environment
21
21
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)]
Copy file name to clipboardExpand all lines: articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/interactive/messages-quickstart-interactive-messages-net.md
+6-2Lines changed: 6 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,6 +13,10 @@ ms.author: shamkh
13
13
14
14
## Prerequisites
15
15
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).
17
19
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)]
Copy file name to clipboardExpand all lines: articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/reactions/messages-quickstart-reaction-messages-net.md
+6-2Lines changed: 6 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,6 +13,10 @@ ms.author: shamkh
13
13
14
14
## Prerequisites
15
15
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).
17
19
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)]
Copy file name to clipboardExpand all lines: articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/stickers/messages-quickstart-sticker-messages-net.md
+5-1Lines changed: 5 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,6 +13,10 @@ ms.author: shamkh
13
13
14
14
## Prerequisites
15
15
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
17
21
18
22
[!INCLUDE [Setting up for .NET Application](../dot-net-application-setup.md)]
Copy file name to clipboardExpand all lines: articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/templates/messages-quickstart-template-messages-java.md
+13-11Lines changed: 13 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,12 +18,13 @@ To set up an environment for sending messages, complete the steps in the followi
18
18
[!INCLUDE [Setting up for Java Application](../java-application-setup.md)]
19
19
20
20
## Code examples
21
+
21
22
Follow these steps to add required code snippets to the main function of your `App.java` file.
22
23
-[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).
27
28
28
29
### List WhatsApp templates in the Azure portal
29
30
@@ -64,7 +65,7 @@ public static void getMessageTemplateWithConnectionString() {
64
65
}
65
66
```
66
67
67
-
### Send Template message with text parameters in the body
68
+
### Send template message with text parameters in the body
68
69
69
70
If the template takes no parameters, you don't need to supply any values or bindings when creating the `MessageTemplate`.
### Send Template message with media parameter in the header
112
+
### Send template message with media parameter in the header
112
113
113
114
Use `MessageTemplateImage`, `MessageTemplateVideo`, or `MessageTemplateDocument` to define the media parameter in a header.
114
115
@@ -132,7 +133,7 @@ The `"format"` can be on of four different media types supported by WhatsApp. In
132
133
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).
### Send Template message with quick reply buttons
221
+
### Send template message with quick reply buttons
221
222
222
223
Use `MessageTemplateQuickAction` to define the payload for quick reply buttons and `MessageTemplateQuickAction` objects have the following three attributes.
223
224
224
225
| Properties | Description | Type |
225
226
| --- | --- | --- |
226
227
| Name | The `name` used to look up the value in `MessageTemplateWhatsAppBindings`. | string |
227
228
| 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 |
### 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.
Copy file name to clipboardExpand all lines: articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/templates/messages-quickstart-template-messages-python.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -58,7 +58,7 @@ To list out your templates programmatically, you can fetch all templates for you
58
58
59
59
[!INCLUDE [List templates with Python](./template-messages-list-templates-python.md)]
60
60
61
-
### Send Template message with no parameters
61
+
### Send template message with no parameters
62
62
63
63
If the template doesn't require parameters, you don't need to supply the values or bindings when creating the `MessageTemplate`.
### Send Template message with quick reply buttons
194
+
### Send template message with quick reply buttons
195
195
196
196
Use `MessageTemplateQuickAction` to define the payload for quick reply buttons and `MessageTemplateQuickAction` objects have the following three attributes.
197
197
198
-
|Properties| Description | Type |
198
+
| Properties | Description | Type |
199
199
| --- | --- | --- |
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 |
Copy file name to clipboardExpand all lines: articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/templates/template-messages-quick-reference-net.md
+4-3Lines changed: 4 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -381,7 +381,7 @@ The order that the buttons appear in the template definition must match the orde
381
381
382
382
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.
383
383
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.":::
385
385
386
386
In this sample, the header of the template requires an image:
### 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.
444
445
445
446
Template definition buttons:
446
447
```json
@@ -462,7 +463,7 @@ Template definition buttons:
462
463
463
464
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.
464
465
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.":::
466
467
467
468
In this sample, the header of the template requires an image:
0 commit comments