Script para inserir no seu site
Cole esta linha antes do fechamento da tag </body>.
O endereço abaixo é o deste servidor (https://multiagent.ztechnologies.io).
<script src="https://multiagent.ztechnologies.io/widget.js" defer></script>Uso do agente
Conectar WhatsAppUsuários usando o agente
·
ativos nos últimos 15 min
Usuários no total
·
conversas já atendidas
Conversas ativas por canal
Conversas encerradas
Baixe o JSON do cliente e da conversa para análise (pede a senha).
Log de erros de integrações/API
Mostra erros recentes das APIs usadas pelos agentes. Use Ver / Copiar para inspecionar requisição e resposta.
Status das integrações
Saúde das APIs configuradas no ambiente (somente integrações ativas).
Arquitetura da solução
documentação — canais → app (Python) → agentes + skills → APIs
1 · Canais (entrada do cliente)
WhatsApp (Evolution API)
Widget Web (/chat, iframe)
Telegram
▼ webhook / HTTP (áudio e PDF via mídia)
2 · Aplicação (Python — só biblioteca padrão + openai + dotenv)
web_chat.py · painel + HTTP (http.server)
orchestrator.py · Atendimento/sessões
providers.py · LLM (Anthropic/OpenAI/Gemini)
whatsapp_evolution.py · webhook/mídia/voz
audio_openai.py · STT/TTS
crm_ztech.py · cliente ZCRM
Libs: stdlib (http.server, urllib, json, xml.etree, threading, subprocess) ·
openai (LLM + áudio) · python-dotenv ·
postgresql-client (pg_dump/restore da Evolution)
▼ compõe o system prompt: núcleo + skills + prompt do agente
3 · Agentes + Skills (prompts compostos)
Agentes (config.AGENTES):
🧭 James · triagem
💼 Vitor · vendedor
🗓️ Sara · secretária
📊 Gabriel · projetos
🛠️ Ted · técnico
🔐 Lia · portal
👥 Helena · RH
Skills reutilizáveis (prompts/skills/*.md, injetadas por agente):
handoff-ponte
falha-api-empatia
identidade-e-credenciais
lead-pre-vendas
ordem-servico-chamado
senha-projeto-documentos
proposta-zcrm
limite-entrega-chat
entrega-humanizada-listas
Veja quais skills cada agente usa em Fluxo dos agentes (chips violeta em cada card).
▼ ferramentas (tools) chamadas pelos agentes
4 · APIs / serviços externos
ZCRM (leads, contratos, chamados, backlog/sprints, agenda, RH)
OpenAI (LLM · Whisper STT · TTS)
Evolution API (WhatsApp)
Google Calendar
Trello (funil)
Geo/Clima (saudação por IP)