---
title: "Enviar template"
method: POST
path: "/v1/send/template"
tags: ["Templates"]
---

# Enviar template

`POST /v1/send/template`

Envia uma mensagem rápida (template) para um contato. Variáveis posicionais (`var1`, `var2`, …) substituem placeholders na ordem de aparição. Templates com `metaName` exigem status Meta APPROVED. Botões em conexão não oficial fazem fallback para texto numerado.

## Request body

- SendTemplateDto
  - `contact` string, uuid, required — UUID do chat/contato
  - `templateId` string, uuid, required — UUID do template (mensagem rápida)
  - `variables` object — Variáveis posicionais. var1 substitui o 1º placeholder {{…}}, var2 o 2º, etc. (ordem em content depois caption).

## Response `200`

Template enfileirado com sucesso

- SendTemplateResponseDto
  - `response` string, required
  - `id` string, uuid, required — UUID da mensagem criada
  - `messageType` string, required — Tipo efetivo persistido em Message.messageType
  - `templateId` string, uuid, required — UUID do template enviado

## Other responses

- `400` — Template não aprovado, conexão fechada, janela Meta fechada ou variáveis ausentes
- `401` — Não autorizado — chave de empresa inválida ou ausente
- `404` — templateId ou contact não encontrado

---

[API](https://skmtc.dev/liderhub/apis/api-liderhub.md) · [All operations](https://skmtc.dev/liderhub/apis/api-liderhub/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/liderhub/api-liderhub/revisions/cce9b43211ac/schema)