Skip to main content

Introduction

In recent weeks, messages containing buttons have been experiencing instability in their behavior. It’s important to note that this is not an issue exclusive to Z-API. This topic describes how buttons behave on the application in different scenarios.
AttentionThis documentation was updated on 08/27/2024, so the facts about button behavior are based on the reality of that date. Remember that with each application update, buttons may change.

Decisive factors:

For buttons to work on the application, there are two decisive factors:

  • Whether the application sending the message is Business or regular
  • Whether the message is being sent to a regular chat or a group
  • Accepting the button terms of use

Accepting the Button Terms of Use

To use the button feature, you must accept the terms of use, acknowledging that you are aware that future application updates may cause instability in this feature.

Button types

There are seven types of buttons on the application:

  • Simple text button (/send-button-list)
  • Simple image button (/send-button-list-image)
  • Simple video button (/send-button-list-video)
  • Option list (/send-option-list)
  • Action buttons (/send-button-actions)
  • Copy button (/send-button-otp)
  • PIX button (/send-button-pix)

Button behavior:

Simple text button:

  • Sending from Regular application to Group: WORKS
  • Sending from Regular application to Regular Chat: WORKS
  • Sending from the Business application to Regular Chat: WORKS
  • Sending from the Business application to Group: WORKS

Simple image button:

  • Sending from Regular application to Regular Chat: WORKS
  • Sending from Regular application to Group: WORKS
  • Sending from the Business application to Regular Chat: WORKS
  • Sending from the Business application to Group: WORKS

Simple video button:

  • Sending from Regular application to Regular Chat: WORKS
  • Sending from Regular application to Group: WORKS
  • Sending from the Business application to Regular Chat: WORKS
  • Sending from the Business application to Group: WORKS

Option list:

  • Sending from Regular application to Regular Chat: WORKS
  • Sending from Regular application to Group: WORKS
  • Sending from the Business application to Regular Chat: WORKS
  • Sending from the Business application to Group: WORKS

Action buttons:

  • Sending from Regular application to Regular Chat: WORKS
  • Sending from Regular application to Group: WORKS
  • Sending from the Business application to Regular Chat: WORKS
  • Sending from the Business application to Group: WORKS

Copy button:

  • Sending from Regular application to Regular Chat: WORKS
  • Sending from Regular application to Group: WORKS
  • Sending from the Business application to Regular Chat: WORKS
  • Sending from the Business application to Group: WORKS

PIX button:

  • Sending from Regular application to Regular Chat: WORKS
  • Sending from Regular application to Group: WORKS
  • Sending from the Business application to Regular Chat: WORKS
  • Sending from the Business application to Group: WORKS

Summary

In summary, the use of button features on the application is subject to instability. Both for regular application and the Business application, there are difficulties sending these button types in regular chats and groups. Option lists for regular chats work. If you’re using the Business application, the only thing working is the option list for regular chat, with issues for groups.