# SMS Settings

The SMS settings page allows you to customize fields to choose the SMS gateway, register your sender ID or contact number, and test your settings before using them for customers.

### 1. Choose your SMS API

<figure><img src="/files/i6yAbkhMcLnACZ9gY3D9" alt=""><figcaption></figcaption></figure>

* Select the SMS API gateway that you want to use to send SMS notifications.
* Enter the respective SMS API gateway's unique API key.
* Enter the name, which will be visible to your customers.

### API Key and API Secret Key

To enable SMS notifications, you must obtain an **API Key** and **API Secret Key** from your chosen SMS service provider. These credentials allow our system to securely authenticate and send messages on your behalf through the provider’s SMS gateway.

### **Where to Get the API Key and API Secret Key**

The **API Key** and **API Secret Key** are issued by your SMS service provider once you create an account with them. These credentials are typically available in the provider’s dashboard under sections such as:

* API Settings
* Developer Settings
* Integration
* Credentials

### **How to Get the API Key and Secret Key**

The process varies depending on the SMS service provider, but generally follows these steps:

1. Sign up or log in to your SMS service provider account.
2. Complete any required business verification or sender ID registration (if applicable).
3. Navigate to the API or Developer section of the dashboard.
4. Generate or copy the provided **API Key** and **API Secret Key**.
5. Enter these credentials in the corresponding fields within the app settings.

{% hint style="info" %}

### **Important Notes**&#x20;

* The steps to generate or locate the API credentials are **different for each SMS service provider**.
* Some providers may require you to:
  * Enable API access
  * Whitelist IP addresses
  * Activate a specific SMS plan
* Always refer to your SMS provider’s **official help documentation** for exact instructions.
  {% endhint %}

Please refer to the official documentation of your selected SMS provider.

* **Twilio**\
  <https://www.twilio.com/docs/messaging>
* **MSG91**\
  <https://docs.msg91.com/sms/send-sms>
* **SMS Country**\
  <https://www.smscountry.com/in/support>
* **Priority SMS**\
  <https://prioritysms.com/transactional-sms>
* **Textlocal**\
  API documentation is not publicly available. Please contact Textlocal support for API credentials.
* **Gupshup SMS**\
  <https://www.gupshup.ai/resources/blog/what-is-sms-api/>
* **2Factor SMS**\
  <https://2factor.in/v3/bulk-sms-service-features>
* **Dial4SMS**\
  <https://dial4sms.com/services/bulk-sms-in-chennai/>
* **SMSeg**\
  <https://smseg.com/sender-id/>
* **SMS Gateway**\
  <https://sms.to/gateway/>
* **Jayine Group**\
  <https://www.jayinegroup.com/services>
* **Metamorph Systems SMS**\
  <https://metamorphsystems.com/index.php/sms/bulksms.html>
* **Cequens**\
  <https://www.cequens.com/products/sms-api>
* **Libya SMS**\
  <https://docs.libyasms.com/1_sendsms>
* **Alpha SMS**\
  <https://alphasms.net/about/techdocs/>
* **Spring Edge**\
  <https://www.springedge.com/transactional-messaging.html>
* **SMS Gateway Hub**\
  <https://www.smsgatewayhub.com/way2sendsms_updated.pdf>
* **Fast2SMS**\
  <https://www.fast2sms.com/help/>
* **Zaman It SMS**\
  <https://zaman-it.com/sms-api/>

### 2. Test Your SMS Gateway

This is the step that allows you to test your SMS API gateway.

<figure><img src="/files/jiEiQf0LJj5ZVugplUvI" alt=""><figcaption></figcaption></figure>

* **Test Number -** Enter the contact number that you want to use to send the test SMS.
* **Test Message Body -** Configure a test message that you want to send.

<figure><img src="/files/bSWIMee2zB8mKrFSaSoc" alt=""><figcaption></figcaption></figure>

### 3. Admin Notification Contact Detail

<figure><img src="/files/30vcTvitKKAffKniUhb3" alt=""><figcaption></figcaption></figure>

* Enter the contact number through which you want to send the notifications to your customers.&#x20;

### <mark style="color:blue;">Bonus #1 - Send SMS for individual order manually</mark>

Apart from all those SMS settings configurations, you can also send SMS for an individual order manually.

For that, go to **Orders** ➤ **Select an order** ➤ **Select "More actions"** ➤ **Select "Send Custom Message"**

<figure><img src="/files/OHPP7opDL64oNHAsmPfs" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://magecomp.gitbook.io/shopify/apps/okuru-order-sms/sms-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.