---
updatedAt: 2026-11-12T11:12:34.000Z
agentTools:
  projectIndex: https://es-developers.kommo.com/llms.txt
---

# Lanzar un Salesbot

**Limitaciones**\
El método está disponible de acuerdo con los permisos del usuario.

**Encabezado de tipo de datos cuando la solicitud es exitosa**\
`Content-Type: text/html`

**Encabezado del tipo de datos en caso de error**\
`Content-Type: application/problem+json`

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "kommo-api",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://{subdominio}.kommo.com",
      "variables": {
        "subdominio": {
          "default": "subdominio"
        }
      }
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {}
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/api/v4/bots/{id}/run": {
      "post": {
        "description": "",
        "responses": {
          "202": {
            "content": {
              "text/html": {
                "schema": {
                  "type": "object",
                  "properties": {}
                },
                "examples": {
                  "Se creó correctamente la tarea para iniciar un bot": {
                    "summary": "Se creó correctamente la tarea para iniciar un bot",
                    "value": " "
                  }
                }
              }
            },
            "description": "Se creó correctamente la tarea para iniciar un bot"
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "properties": {}
                },
                "examples": {
                  "Se enviaron datos incorrectos. Los detalles están disponibles en el cuerpo de la respuesta.": {
                    "summary": "Se enviaron datos incorrectos. Los detalles están disponibles en el cuerpo de la respuesta.",
                    "value": {
                      "validation-errors": [
                        {
                          "request_id": "0",
                          "errors": [
                            {
                              "code": "NotSupportedChoice",
                              "path": "entity_type",
                              "detail": "El valor seleccionado no es una opción válida."
                            }
                          ]
                        }
                      ],
                      "title": "Solicitud incorrecta",
                      "type": "https://httpstatus.es/400",
                      "status": 400,
                      "detail": "Falló la validación de la solicitud"
                    }
                  }
                }
              }
            },
            "description": "Se enviaron datos incorrectos. Los detalles están disponibles en el cuerpo de la respuesta."
          },
          "401": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "properties": {}
                },
                "examples": {
                  "El usuario no está autorizado": {
                    "summary": "El usuario no está autorizado",
                    "value": "{\n  \"title\": \"No autorizado\",\n  \"type\": \"https://httpstatus.es/401\",\n  \"status\": 401,\n  \"detail\": \"Nombre de usuario o contraseña no válidos\"\n}"
                  }
                }
              }
            },
            "description": "El usuario no está autorizado"
          },
          "403": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "properties": {}
                },
                "examples": {
                  "No hay permisos suficientes para llamar a este método en la entidad especificada": {
                    "summary": "No hay permisos suficientes para llamar a este método en la entidad especificada",
                    "value": {
                      "title": "Acceso denegado",
                      "type": "https://developers.amocrm.ru/v4/errors/ProblemDetail",
                      "status": 403,
                      "detail": "Entidad no encontrada o sin permisos: 3552552"
                    }
                  }
                }
              }
            },
            "description": "No hay permisos suficientes para llamar a este método en la entidad especificada"
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "properties": {}
                },
                "examples": {
                  "El Salesbot con el ID especificado no fue encontrado": {
                    "summary": "El Salesbot con el ID especificado no fue encontrado",
                    "value": "{\n  \"title\": \"No encontrado\",\n  \"type\": \"https://developers.amocrm.ru/v4/errors/ProblemDetail\",\n  \"status\": 404,\n  \"detail\": \"Bots no encontrados: 6691202\"\n}"
                  }
                }
              }
            },
            "description": "El Salesbot con el ID especificado no fue encontrado"
          }
        },
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "required": true,
            "description": "ID del Salesbot que se va a lanzar"
          }
        ],
        "operationId": "post_api-v4-bots-id-run",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "entity_id": {
                    "type": "integer",
                    "description": "ID de la entidad a la que está vinculado el contacto del chat, o ID del propio contacto del chat.",
                    "format": "int32"
                  },
                  "entity_type": {
                    "type": "string",
                    "description": "Tipo de entidad cuyo ID fue proporcionado. Puede ser `leads` y `contacts`.",
                    "enum": [
                      "leads",
                      "contacts"
                    ]
                  }
                },
                "required": [
                  "entity_id",
                  "entity_type"
                ]
              }
            }
          }
        },
        "summary": "Lanzar un Salesbot"
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```