A conexão com a Uappi (documentada historicamente como WapStore — é o mesmo produto) é feita por um par de chaves de API (apiKey e secretKey) gerado no painel da própria loja. A API da Uappi vive no domínio da sua loja — não existe um endereço central da plataforma —, por isso o domínio também faz parte da conexão.

Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.

Antes de começar

• Tenha acesso de administrador ao painel da sua loja Uappi.
• Saiba o domínio da loja (ex.: minhaloja.com.br).
• Gere as chaves no painel da Uappi, em Configurações → Integrações → API → Nova integração.
• Libere os endpoints que a Toca vai consultar: integração nova nasce com tudo bloqueado, e endpoint não liberado responde erro de permissão mesmo em leitura. Libere ao menos pedidos, produtos, clientes, status de pedidos e análise de comissão.

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card Uappi e clique em Conectar.
3. Preencha os três campos:
   • Domínio da loja — ex.: minhaloja.com.br, sem https://.
   • apiKey — a chave gerada no painel da Uappi.
   • secretKey — a chave secreta do mesmo par.
4. Salve. A Toca valida as chaves contra a sua loja antes de gravar: se a autenticação falhar, nada é salvo e o formulário avisa.

O que a Toca acessa

Com a conexão ativa, a Toca lê pedidos, clientes, catálogo de produtos, preços, estoque, status de pedido e análise de comissão da loja. A integração é somente leitura: a Toca não altera nada na sua loja Uappi.

Manutenção da conexão

As chaves apiKey e secretKey não expiram sozinhas: a conexão permanece ativa até você revogar a integração no painel da Uappi ou desconectar na Toca. O token temporário que a API da Uappi emite a cada sessão dura 30 minutos e é renovado automaticamente pela Toca, sem nenhuma ação sua. Por segurança, as chaves salvas não são exibidas de volta — reautorizar exige informá-las de novo.

Problemas comuns

• Erro ao salvar a conexão — a Toca autentica as chaves contra a loja antes de gravar. Confira se o domínio está correto (apenas o domínio, sem https://) e se apiKey e secretKey pertencem à mesma integração criada no painel.
• Acesso negado em uma consulta específica — o endpoint não foi liberado no painel da Uappi. Habilite a rota na integração criada em Configurações → Integrações → API da loja; não é preciso reconectar na Toca.
• Consultas retornam vazio — confirme se há registros no período consultado e se os endpoints correspondentes estão liberados na integração do painel.