Skip to main content
O Tivar combina webhooks outbound — que disparam eventos para URLs externas — com uma API inbound para que ferramentas de automação possam reagir a mensagens e responder em tempo real. Você pode usar n8n, Typebot, Zapier, Voiceflow ou qualquer plataforma que aceite requisições HTTP para construir fluxos completos de atendimento automatizado.

​
Como as automações funcionam

O modelo é bidirecional: o Tivar notifica sua ferramenta de automação quando algo acontece (via webhook), e sua ferramenta chama a API do Tivar para enviar respostas ou iniciar conversas. Os três endpoints principais para automações são:
Caso de usoEndpoint
Responder numa conversa existentePOST /api/external/messages/send
Iniciar uma nova conversaPOST /api/v1/send-message
Enviar template HSM fora da janela de 24hPOST /api/v1/send-template
O endpoint /api/external/messages/send não tem rate limit próprio. Os demais endpoints seguem o limite padrão de 60 requisições por minuto por workspace.

​
Fluxo recomendado

1

Configure o webhook no Tivar

Vá em Configurações → Integrações → Webhooks, clique em Adicionar webhook e informe a URL do seu fluxo no n8n (ou outra ferramenta). Selecione o evento message.received.
2

Receba o payload no n8n

Quando um cliente enviar uma mensagem, o Tivar fará um POST para a URL configurada com o payload do evento. Os campos mais úteis para automações são contact.phone, message.text e conversation_id.
{
  "event": "message.received",
  "workspace_id": "uuid-do-workspace",
  "conversation_id": "uuid-da-conversa",
  "contact": {
    "id": "uuid-do-contato",
    "phone": "5511999998888",
    "name": "João Silva"
  },
  "message": {
    "id": "uuid-da-mensagem",
    "text": "Oi, quero saber sobre meu pedido.",
    "type": "text"
  },
  "status": {
    "assigned_to_type": "agent",
    "assigned_to_id": "uuid-do-agente"
  },
  "integration": {
    "id": "uuid-da-integracao",
    "provider": "whatsapp-official"
  }
}
3

Processe a mensagem na sua ferramenta

Use o n8n, Typebot, Zapier ou Voiceflow para interpretar o conteúdo da mensagem, consultar sistemas externos, aplicar lógica de triagem ou gerar uma resposta.
4

Responda na mesma conversa

Use POST /api/external/messages/send com o conversation_id recebido no payload para enviar a resposta diretamente na conversa do cliente.
5

Inicie novas conversas quando necessário

Para disparos proativos — como notificações ou campanhas —, use POST /api/v1/send-message. O Tivar cria o contato e a conversa automaticamente.
6

Use templates HSM fora da janela de 24h

Se o canal for whatsapp-official e o cliente não interagiu nas últimas 24 horas, use POST /api/v1/send-template com um template HSM aprovado pela Meta.

​
Exemplo: responder numa conversa existente

O endpoint /api/external/messages/send é o mais indicado para automações que reagem a eventos, pois trabalha diretamente com o conversation_id sem criar contatos ou conversas duplicados. 
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"
  }'
Use sender_name para identificar o bot ou o fluxo de automação no histórico da conversa. Isso facilita a auditoria e a identificação de respostas automáticas no painel do Tivar.

​
Fluxo recomendado (resumo)

1. Configure um webhook "message.received" no Tivar apontando para seu fluxo n8n.
2. O n8n recebe o payload e processa a mensagem (contact.phone, message.text).
3. Para responder na mesma conversa, use POST /api/external/messages/send
   com o conversation_id recebido no payload.
4. Para iniciar uma conversa nova (disparo ativo), use POST /api/v1/send-message.
5. Para disparar fora da janela 24h do WhatsApp Oficial, use POST /api/v1/send-template.

​
Ferramentas compatíveis

O Tivar funciona com qualquer ferramenta capaz de fazer requisições HTTP. As mais utilizadas são:
  • n8n — automação de fluxos com nós visuais; ideal para lógica condicional e integrações com CRMs
  • Typebot — chatbots conversacionais com fluxo visual e coleta de dados
  • Zapier — conecta o Tivar a centenas de apps sem código
  • Voiceflow — criação de agentes de voz e texto com IA