Atendente IA
O hook de agente entrega cada mensagem recebida a um atendente de IA e envia a resposta pela fila normal (ritmo, janela, rampa, suspensão), com pausa quando um humano responde, proteção contra loop e um chat por vez. O destino é a sua URL (target: url, POST assinado) ou o Atendente LiteZap embutido (target: builtin): a IA roda dentro do motor, com agentes por instância (modo vendedor, facilitador de pedido, SDR/agendamento ou suporte), base de conhecimento, transcrição de áudio, imagens para o modelo e resposta em voz opcional. O provedor (Anthropic ou OpenAI-compatível) e as chaves são do admin; as chaves ficam cifradas e nunca voltam na API. O passo a passo está em Atendente IA.
Conceito: leia antes de integrar.
Operações
| Operação | Rota | Token |
|---|---|---|
| Ler hook de agente | GET /v1/instances/{id}/agent-hook | token da instância ou admin |
| Configurar hook de agente | PUT /v1/instances/{id}/agent-hook | token da instância ou admin |
| Remover hook de agente | DELETE /v1/instances/{id}/agent-hook | token da instância ou admin |
| Ligar ou desligar o atendente numa conversa | PUT /v1/instances/{id}/chats/{jid}/agent | token da instância ou admin |
| Últimas chamadas do atendente | GET /v1/instances/{id}/agent-hook/calls | token da instância ou admin |
| Ler o Atendente LiteZap | GET /v1/instances/{id}/attendant | token da instância ou admin |
| Configurar provedor do atendente | PUT /v1/instances/{id}/attendant | token admin |
| Modos prontos do atendente | GET /v1/instances/{id}/attendant/presets | token da instância ou admin |
| Listar agentes | GET /v1/instances/{id}/attendant/agents | token da instância ou admin |
| Criar agente | POST /v1/instances/{id}/attendant/agents | token da instância ou admin |
| Ler agente | GET /v1/instances/{id}/attendant/agents/{agent_id} | token da instância ou admin |
| Alterar agente | PUT /v1/instances/{id}/attendant/agents/{agent_id} | token da instância ou admin |
| Excluir agente | DELETE /v1/instances/{id}/attendant/agents/{agent_id} | token da instância ou admin |
| Ativar agente | POST /v1/instances/{id}/attendant/agents/{agent_id}/activate | token da instância ou admin |
| Simular conversa | POST /v1/instances/{id}/attendant/simulate | token da instância ou admin |
| Uso e custo do atendente | GET /v1/instances/{id}/attendant/usage | token da instância ou admin |
Eventos relacionados
Gerado de openapi.yaml. Convenções gerais na visão geral e todos os códigos em Erros.