How do I create a new WhatsApp message?

Last Updated: 2/4/2025     Tags: activity, sms, whatsapp, deploy, create
  • Switch Version
  • V5
  • V4

Taguchi supports WhatsApp messaging via a Twilio integration.

For information on the integration and what configuration in Taguchi looks like, please see our 'Whatsapp Twilio integration' article.

Taguchi's WhatsApp template can be used to create WhatsApp messages that can be sent directly to your subscriber's WhatsApp account.

This article covers:

  1. WhatsApp message template options.
  2. How to set up and deploy a WhatsApp message activity.
  3. Limitations with WhatsApp messaging.
  4. WhatsApp message reporting.

WhatsApp message template

There are 4 WhatsApp message types that Taguchi supports:

  1. Text
  2. Media
  3. Call-to-action
  4. Card

1. Text

The text type contains only plain text-based content.

WhatsApp text type

2. Media (Media & Text)

The media type contains a combination of media and text content.

WhatsApp media type

The supported media types are:

  • Images: JPG, JPEG, PNG
  • Video: MP4
  • Document: PDF

The total size of the text and media uploaded must be less than 16MB. The size limit for an image is 5MB.

Animated GIFs are not supported. There may be other acceptable media types, but only the above types have been tested in Taguchi.

The Call-to-action (CTA) type contains text content and 1 or 2 call-to-action buttons.

WhatsApp cta type

4. Card

The card type is a structured template that can be used to send different combinations of text, media, call to action and footer content.

WhatsApp card type

Below you'll find the available combinations:

Combination Header Media Header Text Body Text Footer Text 1 or 2 Call-to-action buttons
1
2
3
4
5
6

❌ - not allowed to be used in this combination. ✅ - allowed to be used on this combination. At least 1 CTA button must be present on every combination. ⭕ - not applicable in this combination.


How to set up and send a WhatsApp message activity

Before you start setting up your activity, ensure the WhatsApp template is in your organisation.

Contact Taguchi Support if you need assistance with this.

You will also need to ensure you have an active WhatsApp Twilio integration.

  1. While in the dashboard section of Taguchi, click on the green 'New Activity' button on the far right-hand side to create a new activity.

WhatsApp dashboard

  1. Give your activity a name and select the WhatsApp Twilio 'Distribution Channel'. If this option is disabled, this means the template is not available in your organisation. Please contact Taguchi Support to get this enabled.

WhatsApp create new activity

  1. Add your activity to your chosen campaign and click Save or Edit & Save. You can define your schedule & automation rules and targeting at this point, however, it can be configured at a later time.

Configuring your WhatsApp message activity

  1. Once your WhatsApp message activity is created, you can now configure your message.
  2. Select the WhatsApp provider you want to use for this activity. The provider relies on a WhatsApp Twilio integration being created and active in your organisation. If there is no provider to select, an integration will need to be set up. See our 'Whatsapp Twilio integration' article on how to do this.
  3. Select the Message type you want to use for this activity.
  4. The activity editor will change depending on the selected message type.

WhatsApp activity set up

Message Type: Text

WhatsApp text editor

  1. Input text via the text field - this is where you would input the message you want to send to your subscribers.
    • This field must be populated.
    • This field supports personalisation tags. For example, if you would like to personalise your message with a subscriber's firstname with a fallback option, input {%= recipient.firstname || "Fallback" %} into the text field.
    • Allows a maximum of 1,600 characters

WhatsApp tracking

  1. Tracking
    • Enabling click tracking is optional
      • It allows us to track who has clicked on any links within your text when enabled.
      • Uses the click tracking domain set up in the WhatsApp Twilio integration.
    • Entering Analytics tags is optional
      • The tags tie in with Google link tracking.
      • Adding a value into the source, campaign and medium fields adds the link tracking string with these values to links within your text.

Message Type: Media (Media & Text)

WhatsApp Media

  1. Input a URL or upload supported media via the Media URL field, in addition to text.

    • When you select this message type, the URL field must be completed.
    • The URL field supports personalisation tags after the domain.
  2. Tracking

    • Enabling click tracking is optional
      • It allows us to track who has clicked on any links within your text when enabled.
      • Uses the click tracking domain set up in the WhatsApp Twilio integration.
    • Entering Analytics tags is optional
      • The tags tie in with Google link tracking.
      • Adding a value into the source, campaign and medium fields adds the link tracking string with these values to links within your text.

WhatsApp CTA

  1. When this message type is selected, two CTA buttons can be added into your message. These appear below your message text.

    • You must define at least one CTA button.
  2. Input the first CTA button text.

    • A maximum of 25 characters is allowed.
    • This field does not support personalisation.
  3. Input the first CTA button URL.

    • This field must be completed.
    • The field supports personalisation.
    • URLs must start with either https:// or http://
  4. Adding the second CTA is optional. If you select this option, input the text and URL as per above instructions for the first CTA.

  5. Tracking

    • Enabling click tracking is optional
      • It allows us to track who has clicked on any links within your text when enabled.
      • Uses the click tracking domain set up in the WhatsApp Twilio integration.
    • Entering Analytics tags is optional
      • The tags tie in with Google link tracking.
      • Adding a value into the source, campaign and medium fields adds the link tracking string with these values to links within your text.

WhatsApp Card

  1. When this message type is selected, additional options can be added to your message.

  2. Input header media or header text. WhatsApp only supports one option at a time.

  3. If you wish to include an image in your message populate the Header Media URL.

    • This field supports personalisation tags.
  4. Upload media by clicking on the 'select' button and choosing a supported file from your computer.

  5. If you wish to use Header Text instead, input header text. Header Text adds a bolded header text to the top of the message.

    • This field supports personalisation but there is a character limit of 60 characters on this field.
  6. Input the main message text you want subscriber's to see in the Body Text field.

    • This field is required.
    • Maximum of 1,024 characters.
  7. You can add footer text to your message via the Footer Text field. This appears at the bottom of your message text in grey.

    • This field is optional.
    • This field supports personalisation tags. However, please note the character limits on this field.
    • Maximum of 60 characters.
  8. Two CTA buttons can be added into your message. These appear below your message text.

    • You must define at least one CTA button.
  9. Input the first CTA button text.

    • A maximum of 25 characters is allowed.
    • This field does not support personalisation.
  10. Input the first CTA button URL.

    • This field must be completed.
    • The field supports personalisation.
    • URLs must start with either https:// or http://
  11. Adding the second CTA is optional. If you select this option, input the text and URL as per above instructions for the first CTA.

  12. Tracking

    • Enabling click tracking is optional
      • It allows us to track who has clicked on any links within your text when enabled.
      • Uses the click tracking domain set up in the WhatsApp Twilio integration.
    • Entering Analytics tags is optional
      • The tags tie in with Google link tracking.
      • Adding a value into the source, campaign and medium fields adds the link tracking string with these values to links within your text.

Proofing

WhatsApp activities have a unique proofing process, where proofing is unavailable until the message is approved by WhatsApp.

WhatsApp Approval

  • WhatsApp needs to approve each message in a process called 'Template approval'.
  • Taguchi submits an activity to WhatsApp when a user selects the approval button in Taguchi.
  • An activity will not be able to be proofed or deployed until it is approved by WhatsApp.
  • This process will have to be completed every time a change is made to your activity.
  • Taguchi recommends proofing the message only after the activity setup is complete.
  • Once WhatsApp approves your activity you are free to schedule and deploy as usual.

Steps to proof

  1. Select the approve button and then the approve button via the pop-up - Taguchi will submit your activity to WhatsApp for template approval. You will be notified in the activity log.

WhatsApp approve to proof

  1. If your activity is valid WhatsApp will approve the template in 5-10mins.

  2. Only once approved does the proofing button appear. The activity log will display when WhatsApp has approved the activity.

WhatsApp approval

  1. To proof, select the record or add additional participants to receive the proof message under 'participants' and click on the proof icon. The activity log will display a record of the proof being sent.

WhatsApp proof sent

A WhatsApp user is restricted to receive a maximum of 2 messages per day from the same sender for marketing and this can affect the number of proofs you can receive. Therefore, you may need to involve other team members to help proof the message.

Deployment

WhatsApp deploy

  • After receiving WhatsApp approval for your activity, deployment works the same as any other activity in Taguchi.
  • This is a two-step process involving approving the activity and then deploying or scheduling, depending on when you want the activity to be sent.
    • Once the deployment time is reached, the message will be queued to then be delivered to your targeted audience.

Limitations

  1. WhatsApp determines if your target receives the message based on their per-user Marketing Template Message Limits
  2. When you begin to use this channel, WhatsApp limits the number of subscribers you can communicate to. You can unlock more by communicating consistently with your audience, receiving good engagement and not being reported for spam.
  3. You will not be able to receive any metrics on if you are blocked/reported by a user.
  4. A WhatsApp user is restricted to receive a maximum of 2 messages per day from the same sender for marketing, this can affect receiving proofs.

Reporting

Taguchi can report on the number of messages sent and if click tracking is enabled, the number of clicks on any URLs within the WhatsApp message.

If you require assistance with this channel type, please reach out to Taguchi Support.