# Connecting Twilio Numbers

This guide will walk through how to connect a Twilio Number to Airkit and be used as a Voice or SMS Resource. This enables the ability to leverage the Voice and SMS capabilities within the platform, such as sending an SMS to update a user or having a Journey get triggered by an inbound call.&#x20;

**Prerequisites:**

1. Access to a Twilio Account
2. Have an available number with the desired functionality associated with the Twilio Account. For more on how to do this, see [Twilio's documentation](https://support.twilio.com/hc/en-us/articles/223135247-How-to-Search-for-and-Buy-a-Twilio-Phone-Number-from-Console).

### Setting up the integration in the Console

To connect Twilio with an Airkit application, follow these steps:

1. Once in the [Console](../console/console), go on **Integrations > Connected Accounts** and click on **Create new**
2. Name the integration and from **Integration** select Twilio.

![](https://2599974655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIRF6etABDVMr59RdpyGw%2Fuploads%2Fgit-blob-ce8812e546406a230d1866028d3cbfa51b1b47f5%2Fconnecting-twilio-numbers-v184-0.png?alt=media)

3. Since the Username and Password are from Twilio, go to your Twilio account and copy the Account SID and an Auth Token from the dashboard:

* **Username** = Account SID
* **Password** = Auth Token\
  \[block:callout] { "type": "warning", "body": "The username and password declared here **must** correspond to your Account SID and Auth Token respectively. Failure to do so will not always be caught by the system at the time of creation, which will cause unintended behavior downstream." } \[/block]

### Set up the phone number as a Resource

1. In the Console, go to **Resources** and click on **Create new**.
2. Add a name to describe the Resource and, in **Capabilities**, select **Send Text Message** to set up a way to process SMS messages or **Send Voice** to process phone calls.

\[block:callout] { "type": "info", "body": "Many Twilio Numbers are capable of processing **both** phone calls and incoming SMS messages. In such cases, select the capability that you intend to use it for primarily." } \[/block]

![](https://2599974655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIRF6etABDVMr59RdpyGw%2Fuploads%2Fgit-blob-31a1e0bd5161d7f3da7f470e1d5ac25eca1b5b31%2Fconnecting-twilio-numbers-v184-1.png?alt=media)

3. In **Datasource**, select the connected account that was created in the previous step.
4. Under **Remote ID**, select the Twilio number that you want to associate with your app.
5. Click the **Create** button on the bottom right.

### Setting up the SMS Resource in your app

1. Open the relevant application in the Studio, go to **Settings** and scroll down to **Chat Bot.** Then select the SMS Resource that was created in the previous step. It should show up as the name previously provided.

![](https://2599974655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIRF6etABDVMr59RdpyGw%2Fuploads%2Fgit-blob-e1d90e887b5f70608fdacf2fbf97a39fbbaa63ae%2Fconnecting-twilio-numbers-v184-2.png?alt=media)

The app will now send SMS messages through the number provided.

### Setting up a Voice Resource in your app

This section will cover how to set up a phone number to be used via voice

1. Once inside the app, go to **Settings** and scroll down to **Voice Bot.** Then select the Voice Resource that was created in the previous step. It should show up as the name previously provided.

![](https://2599974655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIRF6etABDVMr59RdpyGw%2Fuploads%2Fgit-blob-72c265f42c7adbe40a5de6559491f094b223d102%2Fconnecting-twilio-numbers-v184-3.png?alt=media)

The app will now use the phone number to send and receive calls.
