O canvas (visão avançada)

Por trás de todo agente Zapito existe um fluxo: um pequeno grafo de nós num canvas. O formulário de configuração o gera e conecta para você, então você nunca parte de um canvas em branco — e a maioria nunca o abre. Ao abrir um bot você cai na visão simples (chat de teste, conhecimento, canais); o canvas fica a um clique atrás de Avançado: editar o fluxo no canvas.

Como é o fluxo gerado

Gatilho do WhatsApp ── Agente de IA ── Checagem de confiança ──(Confiante)── Enviar resposta
                            ▲                   └────────────(Em dúvida)── Transferência humana
                            ┆
                    Base de conhecimento

Um gatilho por plataforma escolhida, um Agente de IA fundamentado pela sua Base de conhecimento, uma Checagem de confiança que envia respostas seguras para Enviar resposta e as em dúvida para Transferência humana, que envia a transcrição por e-mail. Uma mensagem chega num gatilho, percorre os fios, e do outro lado sai uma resposta (ou uma transferência).

Quando você abriria o canvas

• Para filtrar um gatilho por palavras-chave, ou disparar só na primeira mensagem de uma conversa.
• Para ajustar o limite da Checagem de confiança.
• Para conectar uma Ferramenta personalizada e o agente ler dados ao vivo da sua API.
• Para adicionar uma Espera e um ritmo de resposta mais humano.
• Ou só para ver exatamente o que o seu agente faz — cada nó é inspecionável, nada é caixa-preta.

O copiloto de IA

O canvas tem um painel de copiloto de IA: descreva uma mudança em linguagem natural — “só responda mensagens que mencionem pedidos”, “suba a régua de confiança” — e ele edita o fluxo para você. Você revisa o resultado no canvas; nada é aplicado pelas suas costas.

Mecânica do canvas

• Mova o quadro arrastando o fundo, dê zoom com a roda do mouse.
• Adicione nós pela biblioteca de nós (o painel à esquerda).
• Conecte nós clicando numa porta de saída e depois na porta de entrada do próximo nó. Fios curvos mostram o caminho da mensagem.
• Clique num nó para abrir o painel de configuração — cada campo está descrito na referência de nós.

Dois tipos de conexão

• Os fios de fluxo (sólidos) carregam a conversa: gatilho → agente → condição → resposta / transferência.
• Os fios de recurso (tracejados, na porta inferior do agente) conectam capacidades: uma Base de conhecimento ou uma Ferramenta personalizada. Eles não carregam mensagens — dizem ao agente o que ele sabe e pode usar.

Testes

O painel de chat de teste roda o seu fluxo no motor real — o mesmo código dos canais de produção. Cada turno mostra um trace: qual gatilho disparou, o que o agente respondeu e com que confiança, qual ramo a condição tomou. Os fios se animam ao longo do caminho enquanto um teste roda.

Salvamento e estados do bot

As mudanças são salvas automaticamente (com debounce — fechar a aba executa um salvamento final). Pelo menu do cartão do bot você pode pausar um bot: bots pausados ficam mudos em todos os canais até você retomar. Excluir um bot remove o fluxo e as conexões de canal.