> For the complete documentation index, see [llms.txt](https://whitepaper.aitech.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whitepaper.aitech.io/agentforge/tools/twilio_sms.md).

# twilio\_sms

[Twilio SMS](https://www.twilio.com/en-us/sms) is a powerful cloud communications platform that enables businesses to integrate messaging capabilities into their applications and services.

Twilio SMS provides a robust API for programmatically sending and receiving text messages globally. With coverage in over 180 countries and a 99.999% uptime SLA, Twilio has established itself as an industry leader in communications technology.

Key features of Twilio SMS include:

* **Global Reach**: Send messages to recipients worldwide with local phone numbers in multiple countries
* **Programmable Messaging**: Customize message delivery with webhooks, delivery receipts, and scheduling options
* **Advanced Analytics**: Track delivery rates, engagement metrics, and optimize your messaging campaigns

In Agent Forge, the Twilio SMS integration enables your agents to leverage these powerful messaging capabilities as part of their workflows. This creates opportunities for sophisticated customer engagement scenarios like appointment reminders, verification codes, alerts, and interactive conversations.

The integration bridges the gap between your AI workflows and customer communication channels, allowing your agents to deliver timely, relevant information directly to users' mobile devices.

By connecting Agent Forge with Twilio SMS, you can build intelligent agents that engage customers through their preferred communication channel, enhancing user experience while automating routine messaging tasks.

## Usage Instructions

Send text messages to single or multiple recipients using the Twilio API.

## Where to Get Your Twilio API Keys (Auth Token and Account SID)

You will need your **Account SID** and **Auth Token** to authenticate and use the Twilio SMS integration.

Here is the simple, step-by-step process to find them:

1. **Log in to Your Twilio Account:**\
   Navigate to the [Twilio website](https://www.twilio.com/) and sign in with your credentials.
2. **Access the Console Dashboard:**\
   Once logged in, you will be taken directly to your **Twilio Console Dashboard**.
3. **Locate Account Info:**\
   Look for the **"Account Info"** or **"Project Info"** section near the top of the dashboard.
4. **Copy the Credentials:**\
   Your two primary credentials will be displayed here:
   * **Account SID:** This is visible by default.
   * **Auth Token:** This is hidden by default for security. Click the **"eye" icon** to reveal the token and copy it.

{% hint style="warning" %}
The **Auth Token** is a secret credential. Treat it like a password. Do not share it publicly, and store it securely (e.g., in a `.env` file or in `Environment` in `Settings` in Agent Forge)
{% endhint %}

## Tools

### `twilio_send_sms`

Send text messages to single or multiple recipients using the Twilio API.

#### Input

| Parameter      | Type   | Required | Description                                                 |
| -------------- | ------ | -------- | ----------------------------------------------------------- |
| `phoneNumbers` | string | Yes      | Phone numbers to send the message to, separated by newlines |
| `message`      | string | Yes      | Message to send                                             |
| `accountSid`   | string | Yes      | Twilio Account SID                                          |
| `authToken`    | string | Yes      | Twilio Auth Token                                           |
| `fromNumber`   | string | Yes      | Twilio phone number to send the message from                |

#### Output

| Parameter   | Type    | Description         |
| ----------- | ------- | ------------------- |
| `success`   | boolean | Send success status |
| `messageId` | any     | Message identifier  |
| `status`    | any     | Delivery status     |
| `error`     | any     | Error information   |

## Notes

* Category: `tools`
* Type: `twilio_sms`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://whitepaper.aitech.io/agentforge/tools/twilio_sms.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.