Projeto Service Up
Middleware de atendimento entre conversas, bots e chamados
Middleware que conecta conversas, fluxos automatizados e chamados com sessões, pausa, retomada e estado compartilhado.

Por que esse sistema foi necessário
A operação precisava conectar conversas, fluxos automatizados e chamados sem depender de repasses manuais entre Chatwoot, Typebot e Znuny.
O que precisava mudar
Cada plataforma tinha seu próprio tempo de resposta, formato e estado. Sem middleware, pausas, retomadas, arquivos e abertura de chamados ficariam frágeis na rotina de atendimento.
Como a solução organiza a operação
A solução cria um middleware que recebe webhooks, gerencia sessões, agrupa mensagens, aciona fluxos e integra chamados mantendo estado fora das plataformas externas.
O que a operação passa a controlar
- Conversas, bots e chamados deixam de depender de acompanhamento manual entre sistemas.
- O estado da conversa permite pausar, retomar e finalizar fluxos com mais previsibilidade.
- Mensagens sequenciais são agrupadas antes de acionar automações externas.
Área técnica
Como a solução foi organizada
A próxima seção detalha como a solução foi organizada tecnicamente: componentes, integrações, filas, armazenamento e pontos de controle.
Arquitetura entre conversa, bot e chamado
01
Chatwoot
Conversas e webhooks
webhook
02
Bot v2 FastAPI
Sessões, pausa, retomada e regras
estado
03
Redis
Estado e agrupamento de mensagens
fluxo
04
Typebot
Fluxos automatizados
chamado
05
Znuny via VPN
Abertura e atualização de chamados
arquivos
06
MinIO
Arquivos temporários
Decisões técnicas
- Separar API e webhooks em instâncias Swarm evita bloqueios entre chamadas do Typebot e processamento de mensagens.
- Guardar estado de sessão no banco e no Redis permite pausar, retomar e finalizar fluxos com previsibilidade.
- Agrupar mensagens sequenciais antes de chamar automações reduz ruído e melhora o contexto enviado ao bot.
Operação e continuidade
- Processamento em background absorve esperas, respostas tardias e diferenças entre APIs.
- Estado compartilhado permite retomar conversas e chamados sem depender de memória manual.
Arquitetura
- Chatwoot recebe as conversas e aciona o middleware por webhook.
- Typebot conduz o fluxo e retorna texto, mídia, botões e listas.
- Redis mantém estado e agrupa mensagens enviadas em sequência.
- Znuny recebe chamados por uma integração protegida por VPN.
Tecnologias
- FastAPI
- MySQL
- Redis
- Chatwoot
- Typebot
- Docker Swarm
Capacidades relacionadas
Atendimento e omnichannel
Organize canais, histórico, roteamento e automações para que a operação mantenha contexto de ponta a ponta.
- - Canais sem histórico único
- - Roteamento manual
- - Automações isoladas
Integrações e APIs
Conecte sistemas com contratos claros, webhooks, filas, sincronização e pontos de retomada.
- - Dados duplicados
- - Importação manual
- - Webhooks sem rastreabilidade
IA aplicada
Use copilotos, agentes e classificação onde a IA ganha contexto, permissão e rastreabilidade.
- - Triagem manual
- - Respostas sem contexto
- - Experimentos de IA sem fronteira
Automação
Transforme rotinas sensíveis e repetitivas em fluxos observáveis, recuperáveis e integrados.
- - Conferência manual
- - Filas invisíveis
- - Retomada dependente de pessoas