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

# POST /api/v4/bots/run

`POST /api/v4/bots/run`

## Request

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

## Headers

- `Content-Type` string

## Request body

- object[]
  - `bot_id` integer, required: ID do Salesbot a ser lançado
  - `entity_id` integer, required: O ID da entidade à qual o contato do chat está vinculado, ou o ID do próprio contato do chat
  - `entity_type` 'leads' | 'contacts', required: O tipo da entidade cujo ID foi transmitido. Pode ser `leads` e `contacts`

## Response `202`

As tarefas para lançar bots foram criadas com sucesso

## Other responses

- `400`: Os dados transmitidos estão incorretos. Mais detalhes podem ser encontrados 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`: Não foi encontrado nenhum Salesbot com este ID

---

[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)