How to use polls as buttons?

Creating polls as an alternative to interactive buttons in WhatsApp

Interactive buttons in WhatsApp are a very handy tool for working with customers.

In our API, you have the option to send messages with buttons: Read more

However, sometimes buttons may not fit in your scenario. That's why we offer you a convenient alternative - use polls as buttons.

For the user, polls and interactive buttons are functionally similar. And the mechanism of working with a poll is very similar to that of buttons.

To work with surveys, you will need to use the POST /messages/poll method. You can find out more about it and test it here:

📊 Send poll messageWhapi Cloud - Whatsapp API for developers

In this method, you can send poll-type messages

You will find ready-made code snippets in popular programming languages at the link.

Sending a poll

Sending a poll is quite easy, you need a few parameters in the body of the request:

• to - in this parameter specify the Chat ID of the recipient (group, or personal number) to whom we send the survey. (Send only numbers, without formatting or masks).

• title - here specify the full message to the conversation partner, the text of your question.

• options - specify the user's response options. There can be from 2 to 12 of them, and they must be unique and not duplicated.

• count - this parameter affects the amount of response options from the conversation partner. For example, several or only one answer from the whole survey.

Сurl request

curl --request POST \
     --url https://gate.whapi.cloud/messages/poll \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YPZapY69pl9j0xQpxoMqqsKMoBat1p8h' \
     --header 'content-type: application/json' \
     --data 
{
  "options": [
    "Eyelash extensions",
    "Eyebrow correction and coloring",
    "Massage",
    "I'm fine with everything!"
  ],
  "title": "Thank you for visiting the Etteri salon! We are interested in ensuring that our beauty salon meets all your wishes. What service do you think is missing in our beauty salon?",
  "to": "[email protected]"
}

Pyton

Example of a message sent to a customer

Tracking a user's selection in a poll

Polls are of a customized type"type": "poll". At the same time, each option that can be voted for by the client also has its own identifier. For example:

"results": [
          {
            "name": "I'm good",
            "voters": [],
            "count": 0,
            "id": "YCUAzJ4pYtRgSP+k/udEwRdvHxxuRQmNCrdTKz/K2TU="
          },
          {
            "name": "Can't complain",
            "voters": [],
            "count": 0,
            "id": "f61LjJqD6KEefNsuDQrvFXAB1iufPN3U1ykIOxD8DRc="
          }
        ]

Whereas when you vote, the webhook will receive full details of the selected option in the poll.

{
 "id": "f61LjJqD6KEefNsuDQrvFXAB1iufPN3U1ykIOxD8DRc=",
 "name": "Can't complain",
 "count": 1,
 "voters": [
    "[email protected]"
  ]
 }

This way, you will be able to handle your customers' responses and respond appropriately. For example, responding with a pre-prepared answer.

You can retrieve the full poll results by sending a https://gate.whapi.cloud/messages/{MessageID} request using the ID of the message that contains the poll.

Node.Js source code

We have prepared a simple and easy to understand source code for you to implement in your survey response integration or bot.

GitHub - Whapi-Cloud/whatsapp-api-send-poll-example: Simple and straightforward source code that you can use in your integration or survey response bot.GitHub

Remember, if you have any questions or issues along the way, our support team is always here to help. We value every user and strive to ensure that your experience with our API is as smooth and efficient as possible.