Twilio

Integration version: 13.0

Configure Twilio to work with Google Security Operations SOAR

  1. Log into your Twilio account.

  2. In the Twilio Console, navigate to the Settings > API Keys.

  3. Select Create new API Key and choose to create either Standard or Master API Key.

  4. 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