# Integração Sienge

![Integração Sienge](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBOFJsQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--fedb51e391cdd6b2a4e8e0d2b2e780ccb0c4f45f/simplesdesk-sienge.png)

Conecte o **Sienge** ao SimplesDesk e dê à sua construtora um atendimento financeiro completo pelo WhatsApp: o Agente de IA localiza o cliente pelo CPF/CNPJ, consulta saldo devedor e parcelas, emite a 2ª via do boleto, mostra contratos, disponibilidade de unidades e andamento da obra — e os fluxos montam o autoatendimento de 2ª via de ponta a ponta.

## Quando utilizar

- Construtoras e incorporadoras que usam o Sienge no financeiro de clientes;
- **Autoatendimento de 2ª via de boleto**: o comprador informa o CPF e recebe o boleto na hora;
- Atendimento com **Agente de IA** que responde saldo devedor, contratos, unidades disponíveis e status da obra.

## Como conectar

1. Acesse **Configurações → Integrações** e clique no card **Sienge**.
2. Preencha o **Subdomínio** — a parte inicial da sua URL do Sienge: `https://SUBDOMINIO.sienge.com.br`.
3. Preencha o **Usuário de API** e a **Senha de API** — criados no portal de **Integrações do Sienge** (não são o login da plataforma). O usuário de API precisa de permissão nas APIs de clientes, contas a receber, contratos e unidades.
4. Clique em **Testar e conectar** — a conexão é validada antes de salvar e fica ativa para toda a conta.

A integração opera por duas frentes: **Agente de IA** e **nós de fluxo** — não há fonte de contatos nem eventos de integração para o Sienge.

> 💡 Bônus para quem usa o CRM: ao **ganhar uma oportunidade** no pipeline, o pré-cadastro do cliente é criado automaticamente no Sienge (ligado por padrão na conexão). Se o contato já está vinculado ou o CPF já existe no Sienge, ele só vincula — não duplica cadastro.

---

## Agente de IA

Nas configurações do assistente (**Central IA → seu assistente → Integrações**), ative o **Sienge**. A IA passa a fazer:

| Grupo | O que a IA passa a fazer |
| --- | --- |
| **Cliente** | Localizar o cliente da construtora pelo CPF ou CNPJ — sempre o primeiro passo antes das consultas |
| **Financeiro** | Consultar saldo devedor e parcelas (vencidas e a vencer, com valores atualizados) e emitir a 2ª via do boleto com linha digitável — ou enviá-la por e-mail direto pelo Sienge |
| **Contratos e unidades** | Listar os contratos de venda (empreendimento, unidade, valor, situação), consultar a disponibilidade de unidades por empreendimento (disponível, reservada, vendida) e o andamento da obra* |

*Andamento da obra disponível apenas se o módulo de obras estiver contratado no Sienge.

> ⚠️ O link de download da 2ª via gerado pelo Sienge **expira em 5 minutos** — a IA (e os fluxos) devem enviá-lo imediatamente após gerar.

---

## Nós de fluxo

No editor de fluxos, a paleta ganha a categoria **Sienge** com três nós que se encadeiam. Os campos aceitam variáveis do fluxo — escreva `{{variables.nome}}` ou digite o valor direto:

- **Buscar Cliente Sienge** — busca pelo **CPF/CNPJ** (ex.: a resposta de um Coletar Dados em `{{variables.cpf}}`). Salva `{{variables.sienge_customer_id}}`, `{{variables.sienge_customer_nome}}`, `{{variables.sienge_customer_email}}` e `{{variables.sienge_cpf}}` — e, se quiser, o campo **"Salvar ID do cliente em"** grava o id também numa variável sua. Cliente não encontrado sai pelo caminho de falha.
- **Saldo Devedor Sienge** — consulta o saldo devedor do CPF (vazio, usa o CPF do nó anterior). Salva `{{variables.sienge_bill_count}}`, `{{variables.sienge_overdue_count}}` e `{{variables.sienge_overdue_total}}` (total vencido), além do código do título `{{variables.sienge_bill_id}}` e da parcela `{{variables.sienge_installment_id}}` prioritária para a 2ª via — primeira vencida; senão, primeira a vencer.
- **2ª Via de Boleto Sienge** — gera o boleto do título/parcela (**Código do título** e **Código da parcela**; use os do nó anterior). Salva `{{variables.sienge_boleto_url}}` (link de download — **expira em 5 minutos**, envie na sequência do fluxo) e `{{variables.sienge_boleto_linha_digitavel}}`. Alternativa: marque **"Enviar por e-mail ao cliente"** e o próprio Sienge envia o boleto ao e-mail do contato.

### Exemplo: autoatendimento de 2ª via de boleto

1. Nó **Coletar Dados** perguntando o CPF do comprador (salva em `{{variables.cpf}}`);
2. **Buscar Cliente Sienge** com CPF/CNPJ = {{variables.cpf}} — no caminho de falha, transfira para um atendente;
3. **Saldo Devedor Sienge** → **Condição**: se {{variables.sienge_overdue_count}} maior que 0, siga para a 2ª via;
4. **2ª Via de Boleto Sienge** (usa o título e a parcela já salvos) → **Enviar Mensagem** logo em seguida: "{{variables.sienge_customer_nome}}, aqui está sua 2ª via: {{variables.sienge_boleto_url}} — o link expira em 5 minutos. Linha digitável: {{variables.sienge_boleto_linha_digitavel}}".

> 📗 Para dominar o editor, veja os tutoriais da categoria **Fluxos**.

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