DIY Surveys / API
  • Welcome to the DIY Surveys API
  • Getting Started
  • Messaging
    • Keyword
    • Languages
    • GSM Character Set
    • Macros
      • Macro Reference
    • Message Statuses
    • Message Windows
    • Metadata
    • Stop Lists
    • Usage
    • Message Type
  • Organizations
  • Recipient
  • Security
  • Survey
  • TinyUrl
  • Web Hooks and Callbacks
  • Custom Transformations
  • FAQ
  • Cloud Service
  • API Versions
    • DIY Surveys API 1.0
    • DIY Surveys API 2.0
    • DIY Surveys API 3.0
Powered by GitBook

Services

  • Surveys
  • Respondents
  • Results
  • Channels

© 2025 DIY Surveys Ltd.

On this page
  • WhatsApp
  • WhatsApp Invite
  • WhatsApp Message

Was this helpful?

  1. Messaging

Message Type

The message type allows you to use the DIY Surveys unique routing capability to send messages over different platforms. The default message type is SMS. The following platforms are supported:

  1. SMS

  2. WhatsApp

  3. Facebook (not currently active).

Further platforms will be added

WhatsApp

WhatsApp messages come in two basic forms:

  1. WhatsApp Invite

  2. WhatsApp Message

WhatsApp Invite

An invite must first be used to trigger a conversation with the recipient. If the recipient responds, then a WhatsApp Message can be sent. An invite has to be approved by the WhatsApp Business Team to use it. DIY Surveys supports this process for you through the main administration platform.

A WhatsApp Invite has to follow a specific format within the platform and to get a template to trigger with the correct content you need to format the API message correctly. For example, you might have a WhatsApp template set up that looks like this (with the name merketing_message_1 and the language en-GB):

Hello, I’m the virtual assistant of {User11}.

I have a brief survey to understand how was your experience in the Dealership. 

To stop receiving these messages, press “Do not receive more”.

{button(Answer the survey)}
{button(Privacy Policy)}
{button(Do not receive more)}
marketing_template_1|en-GB|John

The first element is the name of the template, the second element is the language and the only Macro that requires data to be supplied is the {User1} (in this the data is 'John').

WhatsApp Message

When a response to a WhatsApp Invite has been recieved from the recipient it is possible to send freely formed messages to the recipient that could, for example, make up a 2-way survey.

PreviousUsageNextOrganizations

Last updated 1 year ago

Was this helpful?

This in this example there are several used to pipe in data into the message. Examples of the data have been shared with WhatsApp and that is all they need to trigger the template. So instead of supplying the full message again you supply the data separated by pipes ('|'). For example, considering the above template, the following message would work:

Macro's