---
title: "Recebe a interação de um botão"
method: POST
path: "/api/v1/acceptances/{id}/step"
tags: ["Acceptances"]
---

# Recebe a interação de um botão

`POST /api/v1/acceptances/{id}/step`

## Request

- Base URL: `http://app-acceptance-sandbox.clicksign.com`
- URL: `http://app-acceptance-sandbox.clicksign.com/api/v1/acceptances/{id}/step`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

Recebe a interação do destinatário com um passo interativo (clique em botão de um passo do tipo `template`). O serviço resolve a transição definida no template — avança para o próximo passo (`next_step_id`) ou finaliza o aceite (`outcome`: `accepted`/`declined`) — e enfileira a ação correspondente. Não há validação de estado na camada HTTP; o processamento é assíncrono.

## Path parameters

- `id` string, required

## Request body

- object
  - `step_id` string, required: Identificador do passo em que o botão foi clicado.
  - `button_text` string, required: Texto exato do botão clicado, conforme retornado pela API do canal.

## Response `202`

Interação aceita e enfileirada.

- object

## Other responses

- `400`: Payload inválido, `step_id` ausente ou `button_text` ausente/inválido.
- `401`: Credencial ausente ou inválida.
- `404`: `acceptance_id` não encontrado.

---

[API](https://skmtc.dev/clicksign/apis/m-dulos-de-aceite-e-de-notifica-o.md) - [All operations](https://skmtc.dev/clicksign/apis/m-dulos-de-aceite-e-de-notifica-o/llms.txt) - [OpenAPI document](https://skmtc.dev/clicksign/apis/m-dulos-de-aceite-e-de-notifica-o/revisions/18547508ff90?raw)