v1

latestOpenAPI 3.0.32026-07-2431396640.5 KB

conversas-v2-templates

Enviar mensagem a partir de template

ℹ️ 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.

post/v3/messages/template/send

Request body

country_codestring

Código do país do destinatário.

operator_idstring hash

ID do operador que enviou a mensagem. Obrigatório se sent_by for operator.

recipient_numberstring 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_idstring hash required

ID da mensagem de template.

variablesstring[]

Variáveis para substituir campos do template.

Response

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.

messagestring

Mensagem de sucesso.