Assistentes IA

Como criar e operar assistentes de atendimento (os que respondem o cliente no WhatsApp). Endpoint com typo real: /assistents (sem o segundo a) — não corrija. Passo a passo humano em Atendimento com IA.

Criar em 2 passos

Tentar criar com payload completo grava só o nome e ignora o resto:

const { id } = await (await ctx.post('/assistents', { headers: H, data: { name: 'Agente X' } })).json();
await ctx.put(`/assistents/${id}`, { headers: H, data: { name: 'Agente X', businessType, language, address, schedules, services, questions, departamentId: null } });

• Cache de leitura ~3–4s: após o PUT, o GET imediato devolve o estado antigo — confie no body do PUT e só re-leia após pausa.
• Quota de tokens em GET /assistents/qtd.

Vincular base de conhecimento (RAG)

O vínculo real vive em POST /assistents/{id}/kbs com { kbConfigId } — o campo knowledgeBases do GET é legado. Divisão de trabalho: preço fica no prompt do assistente; FAQ e conteúdo longo vão para o /kb (artigo nasce draft mas já indexa; só aparece no portal com status: published).

Ligar no canal e arquitetura híbrida

• Ligar/desligar por canal: PUT /assistents/config/{whatsapp, waoficial, instagram, email, widget}.
• Handoff fluxo → IA é a subação transfertoAI dentro de um node action (shape em Blocos e armadilhas).
• Arquitetura recomendada: híbrida — o fluxo conduz a parte fixa (apresentação, coleta, mídias) e a IA assume o atendimento livre no ponto do handoff, com o histórico da conversa.