---
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`

## Request

- Base URL: `https://api.tallos.com.br`
- URL: `https://api.tallos.com.br/v3/messages/template/send`
- Auth: HTTP bearer

ℹ️ 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.dev/rdstation/apis/rd-station-conversas-api-v2.md) - [All operations](https://skmtc.dev/rdstation/apis/rd-station-conversas-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/rdstation/apis/rd-station-conversas-api-v2/revisions/730a895096d0?raw)