twilio/card

WhatsApp, Facebook Messenger

title:

• Type: string
• Required: yes
• Variable Support: yes

• Description: Title of card.

  • Maximum: 1024 characters

subtitle:

• Type: string
• Required: no
• Variable Support: no

• Description: Subtitle of card.

  • Maximum: 60 characters

media:

• Type: string[]
• Required: no
• Variable Support: yes

• Description: The URL of the media to send with the message.

  • Supported and Accepted media types can be referenced here (MMS) and here (WhatsApp).

actions:

• Type: array
• Required: Yes
• Variable Support: Yes
• Description: Cards can contain buttons which are defined using an actions array.

actions:

QUICK_REPLY:

• parameters
  • type: QUICK_REPLY
  • title: Button text of quick reply button. Appears in Body and ButtonText fields in inbound when selected by end user. Variables are not supported. Max 25 chars.
  • id: Not visible to end user. Appears in ButtonPayload fields in inbound when selected by end user. Variables are supported.

URL:

• parameters
  • type: URL
  • title: Button text of URL redirect button. Variables are not supported. Max 25 chars.
  • url: URL opened when end user clicks the button. Variables are supported at the end of the url string.

PHONE:

• parameters
  • type: PHONE
  • title: Button text of URL redirect button. Variables are not supported. Max 25 chars.
  • phone: Phone number to call when the recipient taps the button. E.164 formatted. Variables are not supported.

VOICE_CALL:

• parameters
  • type: VOICE_CALL
  • title: Button text of VOIP call button. Variables are not supported. Max 25 chars.

COPY_CODE:

• parameters
  • type: COPY_CODE
  • title: Button text of copy code button. Variables are not supported. Max 25 chars.
  • code: Coupon code that is copied to end user clipboard after clicking button. Variables are supported.

1
// Install the C# / .NET helper library from twilio.com/docs/csharp/install
2

3
using System;
4
using Twilio;
5
using Twilio.Rest.Content.V1;
6

7
     TwilioClient.Init(accountSid, authToken);
8

9
    // define the twilio/text type for less rich channels (e.g. SMS)
10
    var twilioText = new TwilioText.Builder();
11
    twilioText.WithBody("Hi {{1}}.  Thanks for contacting Owl Air Support. How can we help?");
12

13
    // define the twilio/card type for more rich channels
14
    var twilioCard = new TwilioCard.Builder();
15
    twilioCard.WithTitle("Owl Air Support");
16
    var cardAction1 = new CardAction.Builder()
17
        .WithType(CardActionType.Url)
18
        .WithUrl("https://www.twilio.com")
19
        .WithTitle("Contact Us")
20
        .Build();
21
    twilioCard.WithActions(new List<CardAction>() { cardAction1 });
22

23
    // define all the content types to be part of the template
24
    var types = new Types.Builder();
25
    types.WithTwilioText(twilioText.Build());
26
    types.WithTwilioCard(twilioCard.Build());
27

28
    // build the create request object
29
    var contentCreateRequest = new ContentCreateRequest.Builder();
30
    contentCreateRequest.WithTypes(types.Build());
31
    contentCreateRequest.WithLanguage("en");
32
    contentCreateRequest.WithFriendlyName("owl_air_card");
33
    contentCreateRequest.WithVariables(new Dictionary<string, string>() { {"1", "John"} });
34
    
35
    // create the twilio template
36
    var contentTemplate = await CreateAsync(contentCreateRequest.Build());
37

38
    Console.WriteLine($"Created Twilio Content Template SID: {contentTemplate.Sid}");

1
{
2
  "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
3
  "date_created": "2022-08-30T09:19:17Z",
4
  "date_updated": "2022-08-30T09:19:17Z",
5
  "friendly_name": "owl_air_card",
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/card": {
14
      "actions": [
15
        {
16
          "title": "Order Online",
17
          "type": "URL",
18
          "url": "https://www.owlair.com/"
19
        },
20
        {
21
          "phone_number": "+15551234567",
22
          "title": "Call Us",
23
          "type": "PHONE_NUMBER"
24
        }
25
      ],
26
      "body": null,
27
      "media": null,
28
      "subtitle": "To unsubscribe, reply Stop",
29
      "title": "Congratulations, you have reached Elite status! Add code {{1}} for 10% off."
30
    },
31
    "twilio/text": {
32
      "body": "Congratulations, your account reached Elite status, you are now eligible for 10% off any flight! Just add coupon code {{1}} to check out."
33
    }
34
  },
35
  "url": "https://content.twilio.com/v1/Content/HXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
36
  "variables": {
37
    "1": "coupon_code"
38
  }
39
}