# Integração Superlógica Assinaturas

![Integração Superlógica Assinaturas](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBOFZsQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--160de6447fd20a40917db5dcc17b5928eb354ed6/simplesdesk-superlogica.png)

Conecte o **Superlógica Assinaturas** ao SimplesDesk e leve o financeiro da recorrência para dentro do WhatsApp: o Agente de IA localiza o cliente, envia a 2ª via do boleto, verifica inadimplência e gera link de troca de cartão; os fluxos montam a régua de cobrança completa — do aviso de inadimplência disparado por webhook até a mensagem com o link do boleto.

## Quando utilizar

- Empresas de **recorrência** (SaaS, serviços, mensalidades) que faturam pela Superlógica Assinaturas;
- **Réguas de cobrança automáticas**: o evento de inadimplência dispara o fluxo com a 2ª via na hora;
- Autoatendimento com **Agente de IA**: cobranças, 2ª via, situação da assinatura e troca de cartão sem passar por atendente.

## Como conectar

1. Acesse **Configurações → Integrações** e clique no card **Superlógica Assinaturas**.
2. Preencha o **App Token** e o **Access Token** — gere os dois em `superlogica.net/usuario` (menu de aplicativos/API). Cada licença tem seus próprios tokens.
3. Clique em **Testar e conectar** — a conexão é validada e fica ativa para toda a conta.

---

## Webhook e etiquetas automáticas

No card da integração você encontra a **URL do webhook**. Cadastre-a na ferramenta de webhooks da Superlógica (cliente criado, status do cliente, cobrança liquidada):

- **Inadimplência** → aplica automaticamente a etiqueta `inadimplente` no contato;
- **Pagamento confirmado** → remove a etiqueta `inadimplente`.

Use as etiquetas para segmentar e alimentar suas réguas de cobrança. Além disso, ao **ganhar uma oportunidade** no CRM, o cliente é cadastrado automaticamente na Superlógica (se ainda não existir) e o ID fica vinculado ao contato.

---

## Agente de IA

Nas configurações do assistente (**Central IA → seu assistente → Integrações**), ative o **Superlógica Assinaturas**:

| Capacidade | O que a IA passa a fazer |
| --- | --- |
| **Localizar cliente** | Por e-mail, CPF/CNPJ ou nome — por padrão tenta o e-mail do contato da conversa |
| **Cobranças + 2ª via** | Lista as cobranças (pendentes por padrão) com vencimento, valor e o **link da 2ª via do boleto**, pronto para enviar |
| **Inadimplência** | Verifica cobranças em atraso e valores antes de negociar ou liberar algo condicionado à adimplência |
| **Reenviar cobrança por e-mail** | 2ª via por e-mail de uma cobrança específica |
| **Troca de cartão** | Gera o link seguro para o cliente atualizar o cartão da assinatura (pagamento recusado, cartão vencido) |
| **Assinaturas** | Consulta plano, valor e situação — somente leitura (cancelamento/migração ficam com o atendente humano) |
| **Abrir ticket** | Registra a solicitação no Superlógica quando o assunto precisa do financeiro/administrativo |

## Nós de fluxo

No editor de fluxos, a categoria **Superlógica** traz três nós:

- **Buscar Cliente Superlógica** — por e-mail, CPF/CNPJ ou nome (vazio = e-mail do contato). Grava `{{variables.superlogica_customer_id}}`, `{{variables.superlogica_customer_nome}}`, `{{variables.superlogica_customer_email}}` e `{{variables.superlogica_customer_count}}`; não encontrou = saída de falha;
- **Cobranças Superlógica** — lista as cobranças do cliente localizado (filtro: *Pendentes*, *Liquidadas* ou *Todas*). A primeira cobrança preenche `{{variables.superlogica_charge_id}}`, `{{variables.superlogica_boleto_link}}` (a 2ª via pública, pronta para enviar), `{{variables.superlogica_charge_valor}}` e `{{variables.superlogica_charge_vencimento}}` — além de `{{variables.superlogica_charge_count}}`;
- **Inadimplência Superlógica** — verifica e **roteia o fluxo**: saída verde = adimplente, amarela = inadimplente, vermelha = erro. Grava `{{variables.superlogica_inadimplente}}`, `{{variables.superlogica_inadimplencia_count}}` e `{{variables.superlogica_inadimplencia_total}}`.

Os nós de cobrança e inadimplência usam automaticamente o cliente do nó Buscar anterior (ou o ID já vinculado ao contato).

## Gatilho: Evento de integração

O gatilho **Evento de integração** escuta dois eventos da Superlógica:

- **Pagamento confirmado** (`pagamento_confirmado`);
- **Cliente inadimplente** (`inadimplente`).

O fluxo dispara com as variáveis `{{variables.superlogica_customer_id}}` · `{{variables.superlogica_valor}}` · `{{variables.superlogica_vencimento}}`.

---

### Exemplo: régua de inadimplência com 2ª via

1. Gatilho **Evento de integração → Superlógica → Cliente inadimplente**;
2. **Cobranças Superlógica** (o cliente já vem identificado pelo evento) busca a cobrança em aberto;
3. **Enviar Mensagem**: "Olá! Consta uma cobrança de R$ {{variables.superlogica_charge_valor}} vencida em {{variables.superlogica_charge_vencimento}}. Segue a 2ª via: {{variables.superlogica_boleto_link}}";
4. Botão **"Problema com o cartão?"** → a IA (ou um atendente) envia o link de troca de cartão.

Quando o pagamento entrar, o webhook remove a etiqueta `inadimplente` — e o evento **Pagamento confirmado** pode disparar um fluxo de agradecimento.

> 💡 A API da Superlógica às vezes devolve erro dentro de uma resposta 200 — a plataforma trata isso e exibe a mensagem de erro correta nos nós e na IA.

> 📗 Para dominar o editor, veja os tutoriais da categoria **Fluxos** — do primeiro fluxo ao gatilho de evento de integração.

> 📘 Precisa de ajuda? Fale com nosso suporte pelo chat — é só chamar.