O que é
O connector oficial da Vendizap liga sua loja a assistentes de inteligência artificial compatíveis com o padrão MCP (Model Context Protocol), como o Claude e o ChatGPT. Com a conexão ativa, você pede em linguagem natural — "quais pedidos entraram hoje?", "aumenta o preço da linha de camisetas em 10%", "marca o pedido 812 como enviado" — e o assistente executa na sua loja, usando a mesma API oficial que os ERPs integrados usam.
Não é preciso instalar nada nem escrever código. A conexão é autorizada por você, dentro da sua conta Vendizap, e pode ser desfeita a qualquer momento.
Requisitos
- Plano PRO ou Empresarial. O plano PLUS não tem acesso à API.
- Conta de lojista. Contas de membro (usuários convidados para operar a loja) não conseguem autorizar a conexão.
- Assinatura em dia — com fatura vencida, a autorização é recusada.
- Um assistente que aceite connectors MCP remotos, como o Claude ou o ChatGPT.
Como conectar
-
Procure por Vendizap na lista de aplicativos e
connectors do seu assistente e escolha conectar. Se ainda não
encontrar por lá, adicione manualmente informando o endereço
https://api-docs.vendizap.com/mcp— a opção costuma aparecer como "adicionar connector personalizado" ou equivalente. - Você será levado à tela de login da Vendizap. Entre com o e-mail e a senha da sua conta.
- Na tela de autorização, confira qual aplicativo está pedindo acesso e confirme. Pronto: o assistente já pode trabalhar na sua loja.
Se sua conta usa verificação em duas etapas, o código é pedido durante esse login, como em qualquer outro acesso.
O que o assistente pode fazer
| Área | Consultar | Alterar |
|---|---|---|
| Produtos | lista e detalhes, preços, códigos, detalhes de venda | cadastrar, editar e alterar dados parciais |
| Categorias | lista e detalhes, hierarquia | cadastrar e editar |
| Variações e grades | variações da loja, variações do produto, combinações (SKUs) | criar, editar, vincular ao produto e excluir |
| Estoque | quantidade por produto e por combinação | atualizar quantidades |
| Pedidos | lista por data ou período, detalhes, itens, valores e pagamento | avançar ou regredir a etapa de andamento |
| Descontos progressivos | lista e detalhes das faixas | criar, editar e excluir |
| Conta | dados cadastrais da sua conta e endereços da loja | — |
A lista completa das operações, com todos os campos, está na documentação da API.
Segurança e controle
- A conexão só existe depois que você aprova, logado na sua conta. Nada é conectado automaticamente.
- Você acompanha e desfaz as conexões em Conta › Segurança › Aplicativos conectados, onde vê qual aplicativo está conectado, quando foi autorizado e quando foi usado pela última vez. Pode revogar uma ou todas.
- A revogação vale na hora: o assistente perde o acesso imediatamente.
- Trocar ou recuperar a senha da conta desfaz todas as conexões existentes, por segurança.
- Cada conexão vale 90 dias e se renova enquanto o assistente estiver em uso.
- Você recebe um e-mail sempre que uma nova conexão é criada.
Limitações
O que o connector não faz hoje:
- Não cria pedidos. Pedidos continuam nascendo na sua vitrine ou no PDV; pelo assistente você consulta e atualiza a etapa de andamento.
- Não movimenta dinheiro. Marcar a etapa de pagamento apenas registra que o pedido foi pago — por exemplo, dinheiro na entrega. Em pedidos com cobrança eletrônica (carteira, link de pagamento ou Pix) essa marcação é recusada.
- Não envia mensagens aos seus clientes e não opera o WhatsApp da loja.
- Não faz upload de imagens. Fotos de produto continuam sendo enviadas pelo painel.
- Não gerencia usuários, membros nem permissões, e não altera configurações da loja, formas de pagamento ou entrega.
- Opera apenas a conta principal. Quem tem mais de uma loja ou trabalha com vendedores vinculados não escolhe a loja na conexão, e pedidos de vendedores vinculados não são alterados.
- Há limite de uso por hora. No plano PRO são 150 requisições por hora; no Empresarial, sem limite prático. Uma conversa longa, com muitas alterações em sequência, pode atingir o limite do PRO e precisar esperar.
- A conexão expira em 90 dias se o assistente ficar sem uso — basta autorizar de novo.
- O assistente é quem decide como usar as ferramentas a partir do seu pedido. Confira o resultado de alterações em massa antes de considerá-las prontas, como faria com qualquer automação.
Suporte
Dúvidas, problemas de conexão ou sugestões: suporte@vendizap.com.