---
updatedAt: 2025-06-08T15:30:26.000Z
agentTools:
  projectIndex: https://es-developers.kommo.com/llms.txt
---

# Obtener una lista de plantillas

Este método te permite obtener una lista de plantillas en tu cuenta.

**Limitaciones**\
El método está disponible con derechos de administrador.

El método solo retorna las plantillas que fueron creadas por la integración actual.

**Encabezado de tipo de datos cuando la solicitud es exitosa**\
Content-Type: application/hal+json.

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

## Parámetros de respuesta

| Parámetro                            | Tipo de dato | Descripción                                                                                                                                                                                                              |
| :----------------------------------- | :----------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                                 | int          | ID de la plantilla.                                                                                                                                                                                                      |
| `account_id`                         | int          | ID de la cuenta a la que pertenece la plantilla.                                                                                                                                                                         |
| `name`                               | string       | Nombre de la plantilla.                                                                                                                                                                                                  |
| `content`                            | string       | Cuerpo de la plantilla (el mensaje que se envía al usuario).                                                                                                                                                             |
| `is_editable`                        | bool         | Define si los usuarios pueden editar la plantilla a través de la interfaz de Kommo.                                                                                                                                      |
| `type`                               | string       | Tipo de plantilla.                                                                                                                                                                                                       |
| `buttons`                            | array        | Arreglo de objetos botones.                                                                                                                                                                                              |
| `buttons[]`                          | obj          | Un objeto botón.                                                                                                                                                                                                         |
| `buttons[][type]`                    | string       | Tipo de botón. Las opciones disponibles son `inline` (botón de texto simple) y `url` (botón de enlace).                                                                                                                  |
| `buttons[][text]`                    | string       | Texto en el botón.                                                                                                                                                                                                       |
| `buttons[][url]`                     | string       | URL del botón de tipo `url`.                                                                                                                                                                                             |
| `attachment`                         | object\|null | Objeto del archivo añadido a la plantilla.                                                                                                                                                                               |
| `attachment[id]`                     | string       | UUID del archivo adjuntado a la plantilla.                                                                                                                                                                               |
| `attachment[name]`                   | string       | Nombre del archivo (se pasará al mensajero).                                                                                                                                                                             |
| `attachment[type]`                   | string       | Tipo de archivo (imagen, archivo, documento, video).                                                                                                                                                                     |
| `attachment[is_external]`            | bool         | Indicador de que el archivo proviene de un servicio de archivos. Para todas las plantillas añadidas desde la primavera de 2022, retorna `true`.                                                                          |
| `created_at`                         | int          | Indica cuándo fue añadida la plantilla en formato Unix Timestamp.                                                                                                                                                        |
| `updated_at`                         | int          | Indica cuándo fue actualizada por última vez la plantilla en formato Unix Timestamp.                                                                                                                                     |
| `external_id`                        | string       | ID externo de la plantilla. ID de la plantilla en tu sistema.                                                                                                                                                            |
| `review_status`                      | string\|null | Estado de la plantilla de WhatsApp:`approved`/`review`/`paused`/`rejected`.  **El parámetro GET with es obligatorio**.                                                                                                   |
| `is_on_review`                       | null\|bool   | Indica si la plantilla está siendo revisada. **El parámetro GET with es obligatorio**.                                                                                                                                   |
| `waba_footer`                        | string       | Pie de página de la plantilla de WhatsApp.                                                                                                                                                                               |
| `waba_category`                      | string       | Categoría de la plantilla de WhatsApp. Las siguientes categorías están disponibles: `UTILITY`/`AUTHENTICATION`/`MARKETING`.                                                                                              |
| `waba_language`                      | string       | Idioma de la plantilla de WhatsApp.                                                                                                                                                                                      |
| `waba_examples`                      | obj          | Ejemplos de cómo reemplazar los elementos de formato de la plantilla de WhatsApp. Ejemplo: `"waba_examples":{"{{lead.name}}":"qwerty"}`.                                                                                 |
| `waba_header`                        | string       | Encabezado de la plantilla de WhatsApp con un límite de hasta 60 caracteres.                                                                                                                                             |
| `waba_header_type`                   | string       | Tipo de encabezado de la plantilla de WhatsApp. Opciones disponibles: text (plantilla de WhatsApp con un encabezado de texto), media (plantilla de WhatsApp con un encabezado de medios, debe haber un archivo adjunto). |
| `_embedded`                          | obj          | Un objeto que contiene la información relacionada con la solicitud.                                                                                                                                                      |
| `_embedded.reviews`                  | array        | Arreglo de estados de la plantilla de WhatsApp. **El parámetro GET with es obligatorio**.                                                                                                                                |
| `_embedded.reviews[][id]`            | int          | ID del estado de la plantilla de WhatsApp. **El parámetro GET with es obligatorio**.                                                                                                                                     |
| `_embedded.reviews[][source_id]`     | int          | ID de la fuente del estado de la plantilla de WhatsApp. **El parámetro GET with es obligatorio**.                                                                                                                        |
| `_embedded.reviews[][reject_reason]` | string       | La razón por la cual la plantilla de WhatsApp fue rechazada. **El parámetro GET with es obligatorio**.                                                                                                                   |
| `_embedded.reviews[][status]`        | string       | Estado de la plantilla de WhatsApp. **El parámetro GET with es obligatorio**.                                                                                                                                            |

# 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/chats/templates": {
      "get": {
        "summary": "Obtener una lista de plantillas",
        "description": "Este método te permite obtener una lista de plantillas en tu cuenta.",
        "operationId": "obtener-una-lista-de-plantillas",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Página de la lista de plantillas",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Número de entidades retornadas por solicitud (máximo 50)",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filter[external_id]",
            "in": "query",
            "description": "Filtrar por ID externo. Un arreglo de varios ID",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "with",
            "in": "query",
            "description": "Este método solo admite el parámetro de reseñas",
            "schema": {
              "type": "string",
              "default": "reviews"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Solicitud exitosa": {
                    "value": "{\n  \"_page\": 1,\n  \"_links\": {\n    \"self\": {\n      \"href\": \"https://example.kommo.com/api/v4/chats/templates?page=1&limit=50\"\n    },\n    \"next\": {\n      \"href\": \"https://example.kommo.com/api/v4/chats/templates?page=2&limit=50\"\n    }\n  },\n  \"_embedded\": {\n    \"chat_templates\": [\n      {\n        \"id\": 734129,\n        \"account_id\": 29439107,\n        \"name\": \"Plantilla de prueba\",\n        \"content\": \"Nuevo contenido. Nombre de contacto - {{contact.name}}\",\n        \"created_at\": 1640200627,\n        \"updated_at\": 1640360627,\n        \"buttons\": [\n          {\n            \"text\": \"Botón 1\",\n            \"type\": \"inline\"\n          },\n          {\n            \"text\": \"Botón 2\",\n            \"type\": \"inline\"\n          }\n        ],\n        \"attachment\": null,\n        \"is_editable\": false,\n        \"external_id\": \"my_external_id\",\n        \"type\": \"waba\",\n        \"waba_footer\": \"my footer\",\n        \"waba_category\": \"UTILITY\",\n        \"waba_language\": \"en\",\n        \"waba_examples\": {\n          \"{{contact.name}}\": \"Mi contacto\"\n        },\n        \"waba_header\": \"Ejemplo de encabezado\",\n        \"waba_header_type\": \"text\",\n        \"review_status\": \"review\",\n        \"is_on_review\": true,\n        \"_embedded\": {\n          \"reviews\": [\n            {\n              \"id\": 36337,\n              \"source_id\": 13232340,\n              \"status\": \"review\",\n              \"reject_reason\": \"\"\n            }\n          ]\n        },\n        \"_links\": {\n          \"self\": {\n            \"href\": \"https://example.kommo.com/api/v4/chats/templates/7349\"\n          }\n        }\n      }\n    ]\n  }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "_page": {
                      "type": "integer",
                      "example": 1,
                      "default": 0
                    },
                    "_links": {
                      "type": "object",
                      "properties": {
                        "self": {
                          "type": "object",
                          "properties": {
                            "href": {
                              "type": "string",
                              "example": "https://example.kommo.com/api/v4/chats/templates?page=1&limit=50"
                            }
                          }
                        },
                        "next": {
                          "type": "object",
                          "properties": {
                            "href": {
                              "type": "string",
                              "example": "https://example.kommo.com/api/v4/chats/templates?page=2&limit=50"
                            }
                          }
                        }
                      }
                    },
                    "_embedded": {
                      "type": "object",
                      "properties": {
                        "chat_templates": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "integer",
                                "example": 734129,
                                "default": 0
                              },
                              "account_id": {
                                "type": "integer",
                                "example": 29439107,
                                "default": 0
                              },
                              "name": {
                                "type": "string",
                                "example": "Plantilla de prueba"
                              },
                              "content": {
                                "type": "string",
                                "example": "Nuevo contenido. Nombre de contacto - {{contact.name}}"
                              },
                              "created_at": {
                                "type": "integer",
                                "example": 1640200627,
                                "default": 0
                              },
                              "updated_at": {
                                "type": "integer",
                                "example": 1640360627,
                                "default": 0
                              },
                              "buttons": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "example": "Botón 1"
                                    },
                                    "type": {
                                      "type": "string",
                                      "example": "inline"
                                    }
                                  }
                                }
                              },
                              "attachment": {},
                              "is_editable": {
                                "type": "boolean",
                                "example": false,
                                "default": true
                              },
                              "external_id": {
                                "type": "string",
                                "example": "my_external_id"
                              },
                              "type": {
                                "type": "string",
                                "example": "waba"
                              },
                              "waba_footer": {
                                "type": "string",
                                "example": "my footer"
                              },
                              "waba_category": {
                                "type": "string",
                                "example": "UTILITY"
                              },
                              "waba_language": {
                                "type": "string",
                                "example": "en"
                              },
                              "waba_examples": {
                                "type": "object",
                                "properties": {
                                  "{{contact.name}}": {
                                    "type": "string",
                                    "example": "Mi contacto"
                                  }
                                }
                              },
                              "waba_header": {
                                "type": "string",
                                "example": "Ejemplo de encabezado"
                              },
                              "waba_header_type": {
                                "type": "string",
                                "example": "text"
                              },
                              "review_status": {
                                "type": "string",
                                "example": "review"
                              },
                              "is_on_review": {
                                "type": "boolean",
                                "example": true,
                                "default": true
                              },
                              "_embedded": {
                                "type": "object",
                                "properties": {
                                  "reviews": {
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "id": {
                                          "type": "integer",
                                          "example": 36337,
                                          "default": 0
                                        },
                                        "source_id": {
                                          "type": "integer",
                                          "example": 13232340,
                                          "default": 0
                                        },
                                        "status": {
                                          "type": "string",
                                          "example": "review"
                                        },
                                        "reject_reason": {
                                          "type": "string",
                                          "example": ""
                                        }
                                      }
                                    }
                                  }
                                }
                              },
                              "_links": {
                                "type": "object",
                                "properties": {
                                  "self": {
                                    "type": "object",
                                    "properties": {
                                      "href": {
                                        "type": "string",
                                        "example": "https://example.kommo.com/api/v4/chats/templates/7349"
                                      }
                                    }
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "204": {
            "description": "204",
            "content": {
              "application/json": {
                "examples": {
                  "Plantillas no encontradas": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "application/json": {
                "examples": {
                  "El usuario no está autorizado": {
                    "value": "{\n  \"title\": \"Unauthorized\",\n  \"type\": \"https://httpstatus.es/401\",\n  \"status\": 401,\n  \"detail\": \"Nombre de usuario o contraseña incorrectos\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "title": {
                      "type": "string",
                      "example": "Unauthorized"
                    },
                    "type": {
                      "type": "string",
                      "example": "https://httpstatus.es/401"
                    },
                    "status": {
                      "type": "integer",
                      "example": 401,
                      "default": 0
                    },
                    "detail": {
                      "type": "string",
                      "example": "Nombre de usuario o contraseña incorrectos"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```