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/concepts/advanced-messaging/whatsapp/whatsapp-channel-in-copilot-studio.md
+31-16Lines changed: 31 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,7 +24,7 @@ This article covers the prerequisites to configuring WhatsApp as a Channel in Mi
24
24
2. Get a phone number that can receive SMS.
25
25
3. Setup and Deploy Event Grid Viewer
26
26
4. Setup Event subscription for SMS received.
27
-
5.Link WhatsApp business account as a channel in Azure Communication Services Resource
27
+
5.Connect WhatsApp business account as a channel in Azure Communication Services Resource
28
28
29
29
The following video demonstrates this process.
30
30
@@ -51,19 +51,17 @@ When following those instructions, here are helpful tips:
51
51
52
52
## Get a phone number
53
53
54
-
The phone number is used to link your Azure Communication Services resource to your WhatsApp Business Account and then your AI agent in Microsoft Copilot Studio.
54
+
You can [provision a Toll-free number with SMS enabled from Azure Communication Services](https://learn.microsoft.com/en-us/azure/communication-services/quickstarts/telephony/get-phone-number?tabs=windows&pivots=platform-azp-new)
55
+
or bring your own phone number.
55
56
56
57
Make sure the phone number has the following capabilities:
57
58
58
-
1. Able to receive SMS
59
+
1. Able to receive SMS so your phone number can be verified by Meta
59
60
2. Phone number isn't already associated with a WhatsApp Business Account
60
61
61
-
You can [provision a Toll-free number with SMS enabled from Azure Communication Services](https://learn.microsoft.com/en-us/azure/communication-services/quickstarts/telephony/get-phone-number?tabs=windows&pivots=platform-azp-new)
62
-
or bring your own phone number.
63
-
64
62
## Setup and Deploy Event Grid Viewer
65
63
66
-
The following steps are only needed if you chose to use a Toll-free number from Azure Communication Services phone number with SMS enabled. The Event Grid Viewer display notification information for events it is subscribed to.
64
+
The following steps are only needed if you chose to use a Toll-free number from Azure Communication Services phone number with SMS enabled. The Event Grid Viewer display notification information for events it is subscribed to.
67
65
68
66
1. Click on the following button to will launch a custom template for the Azure portal instance that you are logged into to set up the Event Grid Viewer.
69
67
@@ -83,15 +81,15 @@ The following steps are only needed if you chose to use a Toll-free number from
83
81
4. After the deployment completes, select **Go to resource group**.
84
82
85
83
:::image type="content" source="./media/event-grid-viewer-deployment.png" lightbox="./media/event-grid-viewer-deployment.png" alt-text="Screenshot that shows deployment complete of the Event Grid Viewer web app.":::
86
-
87
-
5. Select on your event grid viewer.
84
+
85
+
5. Select on your Event Grid Viewer.
88
86
89
87
:::image type="content" source="./media/resource-group.png" lightbox="./media/resource-group.png" alt-text="Screenshot that shows the Event Grid Viewer web app in the resource group.":::
90
-
88
+
91
89
6. On the resource overview page, select on the copy button next to the **Default Domain** property.
92
90
93
91
:::image type="content" source="./media/event-grid-viewer-web-app.png" lightbox="./media/event-grid-viewer-web-app.png" alt-text="Screenshot that shows URL of Event Grid Viewer web app.":::
94
-
92
+
95
93
7. Launch that site in your browser and keep it running so you can receive the verification code when you're [linking your WhatsApp business account to Azure Communication Services resource](#link-whatsapp-business-account-as-a-channel-in-azure-communication-services-resource). The Event Grid Viewer should look like this.
96
94
97
95
:::image type="content" source="./media/event-grid-viewer-site.png" lightbox="./media/event-grid-viewer-site.png" alt-text="Screenshot that shows the Event Grid Viewer web app.":::
@@ -112,7 +110,7 @@ When following those instructions, here are helpful tips:
112
110
113
111
:::image type="content" source="./media/event-subscription-details.png" lightbox="./media/event-subscription-details.png" alt-text="Screenshot that shows the details to create an event subscription for SMS Received event type.":::
114
112
115
-
## Link WhatsApp business account as a channel in Azure Communication Services Resource
113
+
## Connect WhatsApp business account as a channel in Azure Communication Services Resource
116
114
117
115
1. With your newly created Azure Communication Services resource, on the left navigation bar, select on the **Advance Messaging** and then select **Channels**. To add a new WhatsApp Business Account, select on the **Connect** button.
118
116
@@ -163,7 +161,7 @@ When following those instructions, here are helpful tips:
163
161
164
162
:::image type="content" source="./media/whatsapp-business-profile-details.png" lightbox="./media/whatsapp-business-profile-details.png" alt-text="Screenshot that shows details need to create a WhatsApp Business profile.":::
165
163
166
-
14.A phone number is needed, and it is what people see when they chat with you. Another WhatsApp Business account can't use this phone number.
164
+
14.The phone number you provide will be linked to your WhatsApp Business Account. Another WhatsApp Business account can't use this phone number.
167
165
168
166
Use the Azure Communication Service toll-free phone number you provisioned previously or bring your own phone number.
169
167
@@ -187,20 +185,37 @@ When following those instructions, here are helpful tips:
187
185
188
186
The status of your WhatsApp Business account is displayed in the Azure portal. Once approved, you will see an **Active** status.
189
187
190
-
[insert image]
188
+
:::image type="content" source="./media/active-display-name.png" lightbox="./media/active-display-name.png" alt-text="Screenshot that shows an Active status WhatsApp Business account in the Azure portal.":::
191
189
192
-
Only when you see that status can you then use the WhatsApp Business account to send and receive messages and unlocks the ability to link WhatsApp Business account as a channel in Microsoft Copilot Studio.
190
+
Only when you see that status can you use the WhatsApp Business account to send and receive messages without limitations of number of messages and recipients per day. It also unlocks the ability to link WhatsApp Business account as a channel in Microsoft Copilot Studio.
193
191
194
192
Meta reviews your business's display name. You can learn more about this review process and how to update your business account's display name in the article [About WhatsApp Business display name](https://www.facebook.com/business/help/338047025165344).
195
193
194
+
When you no longer want to use the WhatsApp Business account with Azure Communication Services, you can select the account and select the **Disconnect** button. This option disconnects the account from Azure Communication Services but doesn't delete the account and the account can be reconnected later.
195
+
196
+
### WhatsApp account status
197
+
198
+
You can see the status of your WhatsApp Business account in the Azure portal. Accounts with different statuses have different restrictions on messaging features. An account can have following types of status.
|**Active**| A WhatsApp account is ready to use. ||
203
+
|**Revoked**| A WhatsApp account is unshared or 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. |
204
+
|**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. |
205
+
|**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. |
206
+
|**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. |
207
+
|**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. |
208
+
|**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. |
209
+
|**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. |
210
+
196
211
## Next steps
197
212
198
213
This article described the prerequisite steps to configuring WhatsApp as a Channel in Microsoft Copilot Studio. Now you're ready add WhatsApp as a Channel in your AI agent in Microsoft Copilot Studio.
199
214
200
215
> [!div class="nextstepaction"]
201
216
> [Add bot to WhatsApp](https://review.learn.microsoft.com/en-us/microsoft-copilot-studio/publication-add-bot-to-whatsapp?branch=cc-whatsapp-405436)
0 commit comments