Skip to main content
O endpoint POST /api/external/messages/send envia uma mensagem em uma conversa já existente no Tivar. Diferente do POST /api/v1/send-message, ele não cria contatos nem conversas — a conversa identificada por conversation_id deve existir previamente. Esse endpoint não possui rate limit próprio. Canais suportados: WhatsApp Oficial, WhatsApp (UAZAPI), Telegram e Live Chat.

​
Quando usar este endpoint

Este endpoint é ideal para ferramentas de automação como n8n, Typebot e Voiceflow que recebem o conversation_id de um contato via webhook (por exemplo, o evento message.received) e precisam responder nessa mesma conversa. O fluxo típico é:
  1. O Tivar dispara um webhook message.received com o conversation_id.
  2. A ferramenta de automação processa a mensagem.
  3. A ferramenta chama POST /api/external/messages/send com o conversation_id recebido para responder ao contato.

​
Requisição

POST /api/external/messages/send

​
Headers

HeaderValor
AuthorizationBearer <workspace_api_key> (obrigatório)
Content-Typeapplication/json

​
Parâmetros do body

​
conversation_id
string
required
UUID da conversa no Tivar. A conversa deve existir e pertencer ao workspace autenticado.
​
text
string
required
Texto da mensagem a ser enviada.
​
sender_type
string
default:"agent"
Tipo do remetente. Use "agent" (padrão) para mensagens de atendente ou "system" para mensagens automáticas. Afeta como a mensagem é exibida no histórico da conversa.
​
sender_name
string
Nome exibido como remetente da mensagem. Máximo de 120 caracteres.

​
Resposta de sucesso

200 OK
​
success
boolean
required
true quando a mensagem foi enviada com sucesso.
​
message_id
string
required
UUID da mensagem no Tivar.
​
conversation_id
string
required
UUID da conversa em que a mensagem foi enviada.
​
workspace_id
string
required
UUID do workspace ao qual a conversa pertence.
​
sent_at
string
required
Timestamp ISO 8601 do envio da mensagem.

​
Erros possíveis

StatuserrorO que fazer
400"Parâmetros obrigatórios: conversation_id, text"Verifique se os dois campos obrigatórios estão presentes.
400"sender_type deve ser \"agent\" ou \"system\""Use "agent" ou "system".
400"Integração não está conectada"Reconecte a integração no painel do Tivar.
401"Authorization header ausente"Adicione o header Authorization: Bearer <sua_api_key>.
401"API Key inválida ou não encontrada"Verifique a API Key.
403"Workspace inativo"Workspace suspenso — entre em contato com o suporte.
404"Conversa não encontrada ou não pertence a este workspace"O conversation_id não existe ou pertence a outro workspace.
502"Erro ao enviar via WhatsApp" / "Erro ao enviar via Telegram"Falha no provedor. Aguarde e tente novamente.

​
Exemplos

curl -X POST https://<seu-dominio>/api/external/messages/send \
  -H "Authorization: Bearer sk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation_id": "uuid-da-conversa",
    "text": "Olá! Em que posso ajudar?",
    "sender_type": "agent",
    "sender_name": "Bot Atendimento"
  }'