Ligue a Zoppy a qualquer sistema da loja

O Zoppy Connect liga a Zoppy a qualquer outro sistema que a loja usa: um ERP, um PDV, uma plataforma na nuvem ou um sistema instalado no computador da loja, sem API na internet. A pessoa da loja descreve o que quer numa conversa; a IA pesquisa a documentação do sistema, escreve a integração, testa contra o sistema de verdade, mostra o que aconteceria e só então liga.

Cada integração é um conector: um arquivo de código e um manifesto que diz no que ele pode mexer. Ninguém escreve código à mão. O conector roda no horário que o manifesto define (a cada 5 a 1.440 minutos), sempre isolado e passando pelo gateway do Connect, que só deixa sair o que o manifesto declara.

Por onde começar

Para a loja

Sem código: liberar o acesso, construir uma integração conversando, ensaiar, publicar, confirmar escritas e acompanhar as execuções.

Abrir Implantação e suporte

Instalar e parear o agente local na máquina da loja, liberar o que ele alcança e diagnosticar o agente fora do ar.

Abrir Como funciona

A arquitetura e o modelo de segurança: gateway, isolamento do código, segredos, agente local e separação entre lojas.

Abrir Referência técnica

Como um conector funciona por dentro: o SDK (ctx), o manifesto, a API de Parceiros da Zoppy, os erros e os limites.

Abrir API do Connect

As rotas da API do Connect, geradas do OpenAPI, com parâmetros, respostas e exemplos.

Abrir CLI e MCP

Escrever, ensaiar e publicar conectores do editor, ou consultar e operar o Connect por uma IA.

Abrir

O que dá para fazer

• Sistema na nuvem → Zoppy: trazer clientes, pedidos e produtos de um ERP ou plataforma com API.
• Zoppy → sistema na nuvem: mandar pedidos ou clientes da Zoppy para outro sistema.
• Sistema local → Zoppy: ler o banco de dados do ERP instalado na loja (SQL Server, Oracle, Firebird, MySQL ou Postgres) ou uma API interna, pelo agente local, sem abrir porta nenhuma. O sistema local é só leitura.

Regras que valem sempre

1. Nada roda sem ensaio. O ensaio lê de verdade, mas não grava nada: as escritas viram “a requisição que eu mandaria”. A exceção são as consultas por POST, PUT ou PATCH que o manifesto declara como leitura (readRoutes, aprovadas junto com o host): essas saem de verdade, e o resultado do ensaio lista cada uma para conferir. Publicar exige um ensaio completo limpo e o sim de uma pessoa.
2. A primeira escrita em cada sistema espera confirmação. Uma pessoa vê a requisição exata e confirma; depois disso, o conector escreve normalmente.
3. Nunca apaga nada na Zoppy, e o que vai para outro sistema não tem desfazer.
4. Segredos nunca passam pelo chat. Senhas e tokens são preenchidos num formulário à parte e o código nunca vê o valor.
5. Registro recusado não para a integração. Ele vai para a quarentena com o motivo; dá para corrigir e reprocessar só ele.

Para uma IA

A documentação inteira está em texto puro, para ler de uma vez: /llms.txt (o índice), /llms-full.txt (tudo) e /llms-small.txt (versão enxuta).