---
title: "POST /api/v4/bots/{id}/run"
method: POST
path: "/api/v4/bots/{id}/run"
---

# POST /api/v4/bots/{id}/run

`POST /api/v4/bots/{id}/run`

## Request

- Base URL: `https://subdomain.kommo.com`
- URL: `https://subdomain.kommo.com/api/v4/bots/{id}/run`
- Auth: OAuth 2

## Path parameters

- `id` string, required

## Request body

- object
  - `entity_id` integer, required: ID da entidade à qual o contato do chat está vinculado ou ID do próprio contato do chat
  - `entity_type` 'leads' | 'contacts', required: O tipo de entidade cujo ID foi passado. Pode ser `leads` e `contacts`

## Response `202`

Tarefa para iniciar um bot foi criada com sucesso

## Other responses

- `400`: Foram transmitidos dados incorretos. Os detalhes estão disponíveis no corpo da resposta.
- `401`: Usuário não autorizado
- `403`: Não há direitos suficientes para chamar este método na entidade especificada
- `404`: Salesbot com o ID não encontrado

---

[API](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo.md) - [All operations](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo/llms.txt) - [OpenAPI document](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo/revisions/55101699dddb?raw)