Twilio
Integration version: 12.0
Configure Twilio to work with Google Security Operations SOAR
Log into your Twilio account.
In the Twilio Console, navigate to the Settings > API Keys.
Select Create new API Key and choose to create either Standard or Master API Key.
You will find your Account SID and API Credentials containing Auth Token in the Settings > General.
Configure Twilio integration in Google Security Operations SOAR
For detailed instructions on how to configure an integration in Google Security Operations SOAR, see Configure integrations.
Integration parameters
Use the following parameters to configure the integration:
| Parameter Display Name | Type | Default Value | Is Mandatory | Description |
|---|---|---|---|---|
| Instance Name | String | N/A | No | Name of the Instance you intend to configure integration for. |
| Description | String | N/A | No | Description of the Instance. |
| Account sid | String | N/A | Yes | The ID of your Twilio Account. |
| Authentication token | String | N/A | Yes | Twilio token used for authentication. |
| SMS phone number | String | N/A | Yes | Your Twilio phone number that can be generated in the Twilio console. |
| Run Remotely | Checkbox | Unchecked | No | Check the field in order to run the configured integration remotely. Once checked, the option appears to select the remote user (agent). |
Actions
Ping
Description
Verify that the user has a connection to Twilio via the user's device.
Parameters
N/A
Run On
This action runs on all entities.
Action Results
Script Result
If the connection is established, Script result will be True. Else: False.
JSON Result
N/A
Send SMS
Description
By using Twilio's REST API, outgoing SMS messages can be sent from specific Twilio phone numbers to mobile phones worldwide. If multiple messages are sent at once from a single Twilio sender (number or Alphanumeric Sender ID), Twilio will queue them up for delivery.
Parameters
| Parameter Display Name | Type | Default Value | Is Mandatory | Description |
|---|---|---|---|---|
| Phone Number | String | N/A | Yes | Target phone number.The phone number must include a dial code. |
| Message | String | Testing | Yes | Message content. |
Run On
This action runs on all entities.
Action Results
Script Result
| Script Result Name | Value Options | Example |
|---|---|---|
| is_success | True/False | is_success:False |
JSON Result
N/A
Send SMS and Wait
Description
The message will be sent with a generated Google Security Operations SOAR ID: <code>.
The action will wait for a response containing Google Security Operations SOAR ID:
<code>. This action has the role of sending SMS and waiting for a response to
a previously sent SMS message. This action also enables multiple send/wait for
reply actions within a single trigger allowing constructing automated SMS text
conversations and performing different actions based on the reply results.
Parameters
| Parameter Display Name | Type | Default Value | Is Mandatory | Description |
|---|---|---|---|---|
| Phone Number | String | N/A | Yes | Target phone number. The phone number must include a dial code. |
| Message | String | N/A | Yes | Message content. |
Run On
This action runs on all entities.
Action Results
Script Result
| Script Result Name | Value Options | Example |
|---|---|---|
| is_success | True/False | is_success:False |
JSON Result
N/A