> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bliper.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar Botões de Ação

> Envia uma mensagem interativa com botões de resposta rápida

## Descrição

Envia uma mensagem interativa com até 3 botões de resposta rápida. Quando o destinatário clica em um botão, a resposta é recebida como uma mensagem com o texto do botão selecionado.

## Request

### Headers

```
Client-Token: SEU_CLIENT_TOKEN
Content-Type: application/json
```

### Body

```json theme={null}
{
  "phone": "5511999999999",
  "message": "Como posso ajudar?",
  "title": "Suporte",
  "footer": "Bliper API",
  "buttons": [
    {"id": "1", "text": "Ver planos"},
    {"id": "2", "text": "Falar com vendas"},
    {"id": "3", "text": "Suporte técnico"}
  ]
}
```

| Campo     | Tipo   | Obrigatório | Descrição                                             |
| --------- | ------ | ----------- | ----------------------------------------------------- |
| `phone`   | string | Sim         | Número do destinatário no formato DDI+DDD+número      |
| `message` | string | Sim         | Texto principal da mensagem                           |
| `title`   | string | Não         | Título exibido acima da mensagem                      |
| `footer`  | string | Não         | Rodapé exibido abaixo dos botões                      |
| `buttons` | array  | Sim         | Lista de botões, cada um com `id` e `text` (máximo 3) |

## Response

### Sucesso (202)

```json theme={null}
{
  "messageId": "3EB0C767D02DCC481523",
  "id": "3EB0C767D02DCC481523"
}
```

## Exemplo cURL

```bash theme={null}
curl -X POST 'https://api.bliper.io/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/send-button-actions' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "5511999999999",
    "message": "Como posso ajudar?",
    "title": "Suporte",
    "footer": "Bliper API",
    "buttons": [
      {"id": "1", "text": "Ver planos"},
      {"id": "2", "text": "Falar com vendas"},
      {"id": "3", "text": "Suporte técnico"}
    ]
  }'
```

<Note>Limitado a 3 botões por mensagem conforme as regras do WhatsApp. Para listas com mais opções, use o endpoint `/send-button-list`.</Note>