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

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

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.

Example request

{
  "country_code": "55",
  "operator_id": "6ad651876xxxxxxxxxxxxx",
  "recipient_number": "+55 11 999-888-777",
  "sent_by": "bot",
  "template_message_id": "6ad651876xxxxxxxxxxxxx",
  "variables": [
    "Bom dia",
    "João"
  ]
}

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.

Example response

{
  "data": {
    "id": "6ad651876xxxxxxxxxxxxx",
    "sent_by": "operator",
    "status": "checked"
  },
  "message": "Message successfully sent"
}

Changes

No recorded changes to this operation across all 1 revision of this API.