Como configurar tokens de API (App Token e Access Token), Webhooks e integração com o App Superlógica Condomínios

Este artigo apresenta o passo a passo completo para gerar e gerenciar credenciais de API (App Token e Access Token), configurar e depurar Webhooks de notificações automáticas e parametrizar a integração nativa entre o Superlógica Assinaturas e o aplicativo Superlógica Condomínios.

Problema ou Sintoma

A equipe técnica ou administradora precisa integrar um sistema externo via API com o Superlógica Assinaturas (geração de tokens app_token e access_token), parar de receber alertas de falha de Webhook desativado por e-mail ou corrigir erro de sincronização cadastral no aplicativo integrado Superlógica Condomínios.

Causa Raiz e Regra de Negócio

A API REST do Superlógica Assinaturas exige autenticação dupla no cabeçalho HTTP (app_token identificando a aplicação e access_token identificando a permissão da licença/usuário). Já os gatilhos de Webhooks e apps nativos (como a sincronização de cobranças e clientes com o Superlógica Condomínios) dependem de endpoints ativos que respondam com código HTTP 200; caso uma URL de Webhook retorne erro repetidamente ou um token seja revogado, o sistema dispara alertas administrativos e pausa a fila de sincronização.

Pré-requisitos para Execução

• Perfil de usuário Administrador no Superlógica Assinaturas;
• Acesso ao menu Configurações > Integrações / API e ao menu Apps;
• URL de destino válida (HTTPS) caso utilize Webhooks próprios, ou credenciais da licença alvo na integração com Condomínios.

Passo a Passo de Resolução no Sistema

1. Para gerar ou renovar o App Token e o Access Token da API:
   • No canto superior direito do Superlógica Assinaturas, clique no ícone de engrenagem (Configurações) ou no menu do seu usuário e selecione Integrações / API (Tokens de Acesso);
   • Clique em Novo Token / Gerar Credenciais, informe um nome identificador para a integração (ex.: Portal Checkout ou ERP Interno) e copie os valores gerados de app_token e access_token;
2. Para gerenciar ou excluir Webhooks que estão gerando erro por e-mail:
   • Acesse Apps > Webhooks (ou Configurações > Notificações via Webhook);
   • Localize o endpoint antigo ou inativo que está retornando falha HTTP (404/500), desative-o ou clique em Excluir e limpe a fila de retentativas pendentes;
3. Para sincronizar o App Superlógica Condomínios:
   • Acesse o menu Apps > Superlógica Condomínios no Assinaturas;
   • Confira se os tokens de comunicação entre as duas licenças estão ativos e valide se os cadastros de clientes/condomínios possuem CPF/CNPJ e plano de contas mapeados;
   • Clique em Sincronizar Agora / Reprocessar Fila para atualizar os lançamentos pendentes.

Configurações e Parâmetros Recomendados

Crie um par de tokens exclusivo para cada sistema integrado (nunca compartilhe o mesmo access_token entre múltiplos fornecedores), facilitando a revogação isolada em caso de troca de parceiro tecnológico.

Validação de Sucesso

Realize uma chamada de teste GET no endpoint https://api.superlogica.net/v2/financeiro/clientes enviando app_token e access_token no header: o retorno HTTP 200 com o JSON da carteira confirma que a integração está operacional.

Exceções e Casos Especiais

Caso você tenha excluído um Webhook e ainda receba alguns e-mails residuais de falha de notificação nas horas seguintes, trata-se apenas do esvaziamento das retentativas que já estavam agendadas na fila antes da exclusão; o envio cessa automaticamente após o esgotamento do lote residual.

Erros Comuns e Como Evitá-los

• Enviar os tokens no corpo (body) da requisição em vez do Header HTTP: a API exige os parâmetros app_token e access_token diretamente no cabeçalho da requisição;
• Exceder o limite de requisições por minuto (Rate Limit) em consultas sem paginação: utilize sempre o parâmetro pagina e itensPorPagina nas listagens da API.

Impacto Financeiro, Fiscal ou Operacional

A estabilidade dos tokens de API e Webhooks garante que novas vendas no checkout próprio, baixas de pagamentos e sincronizações com o ERP ocorram em tempo real sem intervenção manual.

Integração com Outros Módulos

A API do Superlógica Assinaturas permite automatizar de ponta a ponta os módulos de Clientes, Planos, Assinaturas Recorrentes, Cobranças (Boleto, PIX e Cartão) e Notas Fiscais.

Boas Práticas Operacionais

Mantenha um registro interno de quais sistemas externos consomem cada token ativo e monitore o log de integrações semanalmente.

Checklist Rápido para o Analista e Cliente

• O usuário que gerou o Access Token permanece ativo e com permissão de Administrador?
• Os headers app_token e access_token estão sendo enviados corretamente na chamada HTTPS?
• Webhooks obsoletos foram desativados/removidos para evitar falsos alertas de erro?

Quando Escalar para o Time Especialista

Escale para o suporte avançado de API/Integrações anexando o cURL completo da requisição (ocultando dados sensíveis de cartão) e o payload de resposta HTTP caso ocorra erro 500 inesperado em um endpoint documentado.

Perguntas Frequentes (FAQ)

1. Se eu bloquear ou excluir um usuário do sistema, o Access Token gerado por ele para de funcionar?
Sim. Como o Access Token herda as permissões do usuário criador, desativar o usuário invalida os tokens vinculados a ele.

2. Onde consulto a documentação técnica dos endpoints da API do Assinaturas?
A documentação interativa com exemplos de payload pode ser consultada na referência oficial da API Superlógica (api.superlogica.net).

Palavras-chave para Busca

app token access token superlogica assinaturas, integracao api assinaturas, erro webhook superlogica, app superlogica condominios integracao, onde gerar token api superlogica