# RUM API

RUM Unofficial WhatsApp API for Developers allows you to connect your WhatsApp to RUM Work easily. It doesn't require approval from WhatsApp and only takes a few minutes to integrate both platforms. So, you don't have to wait to communicate with your customers on WhatsApp using the RUM Work platform.

Simply follow the below steps to create a RUM Work RUM Channel for WhatsApp.

{% hint style="success" %}
You can use either WhatsApp Business or Personal number to utilize the RUM Unofficial WhatsApp API.
{% endhint %}

## Step 1 - Create RUM Unofficial API Channel

Now, to connect RUM Unofficial WhatsApp API to RUM Work, you need to create a channel. This will allow you to communicate with customers over WhatsApp from RUM Work. To do that, first,&#x20;

* Login to RUM Work.&#x20;
* Then, go to **Channels**.&#x20;
* There, click **Configure** for the Whatsapp channel. Or you can click, *Create Channel* if there are already channels.

<figure><img src="https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FOnSWwb1GWJhxZfWRNmm6%2Fcreate%20Unoffical%20Channel.png?alt=media&#x26;token=243e9049-f21d-4e63-bc91-d8de55da1eb2" alt=""><figcaption></figcaption></figure>

Upon clicking the Configure button, a popup will appear asking for a few details to finish creating the channel.&#x20;

<figure><img src="https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FMqQKYYQh9A455WTi5yAj%2Funoffical_api_2.png?alt=media&#x26;token=e950d091-6bce-4fb2-8b91-f8b89c496f62" alt=""><figcaption></figcaption></figure>

The details are,

* Title = you can set the title as you want to recognise the channel.

Once you've got all the details, head back to RUM Work, and enter them where they're needed.

{% hint style="info" %}
You need to repeat the steps to copy and paste the details one by one, individually. First, for the Product ID, then Token, and in the end, Phone ID.
{% endhint %}

After entering all the details, you can click *Finish*, and that's it; you've created the RUM Unofficial WhatsApp API channel.&#x20;

<figure><img src="https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2Fx92PHn1sb6L0YDX53gPM%2Fcreated%20unofficial%20channel.png?alt=media&#x26;token=86326b12-2e74-480e-9920-be87852bb0cd" alt=""><figcaption><p>Created RUM Unofficial Channel</p></figcaption></figure>

However, it's not connected to the WhatsApp account you're using. So, for that, you need to follow a few more steps.&#x20;

* Click on the **Details** button on your channel.&#x20;

This will open the Phone Settings where you can see the WHATSAPP WEB banner.&#x20;

![QR Code to Connect WhatsAPP to RUM Work](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FnCj1QVtM2nNCRKvbWcg6%2FQR%20Code%20Window%20for%20Maytapi%20RUM%20Work%20Channel.png?alt=media\&token=99d57a82-fe65-435e-880d-90d48c319d1d)

You need to scan the code visible in the banner from your mobile application. Follow the below steps to learn how to scan a QR code in WhatsApp to use it on a computer.

1. Open WhatsApp → tap [**More options**](https://faq.whatsapp.com/android/troubleshooting/finding-the-more-options-icon)<img src="https://scontent.whatsapp.net/v/t39.8562-34/118117430_995065920932265_1336446442210986426_n.jpg?stp=cp0_dst-jpg_e10_p50x50&#x26;ccb=1-7&#x26;_nc_sid=8a74b9&#x26;_nc_ohc=TMWashz5jlwAX9N_zzW&#x26;_nc_ht=scontent.whatsapp.net&#x26;oh=01_AVyM8UTti6ExrcYyWJ1UIeWcBrQ2bIFVuj_BZmqe03-8wQ&#x26;oe=62C97BDF" alt="" data-size="line"> → **Settings**. The main settings of your WhatsApp application.
2. Tap the **QR** icon (top right corner) displayed next to your name.
3. Select **SCAN CODE**.
4. Hold your device over the QR code to scan.
5. An alert will appear, *Device login code detected*, select **CONTINUE**.
6. Click **LINK A DEVICE.**
7. And scan the code again to complete the linking.

After successfully linking your WhatsApp to RUM Work RUM API Channel, you'll be able to see your WhatsApp conversations.

![WhatsApp Web Screen in RUM Work](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2Frm7AK5b8C0h3whX8nLxj%2FWhatsApp%20Maytapi%20Channel%20Conversations%20in%20Rum%20Work.png?alt=media\&token=6ab1dff6-c6e5-40ec-8504-89eaadf53441)

And that's it; you've created a WhatsApp Channel in RUM Work using the RUM Unofficial WhatsApp API.

<figure><img src="https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FYKvP9PeZYlcAaM6DgkXW%2FConnected%20unofficial%20channel.png?alt=media&#x26;token=44a4b04c-6f38-4913-b7c6-bdd56dac00af" alt=""><figcaption></figcaption></figure>

You'll see the *Connected* status in your Channels window, ensuring you can now communicate with your customers through the RUM Work Chat interface.

### Channel Configuration

Utilise additional settings of the RUM API channel to optimize its use.

#### Phone Settings

The Phone Settings of the RUM API Channel lets you align the WhatsApp API correctly. To access it, go to **Details** on the channel.

<figure><img src="https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2F5GQhTDKM9ovwnbtt6d0c%2Fdetails%20unoffical%20channel.png?alt=media&#x26;token=a92872d2-b229-418c-91b2-338ce71797d1" alt=""><figcaption></figcaption></figure>

This will open the following window with the WhatsApp screen and other controls.

![](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FZKpAExoe2Zh5WRdp0RlB%2FPhone%20Settings%20of%20Maytapi%20Channel.png?alt=media\&token=c38f582b-7de6-48a0-a48b-e1c310a8f0f1)

Here, you can view the Channel ID and copy it using the Copy icon.&#x20;

![Phone Settings Other Controls](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FYQ4DHlWZgzQYO3a3OLUD%2FMaytapi%20Phone%20Settings%20Other%20Controls.png?alt=media\&token=0bf876de-f9e4-4126-a9b0-bfbd65cd3311)

Other controls let you perform actions as follows,&#x20;

* <img src="https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FN4SMg0QrU61J4ZCOq74v%2FRefresh%20API%20Connection%20Instance.png?alt=media&#x26;token=bee2e12a-7c50-4d15-84e8-72e63e4eba5c" alt="" data-size="line"> = **Restart API Instance**: Use it to Refresh the connectio&#x6E;**.**
* <img src="https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2Fc4hLRYBACxGiIkx7aqOz%2FSync%20Contacts.png?alt=media&#x26;token=b84ad708-5bd4-438f-9007-e02471ffa443" alt="" data-size="line"> = **Sync Contacts.**
* <img src="https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FrbJELeN3efbVQ152O7NU%2FSync%20Messages.png?alt=media&#x26;token=d3c6bb5e-57df-4d39-aba5-28b49f262340" alt="" data-size="line"> = **Sync Messages**.
* <img src="https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FEw3MvXYlkLT8d5cd9o0u%2FLogout.png?alt=media&#x26;token=e1d14622-eccf-466b-9e62-390c514e5011" alt="" data-size="line"> = **Logout**: Use it to log out from the current WhatsApp connection.
* <img src="https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FOAC2hTvroCSUtwfRE0GP%2FDelete%20the%20Channel.png?alt=media&#x26;token=684f22b0-1405-448d-944f-9cfb7bad350d" alt="" data-size="line"> = **Delete Channel**.

#### Store Settings

Through WhatsApp chat, if you want to process orders and payments, you can utilize the WhatsApp Store Settings. To access the controls, click on **Store Settings**.

![](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2Fm2GpYkqj5UyzavxlRpR1%2FWhatsApp%20Store%20Settings%20of%20Maytapi%20Channel%20through%20Store%20Settings.png?alt=media\&token=e9ed6683-1cd5-4468-a275-904d9c1c77e4)

This will open the following window with several fields and options.

![](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FR1T5sLpS7ubknuddUgzJ%2FWhatsApp%20Store%20Settings%20Page%20of%20Maytapi%20Channel.png?alt=media\&token=1110e852-7b7b-4844-b901-bb190b67ded6)

The options available are,

![](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FhkhCFOaGVSruOESQLACT%2FSelect%20Payment%20Partner%20Field%20in%20Maytapi%20Channel.png?alt=media\&token=9b047d86-2eba-4968-bf4f-69a364d33de6)

* **Select Payment Partner** - This allows you to choose the payment processor.&#x20;

![](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FqdTxw80bhT2NfDcVroJf%2FSelect%20Default%20Currency%20in%20Maytapi%20Channel.png?alt=media\&token=0689a1cd-328c-4918-a108-d19883f00278)

* **Select Default Currency** - What currency do you want to charge your customers: *USD or HKD*.

![](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FxuDF0jfFn4M21s7vQVPA%2FTest%20Mode%20and%20Live%20Mode%20for%20the%20Maytapi%20Channel.png?alt=media\&token=6b87c644-f633-4607-a40f-7a64133cffb9)

* **Test Mode or Live Mode** - The payment processor offers Live and Test Mode keys. Using this option, you can put the store on either Live or Test mode. If you're testing the payment processor, use the Test mode and its keys. Otherwise, choose the Live Mode.

![](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FbfydgRQjGqWFtby8sbxd%2FStripe%20Publish%20and%20Secrect%20Key%20Fields.png?alt=media\&token=3ed90863-aafa-4e10-9f59-de05b81781f8)

* **Stripe Publish Key** - Use it to enter your Stripe Publish Key based on the mode. Get it [here](https://dashboard.stripe.com/apikeys).
* **Stripe Secret Key** - Use it to enter Stripe Secret Key based on the mode. Get it [here](https://dashboard.stripe.com/apikeys).

![](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FeztH4kaXfQKGz4T1B82o%2FYedpay%20Store%20and%20Access%20Token%20Fields.png?alt=media\&token=4fd9734a-a84a-450b-ba63-e96042c18cbd)

If you've selected Yedpay as your Payment Partner, you'll get the following fields:

* **Yedpay Store ID** - Use it to enter your Yedpay Store ID based on the mode. Get your Yedpay Store ID [here](https://merchant.yedpay.com/admin/stores).
* **Yedpay Access Token** - Use it to enter your Yedpay Access Token based on the mode. Get your Yedpay Access Token [here](https://merchant.yedpay.com/user/my-personal-token).

![](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FwMv4nHornQnY50WL8t23%2FMpay%20Fields%20for%20Maytapi%20Channel.png?alt=media\&token=03438627-59cf-4ae4-8457-cdf79c999fc4)

If you've selected Mpay as your Payment Partner, you'll get the following fields:

* **Select Language** - In what language do you want to enter Mpay details: English/Traditional Chinese/Simplified Chinese.
* **Mpay Merchant ID** - Based on the mode, enter your Merchant ID.&#x20;
* **Mpay Terminal ID** - Based on the mode, enter your Terminal ID.
* **Mpay Secure ID** - Based on the mode, enter your Secure ID.

![](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2F4OYlj4ZJfAi6dhHpUL5G%2FPayment%20Status%20Message%20Fields%20for%20Maytapi%20Channel.png?alt=media\&token=9ccd54d2-24d1-4982-b513-29cd3cf5540a)

* **Payment Success Message**.
* **Payment Failed Message**.
* **Payment Default Message**.

Use the above fields to send customers pre-defined messages based on the payment status.

![](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FOSY5lyNeoptNSbOOQazY%2FSaving%20WhatsApp%20Store%20Settings%20in%20Maytapi%20Channel.png?alt=media\&token=9f7958b5-6006-42e9-be5f-9574093337ec)

Once you're done with the customization, click **Save Payment Settings**.

#### Manage Templates

Different customers often reach out with the same queries, and answering them repeatedly could become overwhelming. Therefore, create Message Templates, and when customers reach out, simply use them.

To create your message templates, click on **Manage Templates**.

![](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FkaXQYiZiUzVz3pq2E9os%2FOpening%20Manage%20Templates%20in%20Maytapi%20Channel.png?alt=media\&token=547643dd-61a0-4c0b-b6fe-04e29907148d)

A new window will appear with a **Create Message Template** button.

![](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2Fhnku9D5w3cYmG3sOQQUg%2FCreating%20a%20Message%20Template%20in%20Maytapi%20Channel.png?alt=media\&token=995fd8c1-8862-41da-86d1-386d8f9a4f69)

Simply click on it and it will bring a popup to create the template.&#x20;

![](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2F2GePqU089yL7ZoIAJJMK%2FCreate%20Message%20Templates%20Popup%20in%20Maytapi%20Channel.png?alt=media\&token=0601f457-7e88-4f07-bbac-7395df5348d9)

Here, name your template. Insert placeholders to personalise the message. Edit the message or fill the text around placeholders. Use a File, and even provide customers with an option to unsubscribe.

![](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FUL6vuNKigoJ1x0PaJqg1%2FMessage%20Templates%20Library%20in%20Maytapi%20Channel%20for%20WhatsApp.png?alt=media\&token=c9b9872c-1f8d-4054-b21a-6049411c96de)

Once done with the template, click Save, and it will be shown to the message templates library.

#### More Options

In addition to the [Phone Settings](#phone-settings), [Store Settings](#store-settings) and [Message Templates](#manage-templates) there are a few more options you can utilise.

![](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FPwUAKMB3e4WVQQkcLJNq%2FMaytapi%20Channel%20More%20Options.png?alt=media\&token=7dd19682-7980-44c1-8f20-54570afbaa3e)

* **Edit** - It provides you with the option to change Channel Name; Add Webhook URL and  Disconnection Alert Emails.&#x20;

![](https://1755261872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhElFPtMZjXYjDDMBT5q2%2Fuploads%2FBV9bk3c5C0Zd65MLnG18%2FEdit%20option%20of%20the%20Maytapi%20Channel.png?alt=media\&token=58247f1e-1fd9-49b5-9785-aaaca53b9def)

* **Delete** - Simply delete the channel.
* **Mark as Default** - You'll see this particular channel as the primary channel in the Chat.
* **Copy Channel ID** - Copy Channel ID without opening the Phone Settings.
