Twilio

Overview of the Twilio integration.

The following documentation is for Twilio v2.0.1.

Overview

Twilio is a cloud communications platform providing SMS, voice, video, and messaging API services. This integration enables automated SMS sending, phone call management, communication workflows, and customer engagement automation. Enhance customer communication and automate messaging processes.

Setup

The following integrations need to be connected to your Kognitos workspace:

• Twilio

Steps

Follow these steps to connect the integration in Kognitos:

1

Navigate

Using the left navigation menu, go to Integrations → Explore Integrations.

2

Find

Search for the integration and click on it.

3

Connect

Click on Connect to add a connection to the integration.

4

Configure

Add a name for the connection. You'll be prompted for authentication details if needed. Then, click on Connect.

Authentication

Use one of the following authentication methods to connect this integration in Kognitos. Each method has its own configuration requirements.

Connect using Account SID and Auth Token

Connect to the Twilio API using account credentials.

Label	Description	Type
Account SID	The Account SID from your Twilio account.	text
Auth Token	The Auth Token from your Twilio account.	sensitive

Actions

The following actions are available in the Twilio integration:

1. Read some SMS messages

Get SMS messages from the Twilio API.

2. Send an SMS message

Send an SMS message using the Twilio API.

Concepts

Twilio sms message

SMS message data model.An SMS (Short Message Service) message. Represents a text communication sent over a cellular network, typically between mobile phones.

Field Name	Description	Type
sid	The unique, Twilio-provided string that identifies the Message resource.	optional[text]
body	The text content of the message	optional[text]
num_segments	The number of segments that make up the complete message. SMS message bodies that exceed the character limit are segmented and charged as multiple messages. Note: For messages sent via a Messaging Service, num_segments is initially 0, since a sender hasn't yet been assigned	optional[text]
sender_number	The sender's phone number (in E.164 format), alphanumeric sender ID, Wireless SIM, short code, or channel address (e.g., whatsapp:[phone]). For incoming messages, this is the number or channel address of the sender. For outgoing messages, this value is a Twilio phone number, alphanumeric sender ID, short code, or channel address from which the message is sent	optional[text]
recipient_number	The recipient's phone number (in E.164 format) or channel address (e.g. whatsapp:[phone])	optional[text]
price	The amount billed for the message in the currency specified by price_unit. The price is populated after the message has been sent/received, and may not be immediately available. View the Pricing page for more details.	optional[number]
account_sid	The SID of the Account associated with the Message resource	text
num_media	The number of media files associated with the Message resource.	number
status	The status of the message, for more information about possible statuses see Message Status	optional[text]
messaging_service_sid	The SID of the Messaging Service associated with the Message resource. A unique default value is assigned if a Messaging Service is not used.	text
date_sent	The RFC 2822 timestamp (in GMT) of when the Message was sent. For an outgoing message, this is when Twilio sent the message. For an incoming message, this is when Twilio sent the HTTP request to your incoming message webhook URL.	optional[datetime]
date_created	The RFC 2822 timestamp (in GMT) of when the Message resource was created	optional[datetime]
date_updated	The RFC 2822 timestamp (in GMT) of when the Message resource was last updated	optional[datetime]
price_unit	The currency in which price is measured, in ISO 4127 format (e.g. usd, eur, jpy).	text
error_code	The error code returned if the Message status is failed or undelivered. If no error was encountered, the value is null.	optional[number]
error_message	The description of the error_code if the Message status is failed or undelivered. If no error was encountered, the value is null.	optional[text]