Twilio SMS
19 min
the twilio sms connector enables automated communication through sms and voice calls, leveraging twilio's robust messaging services twilio is a cloud communications platform that enables users to send and receive text messages, make calls, and utilize messaging services through its api the twilio sms connector for swimlane turbine allows users to integrate these communication capabilities directly into their security workflows by leveraging this connector, security teams can automate notifications, alerts, and responses, ensuring timely and effective communication during critical security incidents the integration streamlines the process of reaching out to stakeholders and teams via sms, voice calls, or whatsapp messages, enhancing the overall incident response strategy prerequisites to utilize the twilio sms connector within swimlane turbine, ensure you have the following prerequisites twilio account sid and authentication token for api access authentication token your unique twilio authentication token for secure api access account sid the string that uniquely identifies your twilio account, required for api interactions capabilities twilio sms connector provides the following capabilities make call send a whatsapp message send an message with messaging service send sms configurations twilio sms authentication authenticates using account sid and authentication token configuration parameters parameter description type required account sid account sid string required auth token authentication token string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional actions make call initiates an outbound call using twilio's telephony service, allowing for automated voice communication input argument name type required description body string optional request body data to string optional parameter for make call from string optional parameter for make call output parameter type description status code string http status code of the response headers object http headers for the request reason string response reason phrase account sid string unique identifier answered by object output field answered by api version string output field api version caller name object name of the resource date created string output field date created date updated string output field date updated direction string output field direction duration string output field duration end time string time value forwarded from string output field forwarded from from string output field from from formatted string output field from formatted group sid object unique identifier parent call sid object unique identifier phone number sid string unique identifier price string output field price price unit string output field price unit sid string unique identifier start time string time value status string status value subresource uris object output field subresource uris notifications string output field notifications example \[ { "status code" "ca5171e01a64104d8df067b21279b0a0b4", "headers" null, "reason" "ok", "json body" { "account sid" "acxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "answered by" null, "api version" "2010 04 01", "caller name" null, "date created" "tue, 31 aug 2010 20 36 28 +0000", "date updated" "tue, 31 aug 2010 20 36 44 +0000", "direction" "inbound", "duration" "15", "end time" "tue, 31 aug 2010 20 36 44 +0000", "forwarded from" "+141586753093", "from" "+15017122661", "from formatted" "(501) 712 2661", "group sid" null, "parent call sid" null, "phone number sid" "pnxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" } } ] send a whatsapp message send a whatsapp message through twilio by specifying the recipient's and sender's phone numbers input argument name type required description to string required whatsapp recipient address from string required approved whatsapp sender address body string optional message content text media url string optional url of media to send content sid string optional content sid for message content variables string optional variables for content template output parameter type description status code number http status code of the response headers object http headers for the request reason string response reason phrase body string request body data num segments string output field num segments direction string output field direction from string output field from to string output field to price object output field price error message object response message uri string output field uri account sid string unique identifier num media string output field num media status string status value messaging service sid object unique identifier sid string unique identifier date sent object output field date sent error code object error message if any price unit string output field price unit api version string output field api version subresource uris object output field subresource uris media string output field media solution object output field solution account sid string unique identifier sid string unique identifier example \[ { "status code" 201, "headers" null, "reason" "created", "json body" { "body" "sent from your twilio trial account hi testing", "num segments" "1", "direction" "outbound api", "from " "+180xxxxxx", "to" "+9177034xxxxx", "price" null, "error message" null, "uri" "/2010 04 01/accounts/ac99a3b212c43bc6e05d817xxxxxxxx/messages/sm0fa20d210a655ba9 ", "account sid" "ac99a3b212c43bc6e05d817xxxxxxxx", "num media" "0", "status" "queued", "messaging service sid" null, "sid" "sm0fa20d210a655ba9139af31xxxxxxx", "date sent" null, "error code" null } } ] send an message with messaging service sends an sms to a specified recipient using a twilio messaging service sid and message body input argument name type required description to string required recipient's phone number body string required content of the message messaging service sid string required identifier for the messaging service from string optional sender's phone number mediaurl string optional url of the media to send content sid string optional identifier for the content template output parameter type description status code string http status code of the response headers object http headers for the request reason string response reason phrase body string request body data num segments string output field num segments direction string output field direction from object output field from to string output field to price object output field price error message object response message uri string output field uri account sid string unique identifier num media string output field num media status string status value messaging service sid string unique identifier sid string unique identifier date sent object output field date sent error code object error message if any price unit object output field price unit api version string output field api version subresource uris object output field subresource uris media string output field media solution object output field solution account sid string unique identifier sid string unique identifier example \[ { "status code" "201", "headers" null, "reason" "ok", "json body" { "body" "hi testing", "num segments" "0", "direction" "outbound api", "from " null, "to" "+91770xxxxxxxx", "price" null, "error message" null, "uri" "/2010 04 01/accounts/ac99a3b212c43bc6e05d8175daxxxxxxxx/messages/sm32abf700f3e21 ", "account sid" "ac99a3b212c43bc6e05d8175daxxxxxxxx", "num media" "0", "status" "accepted", "messaging service sid" "mga9c0fb49f844d56420f00b4feaxxxxxx", "sid" "sm32abf700f3e2132456f8exxxxxxxxxx", "date sent" null, "error code" null } } ] send sms sends an sms to a specified phone number using twilio's messaging service input argument name type required description body string optional request body data to string optional parameter for send sms from string optional parameter for send sms output parameter type description status code string http status code of the response headers object http headers for the request reason string response reason phrase account sid string unique identifier api version string output field api version body string request body data date created string output field date created date sent string output field date sent date updated string output field date updated direction string output field direction error code object error message if any error message object response message from string output field from messaging service sid object unique identifier num media string output field num media num segments string output field num segments price object output field price price unit object output field price unit sid string unique identifier status string status value subresource uris object output field subresource uris media string output field media to string output field to uri string output field uri example \[ { "status code" "ca5171e01a64104d8df067b21279b0a0b4", "headers" null, "reason" "ok", "json body" { "account sid" "acxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "api version" "2010 04 01", "body" "hi there", "date created" "thu, 30 jul 2015 20 12 31 +0000", "date sent" "thu, 30 jul 2015 20 12 33 +0000", "date updated" "thu, 30 jul 2015 20 12 33 +0000", "direction" "outbound api", "error code" null, "error message" null, "from" "+14155552345", "messaging service sid" null, "num media" "0", "num segments" "1", "price" null, "price unit" null } } ] notes whatsapp business platform with twilio https //www twilio com/docs/whatsapp/api#sending notifications with whatsapp send a whatsapp message https //www twilio com/docs/whatsapp/api#sending notifications with whatsapp send an message with messaging service https //www twilio com/docs/messaging/api/message resource#send a message with a messaging service