> ## Documentation Index
> Fetch the complete documentation index at: https://developer.z-api.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Responder botão de ação

> Responde um botão de botões de ação como se o usuário tivesse clicado

## Conceituação

Este endpoint permite responder um botão de ação, simulando o clique do usuário em uma das opções enviadas anteriormente via [send-button-actions](/message/send-button-actions).

<Warning>
  Apenas botões do tipo **REPLY** podem ser respondidos. Botões de outros tipos não suportam resposta via API.
</Warning>

<Info>
  O botão deve ter sido previamente enviado e o **ID do botão** deve ser obtido via webhook de recebimento da mensagem.
</Info>

***

#### Exemplo no WhatsApp

<div style={{ display: "flex", justifyContent: "center" }}>
  <img src="https://mintcdn.com/z-api-8aa3bb40/6uSiush_ktq0RgAk/images/reply-template-button.jpeg?fit=max&auto=format&n=6uSiush_ktq0RgAk&q=85&s=ab2c3c784f320af57940fc8b2940ad72" width="400" data-path="images/reply-template-button.jpeg" />
</div>

***

## Atributos

<ParamField path="instanceId" type="string" required>
  ID da sua instância. Disponível no painel Z-API em **Instâncias**.
</ParamField>

<ParamField path="token" type="string" required>
  Token da sua instância Z-API.
</ParamField>

### Obrigatórios

<ParamField body="phone" type="string" required>
  Telefone (ou ID do grupo) no formato DDI DDD NÚMERO. Ex: 551199999999
</ParamField>

<ParamField body="responseTemplateButtonId" type="string" required>
  ID do botão do tipo REPLY. Esse ID é obtido via webhook da mensagem recebida.
</ParamField>

<ParamField body="messageId" type="string" required>
  ID da mensagem que contém os botões enviados anteriormente.
</ParamField>

***

## Request Body

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "phone": "5511999999999",
  "responseTemplateButtonId": "1",
  "messageId": "D241XXXX732339502B68"
}
```

## Response

### 200

<ResponseField name="zaapId" type="string">
  id no z-api
</ResponseField>

<ResponseField name="messageId" type="string">
  id no whatsapp
</ResponseField>

<ResponseField name="id" type="string">
  Adicionado para compatibilidade com zapier, ele tem o mesmo valor do messageId
</ResponseField>

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "zaapId": "3999984263738042930CD6ECDE9VDWSA",
  "messageId": "D241XXXX732339502B68",
  "id": "D241XXXX732339502B68"
}
```

### 405

Verifique se o método HTTP utilizado está correto (POST).

### 415

Certifique-se de enviar o header Content-Type: application/json.