Skip to content

[Does not store the actual message in metadata to avoid sensitive data storing]. Launch WhatsApp using pre-populated info from your form.

License

Notifications You must be signed in to change notification settings

ARCED-Foundation/launch-whatsapp-nometa

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Launch WhatsApp

Screenshot

Description

This plugin allows you to launch WhatsApp using pre-populated info from your form. You can provide a phone number, a message, or both.

This version is modified by ARCED Foundation to not to store the message as metadata for a specific project requirement.

Download now

Data format

This field plug-in requires the text field type.

When the green button is pressed, the WhatsApp message information is stored in the field’s response in the following format:

WhatsApp: name=name; number=number; message="message"

Please note: this message will be saved when the user clicks the green button. There is no way to verify whether or not WhatsApp was actually launched, a call was made, or a message was sent. Only the parameters that were supplied to the field plug-in will be recorded.

How to use

Getting started

  1. Download the test form extras/test-form from this repo and upload it to your SurveyCTO server.
  2. Download the launch-whatsapp.fieldplugin.zip file from this repo, and attach it to the test form on your SurveyCTO server.
  3. Make sure to provide the correct parameters (see below).

Parameters

Key Value
number (optional) The destination phone number (the full phone number in international format, without leading zeroes). This phone number does not need to be in the caller's contact list, but it does need to be a valid WhatsApp number (i.e., the phone number must be registered to a WhatsApp account).
name (optional) The name of the recipient. If supplied, this will be shown in the preview instead of the phone number.
message (optional) The body of the text message.
button_label (optional) If you want to override the default button label, "Launch WhatsApp", you can supply your own label with the button_label parameter.

Note: it is suggested to use values stored in other fields for these parameters. Take a look at the test form to see how this is accomplished.

More resources

About

[Does not store the actual message in metadata to avoid sensitive data storing]. Launch WhatsApp using pre-populated info from your form.

Topics

Resources

License

Stars

Watchers

Forks

Languages

  • JavaScript 41.1%
  • HTML 39.1%
  • CSS 19.8%