twilio/text

The twilio/text content type contains only plain text-based content. While you can send text to OTT channels without using content templates, you can use the twilio/text type as a fallback content type when sending to a mix of channels. Additionally, you can use variables in content templates to create dynamic content.

(warning)

Warning

You can send twilio/text content templates via WhatsApp for out-of-session messages with variables. If the template's body starts or ends with a variable or has two variables next to each other, the template won't be approved without a sample variable. For additional information about variables, see using variables with content templates.

Supported channels

SMS
RCS
WhatsApp
Facebook Messenger

Message preview

An example of a text message sent using the Content API.

Data parameters

Parameter	Type	Required	Variable support	Description
`body`	string	Yes	Yes	The text of the message you want to send. Maximum length: 1,600 characters

Code examples and responses

Create a text template

1// Install the C# / .NET helper library from twilio.com/docs/csharp/install
2
3using System;
4using Twilio;
5using Twilio.Rest.Content.V1;
6
7     TwilioClient.Init(accountSid, authToken);
8
9    // define the twilio/text
10    var twilioText = new TwilioText.Builder();
11    twilioText.WithBody("Hi {{1}}.  Thanks for contacting Owl Air Support. How can we help?");
12
13    // define all the content types to be part of the template
14    var types = new Types.Builder();
15    types.WithTwilioText(twilioText.Build());
16
17    // build the create request object
18    var contentCreateRequest = new ContentCreateRequest.Builder();
19    contentCreateRequest.WithTypes(types.Build());
20    contentCreateRequest.WithLanguage("en");
21    contentCreateRequest.WithFriendlyName("text_template");
22    contentCreateRequest.WithVariables(new Dictionary<string, string>() { {"1", "John"} });
23    
24    // create the twilio template
25    var contentTemplate = await CreateAsync(contentCreateRequest.Build());
26
27    Console.WriteLine($"Created Twilio Content Template SID: {contentTemplate.Sid}");

Output

1{
2  "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
3  "date_created": "2022-09-01T12:39:19Z",
4  "date_updated": "2022-09-01T12:39:19Z",
5  "friendly_name": "media_template",
6  "language": "en",
7  "links": {
8    "approval_create": "https://content.twilio.com/v1/Content/HXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/ApprovalRequests/whatsapp",
9    "approval_fetch": "https://content.twilio.com/v1/Content/HXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/ApprovalRequests"
10  },
11  "sid": "HXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
12  "types": {
13    "twilio/text": {
14      "body": "Hi, {{1}}. \n Thanks for contacting Owl Air Support. How can I help?."
15    }
16  },
17  "url": "https://content.twilio.com/v1/Content/HXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
18  "variables": {
19    "1": "name"
20  }
21}