> For the complete documentation index, see [llms.txt](https://ledsak.gitbook.io/docs-for-ledsak/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ledsak.gitbook.io/docs-for-ledsak/integrations/gallabox.md).

# GallaBox

## GallaBox Bulk WhatsAtpp Sending Guide

**Prerequisites**

Before integrating Gallabox with Ledsak, ensure you have the following:

* **Active Gallabox Account** – Sign up at [Gallabox](https://kw.gallabox.com/) if you don’t have one.
* **Ledsak Account** – Ensure your Ledsak account is active.
* **Gallabox Credentials** – You will need the following details from Gallabox:
  * Name
  * API Key
  * API Secret
  * Gallabox Account ID
  * Gallabox Channel ID

{% embed url="<https://youtu.be/vQe5tNnsG6g>" %}

### **Steps to Connect Gallabox to Ledsak**

#### **1. Retrieve Gallabox API Credentials**

1. Log in to your **Gallabox account**.
2. Navigate to **Settings > API Keys**.
3. Generate a new API Key if not available.
4. Copy the following details:
   * **API Key**
   * **API Secret**
   * **Account ID**
   * **Channel ID**

### Create an API Key in Gallabox <a href="#create-an-api-key-in-gallabox" id="create-an-api-key-in-gallabox"></a>

#### Add New Under API Keys <a href="#add-new-under-api-keys" id="add-new-under-api-keys"></a>

Go to **Settings** in the navigation panel and select **API keys**. Click on **+ Add new**.

{% embed url="<https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2FsNDDtZI0cKE0XWFaeh9h%2FAdd%20API%20Key.gif?alt=media&token=b8f26907-4d62-41bd-9fec-ab7dfc942cf1>" %}

#### Naming and providing permission <a href="#naming-and-providing-permission" id="naming-and-providing-permission"></a>

Provide a name to the **API** and select the permissions (All, Restricted, or Read only) for the API. Click on **Add API Key**.

{% embed url="<https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2FOOYdYBzC7xt3ixdOb9du%2FPermission%20for%20API%20Key.gif?alt=media&token=5515309c-8706-4c32-bc3d-8182ca8d678c>" %}

#### API Secret <a href="#api-secret" id="api-secret"></a>

The API Secret will be generated and you have to copy and paste it somewhere safe. You will find the **API Key ID** on the API Keys tab.

It's crucial to safely store your API Secret immediately as it's not retrievable after the initial display. Always access your API Key ID from the API Keys tab for future references.

{% embed url="<https://3137140735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcl3T6ePz95GpzjAeOLW%2Fuploads%2Fg9LXbuEK4XpBLyAgkEoh%2FAPI%20Secret.gif?alt=media&token=fde1df63-58c0-464e-90df-853fded8a548>" %}

#### WhatsApp Number and Account ID for Identification <a href="#whatsapp-number-and-account-id-for-identification" id="whatsapp-number-and-account-id-for-identification"></a>

Your WhatsApp phone number has an associated ID for identification and communication purposes.

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

**WhatsApp API Deployment Check:** Hover over the WhatsApp Number to inspect the associated WhatsApp API Deployment (*On-Premise* or *Cloud API)*.

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

**Gallabox Account ID: U**nique identifier (ID) linked to your account for identification and Gallabox communication purposes.

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

**Connected Status:** Monitor to stay informed about the operational status of your WhatsApp API.

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

#### **2. Configure Ledsak with Gallabox API**

1. Log in to your **Ledsak account**.
2. Go to **Integration Settings**.
3. Locate the option to **Connect WhatsApp API**.
4. Enter the following details:
   * **Name**: (Enter a friendly name for identification)
   * **API Key**: (Paste the API Key from Gallabox)
   * **API Secret**: (Paste the API Secret from Gallabox)
   * **Gallabox Account ID**: (Enter your Gallabox Account ID)
   * **Gallabox Channel ID**: (Enter your Gallabox Channel ID)
5. Click **Save & Connect**.

#### **3. Testing the Integration**

1. After connecting, send a **test message** from Ledsak.
2. Check the message delivery status in **Gallabox logs**.
3. If the message is successfully sent, the integration is complete.

#### **4. Using Gallabox for Bulk WhatsApp Messaging**

1. Import contacts from Ledsak into Gallabox.
2. Create a new **WhatsApp campaign**.
3. Select the imported contact list.
4. Design your message template and attach media if needed.
5. Schedule or send the messages immediately.
6. Monitor message performance through Gallabox analytics.

### **Troubleshooting & Support**

* If messages are not sent, verify API credentials.
* Ensure Gallabox’s API is active and accessible.
* Contact **Gallabox Support** if any integration issues arise.

By following these steps, you can successfully integrate Gallabox with Ledsak for bulk WhatsApp messaging, enhancing your communication strategy efficiently.

1. Integrate Gallabox.

{% embed url="<https://prnt.sc/nXOEkRw_72_2>" %}

2. &#x20;Fill the Gallabox credentials.

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

3. Mapped, Gallabox with ledsak (Use Case).

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