> ## 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 lista de opções

> Responde uma opção de lista de opções como se o usuário tivesse tocado nela

## Conceituação

Este endpoint permite responder uma lista de opções, simulando o toque do usuário em uma das opções enviadas anteriormente via [send-option-list](https://developer.z-api.io/message/send-option-list.md).

> [!NOTE]
>
> A lista precisa ter sido enviada ou recebida previamente. O **ID da opção** deve ser o mesmo `id` definido para essa opção no momento do envio da lista ou no webhook recebido.

***

#### Exemplo no aplicativo

![](https://mintcdn.com/z-api-8aa3bb40/JwKVrTj4Z94Uyxdq/images/reply-option-list.jpeg?fit=max\&auto=format\&n=JwKVrTj4Z94Uyxdq\&q=85\&s=f662a6b8c62ad255f6f9c5232375c942)

***

## Atributos

**instanceId** `string` *required*

ID da sua instância. Disponível no painel Z-API em **Instâncias**.

**token** `string` *required*

Token da sua instância Z-API.

### Obrigatórios

**phone** `string` *required*

Telefone (ou ID do grupo) no formato DDI DDD NÚMERO. Ex: 551199999999

**messageId** `string` *required*

ID da mensagem de lista de opções que está sendo respondida.

**responseOptionId** `string` *required*

ID da opção escolhida. Deve ser o mesmo `id` definido na lista ao enviá-la.

***

## Request Body

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "phone": "5511999999999",
  "messageId": "3EB0C767D82B0A6E9F5F",
  "responseOptionId": "1"
}
```

## Response

### 200

**zaapId** `string`

id no z-api

**messageId** `string`

id no aplicativo

**id** `string`

Adicionado para compatibilidade com zapier, ele tem o mesmo valor do messageId

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

### 400

Verifique se o body da requisição foi enviado e se os campos obrigatórios (`phone`, `messageId` e `responseOptionId`) estão preenchidos.

### 405

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

### 415

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.