> ## Documentation Index
> Fetch the complete documentation index at: https://onextel-09023014.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Zoho CRM- WA and RCS

This guide walks you through installing the OneXtel app in Zoho CRM and configuring it so your agents can send and receive RCS and WhatsApp messages directly from CRM records and workflows.<br />**Step 1: Install the OneXtel Application**

Install the OneXtel application from the Zoho CRM Marketplace.

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=780a311709538fc8a2a49375899f8d4f" alt="Image" width="936" height="480" data-path="images/image.png" />

## **Step 2: Configure DLR and Inbound Callbacks**

### **WhatsApp Callback Configuration**

1. Copy the callback URLs generated for **WhatsApp Inbound Callback** and **WhatsApp DLR Callback**.
2. Add these URLs in the OneXtel portal, under the API key you are using.
3. Configure the **WhatsApp DLR URL** as the callback for all three notification types:

○      Delivery Notification

○      URL Click

○      Button Click

4. Add the **WhatsApp Inbound URL** under the "Incoming" type in the OneXtel portal.

**Note:** Incoming callbacks cannot be configured per API key — this is an account-level configuration. All callback formats must be set to **Meta**.

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-1.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=2d84d3694addaccf2e2d9d6ee058471c" alt="Image" width="936" height="488" data-path="images/image-1.png" />

### **RCS Callback Configuration**

1. Copy the callback URLs generated for **RCS Inbound Callback** and **RCS DLR Callback**.
2. Add these URLs in the OneXtel portal, under the API key you are using.
3. Configure the **RCS DLR URL** as the callback for all three notification types:

○      Delivery Notification

○      URL Click

○      Button Click

4. Add the **RCS Inbound URL** under the "Incoming" type in the OneXtel portal.

**Note:** Incoming callbacks cannot be configured per API key — this is an account-level configuration. All callback formats must be set to **RCS**.

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-2.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=9890fc9e6d5bf6d9949933ed107cc8d9" alt="Image" width="852" height="482" data-path="images/image-2.png" />

**Step 3: Account Configuration**

### **WhatsApp Account Setup**

1. Go to the **OneXtel WhatsApp Account** custom module and click **Create OneXtel WhatsApp Account**.
2. Provide the following account details:

○      OneXtel WhatsApp Account Name

○      WhatsApp Sender ID

○      WhatsApp API Key

○      WABA ID

○      Account Type (OnexAura or OnexGlobal)

Make sure the API key you add here has its callback URLs already configured as described in Step 2.

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-5.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=cfb6298ffdcd9c2a87f0d2f9f968bb46" alt="Image" width="936" height="466" data-path="images/image-5.png" />

\*\* RCS Account Setup\*\*

1. Go to the CRM dashboard and open the **OneXtel** module.
2. Locate the custom module named **OneXtel RCS Account** and click **Create OneXtel RCS Account**.
3. Provide the following account details:

○      OneXtel RCS Account Name

○      RCS Sender Profile

○      RCS API Key

○      RCS Message Type

○      Account Type (OnexAura or OnexGlobal)

4. Click **Save**.

Make sure the API key you add here has its callback URLs already configured as described in Step 2.

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-6.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=a793bd3f679debf3d6aaa66a5e5f6aa7" alt="Image" width="936" height="482" data-path="images/image-6.png" />

## **Step 4: Send Messages**

Messages can be sent from the following supported modules: **Contacts**, **Accounts**, and **Leads** — either on a per-record basis or through automated workflows.

**Send WhatsApp Message (Record Basis)**

1. Open any record in a supported module (Leads/Contacts/Accounts).
2. Click **Send OneXtel WhatsApp** at the top right of the record.
3. In the panel that opens:

○      Select the phone number field from the module data.

○      Select the configured WhatsApp account.

○      Choose either a **Free Form Message** or a **Templated Message**.

○      Map the media URL (if applicable) and map variables to module data. If a module field is empty, enter the value manually in the **Manual Fallback** field.

4. Click **Send**.

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-8.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=65055b77f3a5032fdabd0d1d0ac389cc" alt="Image" width="936" height="482" data-path="images/image-8.png" />

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-9.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=09b74196b3e1f62c72106fa687cb9a23" alt="Image" width="936" height="482" data-path="images/image-9.png" />

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-10.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=bbebadb41a331620bc167479a803f549" alt="Image" width="936" height="484" data-path="images/image-10.png" />

### <br />**Send WhatsApp Message (Workflow Basis)**

1. Go to **Zoho CRM Dashboard > Settings > Automation > Workflow Rules > Create Rule**.
2. Select the module for which you want to send WhatsApp messages, and provide a rule name and description.
3. Set the execution point based on the record action, and configure conditions as needed.
4. Add action: **Instant Action > Custom Action > SendOnextelWhatsApp**.
5. Configure the phone field, account, and Free Form/Template message — same as the record-basis setup — and add fallback values to prevent message failure if a mapped field is empty or undefined at execution.
6. Click **Save**. The message will be sent automatically according to the workflow configuration.

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-11.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=fa261a36b74d7d7007e9487686ccd92a" alt="Image" width="936" height="430" data-path="images/image-11.png" />

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-12.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=10b3a017ab8c78e330161ea04e2d0607" alt="Image" width="936" height="480" data-path="images/image-12.png" />

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-13.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=10941751a528a575d5dbbef1c76dcca4" alt="Image" width="936" height="484" data-path="images/image-13.png" />

<br />**Send RCS Message (Record Basis)**

1. Open any record in a supported module (Leads/Contacts/Accounts).
2. Click **Send OneXtel RCS** at the top right of the record.
3. In the panel that opens:

○      Select the phone number field from the module data.

○      Select the configured RCS account.

○      Map the message variables to module data. If a module field is empty, enter the value manually in the **Manual Fallback** field.

4. Click **Send**.

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-14.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=47038e01c4d4bfb75f16afeb93496fa9" alt="Image" width="936" height="486" data-path="images/image-14.png" />

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-15.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=68374a0bc9eac20b531a95f4bf2c0a77" alt="Image" width="936" height="482" data-path="images/image-15.png" />

**Send RCS Message (Workflow Basis)**

1. Go to **Zoho CRM Dashboard > Settings > Automation > Workflow Rules > Create Rules**.
2. Select the module for which you want to send RCS messages, and provide a rule name and description.
3. Set the execution point based on the record action, and configure conditions as needed.
4. Add action: **Instant Action > Custom Action > SendOnextelRCS**.
5. Configure the phone field, account, and template — same as the record-basis setup — and add fallback values to prevent message failure if a mapped field is empty or undefined at execution.
6. Click **Save**.

The message will be sent automatically according to the workflow configuration.

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-16.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=f11fb0cfe7b460a7d17740918dddd3c5" alt="Image" width="936" height="482" data-path="images/image-16.png" />

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-17.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=e0c054cbcebf34c2bd1043803d977d3b" alt="Image" width="936" height="442" data-path="images/image-17.png" />

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-18.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=f7c3d6dc9a198e8929d64cce49fd9b75" alt="Image" width="936" height="484" data-path="images/image-18.png" />

 **Step 5: DLR Reports**

All messages sent via RCS and WhatsApp — whether triggered on a record basis or through a workflow — are logged in the **OneXtel RCS Report** and **OneXtel WhatsApp Report** modules, along with their status (Sent, Failed, Delivered, or Read).

Each entry can be previewed using the **Preview Message** button at the top right of the report.

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-21.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=29fe76e57ce3a73eaca4da44d2b3db7f" alt="Image" width="936" height="482" data-path="images/image-21.png" />

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-20.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=39071cacd2b373144be851c1b0b4084b" alt="Image" width="936" height="486" data-path="images/image-20.png" />

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-19.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=d66e6d027ab31181a8b2ab94e0f946f5" alt="Image" width="936" height="484" data-path="images/image-19.png" />

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-22.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=f17a0abcd37e75aaa9282a3c8425ac4b" alt="Image" width="936" height="488" data-path="images/image-22.png" />

## **Step 6: Inbound Message Reports**

Inbound messages received via RCS and WhatsApp are also logged in the **OneXtel RCS Report** and **OneXtel WhatsApp Report** modules, with a preview option available for each message.<br />

<img src="https://mintcdn.com/onextel-09023014/sPy2-pAb9S5r28t9/images/image-23.png?fit=max&auto=format&n=sPy2-pAb9S5r28t9&q=85&s=1c089c42966f6eb3f8b6f6038e2a8b01" alt="Image" width="936" height="484" data-path="images/image-23.png" />

 


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.