# SMS Broadcast

### What is SMS Broadcast?

SMS Broadcast allows you to send messages or automated flows to multiple users at once. This feature helps streamline communication, automate engagement, and scale outreach without manual effort.

***

### Benefits of SMS Broadcast

* 🚀 Enables bulk communication at scale without repetitive manual effort.
* 💬 Supports both single messages and automated chatbot flows for dynamic outreach.
* 🎯 Allows targeted broadcasting using CSV, Segments, or Google Sheets.
* 🛠️ Enhances operational efficiency through automation and scheduling.
* 📊 Provides real-time broadcast status and performance metrics for optimization.

***

### How to Use SMS Broadcast

1. Log in to the BotPenguin Application and select the SMS bot you want to use for broadcasting.
2. Select “Broadcast" from the expanded menu.

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

Here, you can view existing broadcasts along with:

* Broadcast Name
  * Contacts Count
  * Sent vs Failed Metrics
  * Date and Time
  * Status *(Completed / Scheduled / Ongoing)*

Available actions include:

* Single or bulk deletion
  * Searching broadcasts through the table search bar

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

No Broadcast exists:

1. Give your Broadcast a name&#x20;
2. Click on Continue Button.

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

***

#### Configuring Broadcast Details

5. Enter the following broadcast details:

* Broadcast Name
* Broadcast Type
  * Using CSV
  * Using Segment
  * Using Google Sheets
* Delivery Content
  * Message *(single text message)*
  * Flow *(sends configured chatbot flow instead of a single message)*

6. Choose the sending schedule:

* Send Now
* Send Later *(requires date and time selection)*

***

#### Audience Selection Methods

**Broadcast Using CSV**

7. In the **Manage Audience** section, select **“Using CSV.”**

You will see:

* **Select CSV File** upload option
* **Add to Contacts** toggle *(adds imported users into CRM)*

8. Click **“Select CSV File”** and upload the correctly formatted CSV.

To download a sample template, click **“Click here to download sample file.”**

**Required CSV Columns:**

| Required Columns      | Notes                                         |
| --------------------- | --------------------------------------------- |
| Status                | Mandatory                                     |
| Name                  | Mandatory                                     |
| Email                 | Mandatory                                     |
| Phone Dial Code       | Mandatory                                     |
| Phone Number          | Mandatory                                     |
| Tag                   | Mandatory                                     |
| Additional Attributes | Must exactly match BotPenguin attribute names |

9. Once uploaded, click **“Create Broadcast.”**

***

**Broadcast Using Segment**

10. In the **Manage Audience** section, select **“Using Segment.”**

Segments are pre-built groups created inside the inbox based on user attributes such as:

* Contact tags
* Chatbot associations
* Status filters
* Past user activity

Select one or more segments from the dropdown.

11. Click **“Create Broadcast.”**

***

**Broadcast Using Google Sheets**

12. In the **Manage Audience** section, select **“Using Google Sheets.”** If Google Sheets is not connected, you will see a **“Connect Google Sheets”** button.
13. After integration, select the sheet to use for broadcasting.

Optional: Enable **“Add to Contacts”** to sync sheet contacts to CRM.

14. Click **“Create Broadcast.”**

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

🎉 And congratulations, you have successfully completed created a Broadcast on BotPenguin SMS Chatbot! You're one step closer to mastering BotPenguin.

***

### SMS Broadcast FAQs

<details>

<summary>Can I schedule a broadcast for a future date?</summary>

Yes. While configuring the broadcast, select **“Send Later”** and specify the preferred date and time for the broadcast delivery.

</details>

<details>

<summary>Do CSV column names need to match exactly?</summary>

Yes. All required column names and any custom attribute names must match exactly as defined inside BotPenguin. Incorrect naming will prevent data mapping.

</details>

<details>

<summary>Can I edit a broadcast after it is created?</summary>

No. Broadcasts cannot be edited once created. If a correction is needed, a new broadcast must be created.

</details>

<details>

<summary>What happens if a phone number is invalid?</summary>

Messages sent to invalid numbers will fail automatically and will appear under the **Failed Count** in the broadcast summary.

</details>

<details>

<summary>Does “Add to Contacts” automatically store imported users?</summary>

Yes. When enabled, all users included in the audience source (CSV or Google Sheets) will be automatically added to your CRM and inbox.

</details>

<details>

<summary>Can I send a chatbot flow instead of a single text message?</summary>

Yes. When selecting the broadcast format, choose **Flow** to send a pre-configured SMS bot conversational flow instead of a single static message.

</details>

<details>

<summary>Can I use multiple audience sources in a single broadcast?</summary>

No. Each broadcast supports **one audience method** only — CSV, Segment, or Google Sheets.

</details>

<details>

<summary>Will my broadcast retry messages that failed?</summary>

No. Failed numbers will not be retried automatically. You will need to initiate a new broadcast if required.

</details>

<details>

<summary>Can I delete multiple broadcasts at once?</summary>

Yes. Use the multi-select option in the broadcast list to delete several broadcasts simultaneously.

</details>

If you still have questions for our team, write to us at [**support@botpenguin.com**](mailto:support@botpenguin.com). We’ll get back to you within 48 hours.


---

# 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://help.botpenguin.com/bots/sms-bot/sms-automation/sms-broadcast.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.