whatsapp/card

WhatsApp

body:

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

• Description: body of card.

  • Maximum: 1024 characters

footer:

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

• Description: footer 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).
  • Cannot be present if header_text is present

header_text:

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

• Description: Bolded header text of card.

  • Maximum: 60 characters
  • Cannot be present if media is present

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 whatsapp/card 
10
    var whatsappCard = new WhatsappCard.Builder();
11
    whatsappCard.WithBody("Congratulations, you have reached Elite status! Add code {{1}} for 10% off.");
12
    whatsappCard.WithHeaderText("This is a {{1}} card");
13
    whatsappCard.WithFooter("To unsubscribe, reply Stop");
14
    var cardAction1 = new CardAction.Builder()
15
        .WithType(CardActionType.Url)
16
        .WithUrl("https://www.twilio.com")
17
        .WithTitle("Order Online")
18
        .Build();
19
    var cardAction2 = new CardAction.Builder()
20
        .WithType(CardActionType.PhoneNumber)
21
        .WithPhone("+15551234567")
22
        .WithTitle("Call Us")
23
        .Build();
24
    whatsappCard.WithActions(new List<CardAction>() { cardAction1, cardAction2 });
25

26
    // define all the content types to be part of the template
27
    var types = new Types.Builder();
28
    types.WithWhatsappCard(whatsappCard.Build());
29

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

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

1
{
2
    "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
3
    "date_created": "2023-08-03T14:54:47Z",
4
    "date_updated": "2023-08-03T14:54:47Z",
5
    "friendly_name": "owl_coupon_code",
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
        "whatsapp/card": {
14
            "actions": [
15
                {
16
                    "title": "Order Online",
17
                    "type": "URL",
18
                    "url": "https://owlair.example.com/"
19
                },
20
                {
21
                    "phone": "+1555554567",
22
                    "title": "Call Us",
23
                    "type": "PHONE_NUMBER"
24
                }
25
            ],
26
            "body": "Congratulations, you have reached Elite status! Add code {{1}} for 10% off.",
27
            "footer": "To unsubscribe, reply Stop",
28
            "header_text": "This is a {{1}} card",
29
            "media": null
30
        }
31
    },
32
    "url": "https://content.twilio.com/v1/Content/HXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
33
    "variables": {
34
        "1": "coupon_code"
35
    }
36
}