---
title: "Enviar mensagem a partir de template"
method: POST
path: "/v3/messages/template/send"
tags: ["conversas-v2-templates"]
---

# Enviar mensagem a partir de template

`POST /v3/messages/template/send`

ℹ️ Este recurso está disponível apenas na nova versão da API (v3).

⚠️ **Importante:** O envio dessa mensagem não cria um atendimento e, por isso,
ela não aparecerá no histórico caso o contato responda.
A resposta iniciará um novo atendimento, sem vínculo com a mensagem original enviada pela API.

**Sobre o status 201:** O status 201 indica apenas que a requisição foi recebida e
processada com sucesso pela API do RD Conversas. Ele **não garante** que a mensagem
foi entregue ao destinatário final. Falhas de template ou entrega podem ser verificadas
apenas na plataforma.

Este recurso permite enviar mensagens de template passando o número de telefone do contato.

## Request body

- SendMessageTemplateRequest
  - `country_code` string — Código do país do destinatário.
  - `operator_id` string, hash — ID do operador que enviou a mensagem. Obrigatório se `sent_by` for `operator`.
  - `recipient_number` string, required — Número do destinatário. O número deve estar no formato E.164.
  - `sent_by` 'bot' | 'operator' — Quem enviou a mensagem. Pode ser 'operator' ou 'bot'.
  - `template_message_id` string, hash, required — ID da mensagem de template.
  - `variables` string[] — Variáveis para substituir campos do template.

## Response `201`

Requisição aceita e processada pela API. Não garante entrega ao destinatário final;
falhas de template ou entrega podem ser verificadas na plataforma.

- SendMessageTemplateResponse
  - `data` object — Informações da mensagem enviada.
    - `id` string, hash — ID da mensagem enviada.
    - `sent_by` string — Por quem a mensagem foi enviada.
    - `status` string — Status da mensagem no momento.
    - `template` object — Informações do template.
      - `content` string — Conteúdo puro do template.
      - `id` string, hash — ID do template.
  - `message` string — Mensagem de sucesso.

## Other responses

- `400` — Bad request
- `401` — Access Token missing or invalid
- `403` — Not authorized to access such resource
- `404` — Resource not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/rdstation/apis/webhook-service.md) · [All operations](https://skmtc.net/rdstation/apis/webhook-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rdstation/webhook-service/revisions/3867c21388e8/schema)