> ## Documentation Index > Fetch the complete documentation index at: https://docs.1to1ai.com/llms.txt > Use this file to discover all available pages before exploring further. # Detalle de template por name + language > Detalle de un template específico por `name` + `language` — la natural key que maneja Meta y que tu CRM ya conoce. Retorna los `parameters` calculados (body variables, header, button parameters) — usalo para armar el body de `POST /conversation/messages/template` sin tener que parsear el shape de Meta. **Por qué `name` + `language` y no `uuid`:** el uuid interno no aparece en la UI ni en la API de Meta. El cliente conoce el template por el nombre que ve en el dashboard. Aceptamos cualquier casing y normalizamos server-side (`CONFIRMACION_CITA` → `confirmacion_cita`, `es_mx` → `es_MX`). **Por qué retornar parámetros calculados:** Meta serializa los placeholders inline (`{{1}}`, `{{2}}`, …) en `components`. Calcular esto del lado cliente requeriría replicar la lógica del helper interno. La API lo entrega ya parseado. ## OpenAPI ````yaml /openapi.json get /{slug}/templates/{name}/{language} openapi: 3.1.0 info: title: 1TO1 AI Public API version: 0.2.0 description: >- API pública de 1TO1 AI para integraciones externas (n8n, CRMs, scripts). Auth via Bearer token. Rate limit 60 req/min por API key. Contrato REST puro: el body de éxito es el payload directo (status HTTP como señal), errores retornan `{code, message}` con ambos campos garantizados. Ver schema `PublicError`. servers: - url: https://app.1to1.ai/api/v1/public description: Producción security: - bearerAuth: [] paths: /{slug}/templates/{name}/{language}: get: tags: - Templates summary: Detalle de template por name + language description: >- Detalle de un template específico por `name` + `language` — la natural key que maneja Meta y que tu CRM ya conoce. Retorna los `parameters` calculados (body variables, header, button parameters) — usalo para armar el body de `POST /conversation/messages/template` sin tener que parsear el shape de Meta. **Por qué `name` + `language` y no `uuid`:** el uuid interno no aparece en la UI ni en la API de Meta. El cliente conoce el template por el nombre que ve en el dashboard. Aceptamos cualquier casing y normalizamos server-side (`CONFIRMACION_CITA` → `confirmacion_cita`, `es_mx` → `es_MX`). **Por qué retornar parámetros calculados:** Meta serializa los placeholders inline (`{{1}}`, `{{2}}`, …) en `components`. Calcular esto del lado cliente requeriría replicar la lógica del helper interno. La API lo entrega ya parseado. parameters: - $ref: '#/components/parameters/SlugPathParam' - schema: type: string minLength: 1 maxLength: 512 pattern: ^[a-zA-Z0-9_]+$ example: confirmacion_cita description: >- Nombre del template tal como aparece en el dashboard. Alfanumérico + underscore. Aceptamos cualquier casing — server normaliza a lowercase. required: true description: >- Nombre del template tal como aparece en el dashboard. Alfanumérico + underscore. Aceptamos cualquier casing — server normaliza a lowercase. name: name in: path - schema: type: string minLength: 2 maxLength: 10 pattern: ^[a-zA-Z]{2,3}(_[a-zA-Z]{2,3})?$ example: es_MX description: >- Código de idioma Meta: `es`, `es_MX`, `en_US`, `pt_BR`. Server normaliza a `lower_UPPER`. required: true description: >- Código de idioma Meta: `es`, `es_MX`, `en_US`, `pt_BR`. Server normaliza a `lower_UPPER`. name: language in: path responses: '200': description: Detalle del template con parámetros calculados. headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/TemplateDetailResponse' '400': description: Parámetros del path inválidos (INVALID_REQUEST). headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '401': description: Token ausente, mal formado o no válido (INVALID_API_TOKEN) headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '403': description: >- El slug del path no coincide con el business del token (TOKEN_BUSINESS_MISMATCH) headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '404': description: >- No existe un template con ese name + language en el business (TEMPLATE_NOT_FOUND). headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '409': description: >- Multi-canal: el business tiene el mismo (name, language) en 2+ canales de WhatsApp (TEMPLATE_AMBIGUOUS). Edge raro — contactar soporte. headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '422': description: >- El template existe pero no está APPROVED (TEMPLATE_NOT_APPROVED). Status en Meta es PENDING o REJECTED. headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '429': description: >- Rate limit excedido (RATE_LIMIT_EXCEEDED). Headers `Retry-After`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` indican cuándo reintentar. headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '500': description: Error inesperado del servidor (UNKNOWN_ERROR) headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' components: parameters: SlugPathParam: schema: $ref: '#/components/schemas/SlugPathParam' required: true description: >- Slug del business, case-insensitive. Debe coincidir con el business del token. name: slug in: path schemas: TemplateDetailResponse: type: object properties: data: $ref: '#/components/schemas/TemplateSummary' required: - data PublicError: type: object properties: code: type: string example: INVALID_API_TOKEN message: type: string example: >- The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token. required: - code - message description: >- Public API error body. The client should match against `code` (stable canonical identifier) and NOT against `message` (human text, may be refined between API versions without notice). The HTTP status code is the error-type signal (4xx client, 5xx server). SlugPathParam: type: string example: acme description: >- Slug del business, case-insensitive. Debe coincidir con el business del token. TemplateSummary: type: object properties: uuid: type: string format: uuid name: type: string example: confirmacion_cita language: type: string example: es_MX status: type: string example: APPROVED description: >- Estado en Meta. La API pública solo expone APPROVED por diseño — los demás se ocultan. category: type: string example: UTILITY description: 'Categoría Meta: `MARKETING`, `UTILITY`, `AUTHENTICATION`.' body_text: type: - string - 'null' description: Body crudo aprobado en Meta (con placeholders `{{1}}`, `{{2}}`, …). parameters: $ref: '#/components/schemas/TemplateParameters' required: - uuid - name - language - status - category - body_text - parameters description: Template aprobado para usar en envíos y schedules. TemplateParameters: type: object properties: body_variables: type: array items: $ref: '#/components/schemas/TemplateBodyVariable' header_parameter: allOf: - $ref: '#/components/schemas/TemplateHeaderParameter' - type: - object - 'null' button_parameters: type: array items: allOf: - $ref: '#/components/schemas/TemplateButtonParameter' - description: Parámetro dinámico de botón URL. required: - body_variables - header_parameter - button_parameters description: >- Conjunto completo de placeholders del template — informa qué `body_variables`, `header` y `button_parameters` hay que enviar al usar el template. TemplateBodyVariable: type: object properties: index: type: integer minimum: 1 example: 1 description: Posición 1-based del placeholder en el body (`{{1}}`, `{{2}}`, …). example: type: - string - 'null' description: Valor de ejemplo cargado en Meta al aprobar el template, si existe. example: Ana required: - index - example description: Variable del body del template. TemplateHeaderParameter: type: object properties: type: type: string enum: - text - image - video - document example: image example: type: - string - 'null' description: >- Texto de ejemplo (header text) o handle del media (header media) cargado en Meta. required: - type - example description: >- Parámetro del header del template, si el template tiene header con placeholder. TemplateButtonParameter: type: object properties: subType: type: string enum: - url index: type: integer minimum: 0 example: 0 text: type: string example: ver-promo required: - subType - index - text description: >- Parámetro para botón de tipo URL con placeholder dinámico. `text` reemplaza `{{1}}` en la URL del botón. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: sk_1to1_ description: >- API token emitido desde Settings → API Token del dashboard 1TO1 AI. Enviar en header Authorization: Bearer sk_1to1_... ````