Skip to content

Commit 5ac6999

Browse files
authored
Update with whatsapp status table whatsapp-channel-in-copilot-studio.md
1 parent 32dd4a0 commit 5ac6999

File tree

1 file changed

+31
-16
lines changed

1 file changed

+31
-16
lines changed

articles/communication-services/concepts/advanced-messaging/whatsapp/whatsapp-channel-in-copilot-studio.md

Lines changed: 31 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ This article covers the prerequisites to configuring WhatsApp as a Channel in Mi
2424
2. Get a phone number that can receive SMS.
2525
3. Setup and Deploy Event Grid Viewer
2626
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
2828

2929
The following video demonstrates this process.
3030

@@ -51,19 +51,17 @@ When following those instructions, here are helpful tips:
5151

5252
## Get a phone number
5353

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.
5556

5657
Make sure the phone number has the following capabilities:
5758

58-
1. Able to receive SMS
59+
1. Able to receive SMS so your phone number can be verified by Meta
5960
2. Phone number isn't already associated with a WhatsApp Business Account
6061

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-
6462
## Setup and Deploy Event Grid Viewer
6563

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.
6765

6866
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.
6967

@@ -83,15 +81,15 @@ The following steps are only needed if you chose to use a Toll-free number from
8381
4. After the deployment completes, select **Go to resource group**.
8482

8583
:::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.
8886

8987
:::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+
9189
6. On the resource overview page, select on the copy button next to the **Default Domain** property.
9290

9391
:::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+
9593
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.
9694

9795
:::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:
112110

113111
:::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.":::
114112

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
116114

117115
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.
118116

@@ -163,7 +161,7 @@ When following those instructions, here are helpful tips:
163161

164162
:::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.":::
165163

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.
167165

168166
Use the Azure Communication Service toll-free phone number you provisioned previously or bring your own phone number.
169167

@@ -187,20 +185,37 @@ When following those instructions, here are helpful tips:
187185

188186
The status of your WhatsApp Business account is displayed in the Azure portal. Once approved, you will see an **Active** status.
189187

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.":::
191189

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.
193191

194192
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).
195193

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.
199+
200+
| Status | Meaning | Suggested Action |
201+
|---------------------|----------------------|-----------------------|
202+
|**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+
196211
## Next steps
197212

198213
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.
199214

200215
> [!div class="nextstepaction"]
201216
> [Add bot to WhatsApp](https://review.learn.microsoft.com/en-us/microsoft-copilot-studio/publication-add-bot-to-whatsapp?branch=cc-whatsapp-405436)
202217
203-
Link needs to be updated.
218+
Link needs to be updated.
204219

205220
## Related articles
206221

0 commit comments

Comments
 (0)