Skip to content
This repository has been archived by the owner on Jun 27, 2024. It is now read-only.

Commit

Permalink
GITBOOK-1229: update WhatsApp Integration
Browse files Browse the repository at this point in the history
  • Loading branch information
Funke Olasupo authored and gitbook-bot committed Jan 18, 2024
1 parent f94b125 commit a6715b7
Show file tree
Hide file tree
Showing 5 changed files with 44 additions and 55 deletions.
2 changes: 1 addition & 1 deletion SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -139,6 +139,7 @@
* [Channel Apps](omnichannel/developing-omnichannel-apps/channel-apps.md)
* [Chatbots](omnichannel/developing-omnichannel-apps/chatbots.md)
* [CRM Apps](omnichannel/developing-omnichannel-apps/crm-apps.md)
* [WhatsApp Business Omnichannel Integration](omnichannel/whatsapp-omnichannel-integration-api.md)

## Bots

Expand Down Expand Up @@ -732,7 +733,6 @@
* [Confirm Enterprise License](reference/api/rest-api/endpoints/miscellaneous/licenses/confirm-enterprise-license.md)
* [Get Maximum Active User](reference/api/rest-api/endpoints/miscellaneous/licenses/get-maximum-active-user.md)
* [WhatsApp Endpoints](reference/api/rest-api/endpoints/miscellaneous/whatsapp-endpoints/README.md)
* [WhatsApp omnichannel integration API](reference/api/rest-api/endpoints/miscellaneous/whatsapp-endpoints/whatsapp-omnichannel-integration-api.md)
* [Send a Template WhatsApp Message](reference/api/rest-api/endpoints/miscellaneous/whatsapp-endpoints/send-a-template-whatsapp-message.md)
* [Video Conference Endpoints](reference/api/rest-api/endpoints/miscellaneous/video-conference-endpoints/README.md)
* [Update Jitsi Timeout](reference/api/rest-api/endpoints/miscellaneous/video-conference-endpoints/jitsi-update-timeout.md)
Expand Down
39 changes: 39 additions & 0 deletions omnichannel/whatsapp-omnichannel-integration-api.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
description: WhatsApp Business Integration for Rocket.Chat
---

# WhatsApp Business Omnichannel Integration

Integrating Whatsapp business in your Rocket.Chat workspace offers valuable enhancements to simplify your business communication workflows. The [Whatsapp business integration](https://docs.rocket.chat/extend-rocket.chat-capabilities/rocket.chat-marketplace/rocket.chat-public-apps-guides/omnichannel-apps/whatsapp-cloud-app) allows you to send template messages to a targeted user.

You can send a Whatsapp template message from your workspace via the following methods:

1. **Sending template messages via endpoints**: Refer to the [Send a Template WhatsApp Message](../reference/api/rest-api/endpoints/miscellaneous/whatsapp-endpoints/send-a-template-whatsapp-message.md) API endpoint.
2. **Slash commands and UI**: Send the template message in a more user-friendly way using the GUI form. To trigger the GUI, open a WhatsApp contact room and run the `/whatsapp send-template`command. This command opens up a modal where you can select the following:

* The `Template` you wish to send,
* The `Language` you wish to send the template in,
* And also substitute `parameters` within the message, if present

{% hint style="info" %}
If parameters are present within the template message, kindly ensure you substitute all of them before sending the message. Failure to do so will result in an error.
{% endhint %}

**Getting the status of messages sent**

To receive real-time status updates for outbound messages, navigate to the **Settings** tab of the Whatsapp App and set the _**Message Status Endpoint URL**_. The app sends a request to this URL each time your message status changes to one of the following: **queued**, **failed**, **sent**, **delivered**, **read**, or if some error occurs.

The table below highlights the payload format you will receive on the endpoint.

| **Field Name** | **Type** | **Description** |
| :-----------------: | :------------------------------------------------------: | :------------------------------------------------------------------------: |
| msId | String or undefined | Message Id. |
| message | String | Text message |
| mobileNo | String | Phone number of WhatsApp user to which you had sent the message |
| connectedWhatsAppNo | String | Your connected WhatsApp Number from which you had sent the message to user |
| MessageStatus | String | Status of message - sent, delivered, read, failed, deleted |
| ErrorDetails | <p>Optional<br>Type: String or WhatsApp error format</p> | Errors from template messages will be shown here |
| type | String | `Template-Message` or `Regular-Message` |
| timestamp | String | Timestamp of request |

In conclusion, the ability to send template messages through WhatsApp Business Integration enables businesses to maintain a consistent and professional communication approach with their audience.&#x20;
2 changes: 1 addition & 1 deletion reference/api/rest-api/endpoints/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -863,7 +863,7 @@ You can get and update the settings via the REST API, only if you have permissio

### WhatsApp

<table><thead><tr><th width="308.5">Description</th><th>Details Page</th></tr></thead><tbody><tr><td>WhatsApp Business API integration for Rocket.Chat</td><td><a href="miscellaneous/whatsapp-endpoints/whatsapp-omnichannel-integration-api.md">Link</a></td></tr><tr><td>Send a template message.</td><td><a href="miscellaneous/whatsapp-endpoints/send-a-template-whatsapp-message.md">Link</a></td></tr></tbody></table>
<table><thead><tr><th width="308.5">Description</th><th>Details Page</th></tr></thead><tbody><tr><td>WhatsApp Business API integration for Rocket.Chat</td><td><a href="../../../../omnichannel/whatsapp-omnichannel-integration-api.md">Link</a></td></tr><tr><td>Send a template message.</td><td><a href="miscellaneous/whatsapp-endpoints/send-a-template-whatsapp-message.md">Link</a></td></tr></tbody></table>

### Mailer

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,6 @@

## WhatsApp

| Short Description | Details Page |
| ------------------------------------------------- | ----------------------------------------------- |
| WhatsApp Business API integration for Rocket.Chat | [Link](whatsapp-omnichannel-integration-api.md) |
| Send a template message. | [Link](send-a-template-whatsapp-message.md) |
| Short Description | Details Page |
| ------------------------ | ------------------------------------------- |
| Send a template message. | [Link](send-a-template-whatsapp-message.md) |

This file was deleted.

0 comments on commit a6715b7

Please sign in to comment.