Skip to main content
Os agentes de IA do Tivar são respondentes automáticos que assumem conversas sem intervenção humana. Você os configura pelo painel, define instruções e comportamentos, e pode atribuí-los a novas conversas diretamente via API — seja no momento de enviar uma mensagem ou de disparar um template HSM.

​
Criar e configurar um agente de IA

Acesse Configurações → Agentes de IA no painel do Tivar para criar um novo agente. Defina o nome, as instruções de comportamento e os canais em que ele deve atuar. Cada agente recebe um identificador único (agentId) que você usará nas chamadas de API.
Para encontrar o agentId de um agente, abra as configurações dele no painel do Tivar. O UUID aparece na URL da página ou nos detalhes do agente.

​
Atribuir um agente via API

Passe o campo agentId no corpo de qualquer chamada a /api/v1/send-message ou /api/v1/send-template. Quando presente, o Tivar atribui automaticamente a conversa criada (ou reaberta) ao agente informado. 
curl -X POST https://<seu-dominio>/api/v1/send-message \
  -H "Authorization: Bearer sk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "5511999998888",
    "message": "Olá! Em que posso ajudar?",
    "channel": "whatsapp-official",
    "agentId": "uuid-do-agente"
  }'
O mesmo campo funciona em /api/v1/send-template: 
curl -X POST https://<seu-dominio>/api/v1/send-template \
  -H "Authorization: Bearer sk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "5511999998888",
    "channel": "whatsapp-official",
    "templateName": "boas_vindas",
    "language": "pt_BR",
    "variables": ["Maria"],
    "agentId": "uuid-do-agente"
  }'

​
Evento de atribuição via webhook

Sempre que uma conversa é atribuída ou reatribuída — inclusive a um agente de IA —, o Tivar dispara o evento conversation.assigned. Quando a atribuição é para um agente de IA, o campo assigned_to_type tem o valor "agent". 
{
  "event": "conversation.assigned",
  "workspace_id": "uuid-do-workspace",
  "conversation_id": "uuid-da-conversa",
  "status": {
    "assigned_to_type": "agent",
    "assigned_to_id": "uuid-do-agente"
  }
}

​
Handoff para atendimento humano

Os agentes de IA podem transferir a conversa para um membro humano da equipe quando necessário — por lógica configurada no próprio agente ou por regras do fluxo de atendimento. Quando a transferência ocorre, o Tivar dispara novamente o evento conversation.assigned com assigned_to_type: "human". 
{
  "event": "conversation.assigned",
  "workspace_id": "uuid-do-workspace",
  "conversation_id": "uuid-da-conversa",
  "status": {
    "assigned_to_type": "human",
    "assigned_to_id": "uuid-do-membro"
  }
}

​
Caso de uso: triagem automática com n8n

Um fluxo típico com agentes de IA e n8n funciona assim:
  1. O n8n recebe o evento message.received via webhook.
  2. O n8n chama /api/v1/send-message passando o agentId desejado.
  3. O agente de IA assume a conversa e responde automaticamente.
  4. Se o agente não conseguir resolver, ele transfere para um humano — o webhook conversation.assigned com assigned_to_type: "human" sinaliza ao n8n que a conversa foi escalada.