---
title: "Envio de mensagem transacional por canal e template"
method: POST
path: "/enviar-mensagem-transacional"
tags: ["Envio de Mensagens"]
---

# Envio de mensagem transacional por canal e template

`POST /enviar-mensagem-transacional`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api/v1/comunicador`
- URL: `https://integracao.cvcrm.com.br/api/v1/comunicador/enviar-mensagem-transacional`
- Auth: HTTP bearer

> 🔒 **Autenticação necessária**
>
> Esta API utiliza **Bearer Token** no header Authorization.
> Consulte o tutorial completo antes de fazer sua primeira chamada:
> [Como autenticar nas APIs do CV CRM (v3+ — Bearer Token)](https://desenvolvedor.cvcrm.com.br/docs/como-autenticar-nas-apis-do-cv-crm-com-bearer-token)

Envia uma mensagem transacional usando um canal e um template já resolvidos pelo
chamador (por id). Restrito ao painel `gestor` — o JWT precisa ter sido emitido
com `painel: gestor`.

## Request body

- EnviarMensagemTransacional
  - `idcanal` integer, required: Id do canal do Comunicador que enviará a mensagem
  - `idtemplate` integer, required: Id do template transacional a ser enviado
  - `numero_destinatario` string, required: Número de destino, com DDI + DDD
  - `variaveis` object: Variáveis para substituir os placeholders do conteúdo do template (ex. `[[NOME_CLIENTE]]`). Todos os campos são opcionais — só é necessário enviar os que o template efetivamente usa.
    - `nome_cliente` string
    - `nome_atendente` string
    - `nome_empreendimento` string
    - `atendimento_protocolo` string
    - `quantidade_chats` integer
    - `entrega_de_chaves_data` string
    - `entrega_de_chaves_tipo_agendamento` string
    - `id_lead` integer: Quando informado, a URL do `[[URL_LEAD]]` é montada automaticamente pelo servidor a partir deste id.
    - `nome_lead` string
    - `id_reserva` integer

## Response `200`

Requisição processada

- object
  - `status` string
  - `statusCode` integer

## Other responses

- `400`: Requisição inválida
- `404`: Canal ou template não encontrado

---

[API](https://skmtc.dev/cvcrm/apis/comunicador.md) - [All operations](https://skmtc.dev/cvcrm/apis/comunicador/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/comunicador/revisions/83f3c9ab22fa?raw)