Canais suportados
O Tivar conecta sua equipe aos principais canais de mensagens utilizados pelos clientes:WhatsApp Oficial
Integração via Meta Cloud API. Suporta envio de mensagens de texto e templates HSM aprovados pela Meta para contatos fora da janela de 24 horas.
WhatsApp via UAZAPI
Integração alternativa via UAZAPI. Permite envio de mensagens de texto pelo
POST /api/v1/send-message sem exigir aprovação da Meta.Telegram
Receba e envie mensagens de canais e bots do Telegram diretamente na caixa de entrada unificada do Tivar.
Instagram e Messenger
Centralize mensagens diretas do Instagram e do Messenger no mesmo ambiente de atendimento.
Live Chat
Widget de chat em tempo real para o seu site. Conversas entram diretamente na caixa de entrada.
Mercado Livre
Gerencie perguntas e mensagens de compradores do Mercado Livre sem sair do Tivar.
Conceitos fundamentais
Antes de integrar com a API, familiarize-se com os objetos principais do Tivar:Workspace
Ambiente isolado da sua organização. Contém canais, membros, contatos, conversas e a API Key. Tudo na API é escopado ao workspace autenticado.
Conversas
Cada troca de mensagens com um contato gera uma conversa. Conversas podem ser atribuídas a um membro humano ou a um agente de IA, e têm status como aberta ou resolvida.
Contatos
Registros dos seus clientes. O Tivar cria o contato automaticamente ao receber ou enviar a primeira mensagem para um número. Contatos são compartilhados entre todos os canais do workspace.
Integrações
Conexões entre o Tivar e os provedores de canal (Meta, UAZAPI, Telegram, etc.). Cada integração tem um
integrationId que você pode usar nas chamadas de API para especificar por qual canal enviar.Agentes de IA
Bots configuráveis que respondem automaticamente a conversas. Você pode atribuir um agente de IA a uma conversa via API usando o campo
agentId nos endpoints de envio.Webhooks outbound
URLs externas que recebem eventos do Tivar em tempo real — como
message.received e conversation.resolved. Use para acionar automações no n8n, Typebot, Zapier ou qualquer outro sistema.Como a API se encaixa
A API pública do Tivar permite que você envie mensagens de forma programática e reaja a eventos em tempo real via webhooks. Com ela, você pode:- Enviar mensagens ativas para clientes via
POST /api/v1/send-message, criando o contato e a conversa automaticamente se ainda não existirem. - Enviar templates HSM via
POST /api/v1/send-templatepara alcançar clientes fora da janela de 24 horas do WhatsApp Oficial. - Responder em conversas existentes via
POST /api/external/messages/send, ideal para automações que já possuem oconversation_id. - Receber eventos em tempo real configurando webhooks outbound que disparam a cada nova mensagem, atribuição ou resolução de conversa.
Todos os endpoints exigem autenticação via
Authorization: Bearer <workspace_api_key>. Obtenha sua API Key em Configurações → Workspace → API Key.Ferramentas de automação compatíveis
O Tivar funciona nativamente com as principais plataformas de automação sem código:n8n
Use o webhook
message.received como gatilho e o endpoint POST /api/external/messages/send para responder na mesma conversa.Typebot
Construa fluxos de conversa com o Typebot e integre ao Tivar para automatizar o atendimento via WhatsApp ou Live Chat.
Zapier
Conecte o Tivar a centenas de aplicativos via Zapier usando webhooks outbound como gatilho de automações.
Voiceflow
Integre agentes de voz e texto do Voiceflow ao Tivar para atendimento automatizado em múltiplos canais.