# Integração IXC Soft

![Integração IXC Soft](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBOEZsQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--86813d7656c9c9cca3b828ea7fc72e9dad1f9008/simplesdesk-ixc.png)

Conecte o **IXC Soft** ao SimplesDesk e transforme o WhatsApp do provedor em central de autoatendimento: o Agente de IA localiza o assinante, envia a 2ª via com PIX copia-e-cola, verifica a conexão, faz o desbloqueio de confiança e abre ordem de serviço — e os fluxos automatizam a régua de cobrança com a fonte de faturas a vencer.

## Quando utilizar

- Provedores de internet que usam IXC e atendem **suporte e financeiro pelo WhatsApp**;
- **Réguas de cobrança** automáticas: fatura a vencer ou vencida dispara mensagem com boleto e PIX;
- Autoatendimento com **Agente de IA**: 2ª via, "minha internet caiu", desbloqueio de confiança e abertura de chamado técnico sem intervenção humana.

## Como conectar

1. Acesse **Configurações → Integrações** e clique no card **IXC Provedor**.
2. Preencha a **URL do IXC** — o endereço do seu servidor, sem `/webservice` (ex.: `https://ixc.seuprovedor.com.br`).
3. Preencha o **Token de API** no formato `id:hash`, exatamente como gerado no IXC em **Configurações → Usuários → API**. O token precisa de permissão nas tabelas de cliente, contrato, financeiro, radusuarios e OS.
4. Clique em **Testar e conectar** — a conexão é validada antes de salvar e fica ativa para toda a conta.

Com a conta conectada, três frentes ficam disponíveis: **Agente de IA**, **nós de fluxo** e **fonte de contatos para disparos agendados**.

---

## Agente de IA

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

| Capacidade | O que ela faz |
| --- | --- |
| **Localizar cliente** | Busca por CPF/CNPJ ou telefone (por padrão, o da própria conversa) — sempre o primeiro passo |
| **Faturas em aberto** | Lista boletos com vencimento, valor, linha digitável e código **PIX copia-e-cola** (2ª via na hora) |
| **Status da conexão** | Quando o cliente relata internet lenta ou sem sinal: contrato ativo/bloqueado por atraso e login PPPoE online ou offline |
| **Desbloqueio de confiança** | Religa temporariamente a internet do cliente bloqueado por atraso para que ele pague — o limite de desbloqueios é controlado pelo próprio IXC |
| **Ordens de serviço** | Lista os chamados técnicos existentes e abre uma nova OS quando o diagnóstico não resolve (conexão offline com contrato ativo, visita técnica) |

A IA segue a ordem certa sozinha: localiza o titular, diagnostica, tenta resolver (2ª via, desbloqueio) e só abre chamado se já não houver um em aberto.

---

## Nós de fluxo

No editor de fluxos, a paleta ganha a categoria **IXC (provedor)** com quatro nós:

- **IXC: Localizar cliente** — busca por CPF/CNPJ (ou telefone do contato, se vazio). Saída verde = encontrado, amarela = não encontrado. Grava `{{variables.ixc_cliente_id}}`, `{{variables.ixc_cliente_nome}}`, `{{variables.ixc_cliente_documento}}` e `{{variables.ixc_cliente_ativo}}` — e persiste o ID no contato para os próximos atendimentos;
- **IXC: Faturas em aberto** — lista as faturas do cliente localizado (2ª via). Grava `{{variables.ixc_faturas_count}}`, `{{variables.ixc_faturas_resumo}}` e os dados da primeira fatura: `{{variables.ixc_fatura_valor}}`, `{{variables.ixc_fatura_vencimento}}`, `{{variables.ixc_fatura_linha_digitavel}}` — com a opção **Incluir PIX copia-e-cola** (`{{variables.ixc_fatura_pix}}`);
- **IXC: Desbloqueio de confiança** — religa a conexão do inadimplente. Saída verde = ok, vermelha = recusado. Grava `{{variables.ixc_desbloqueio_ok}}` e `{{variables.ixc_desbloqueio_mensagem}}`;
- **IXC: Abrir ordem de serviço** — abre o chamado com ID do assunto e descrição (aceita variáveis) e grava o protocolo em `{{variables.ixc_os_id}}`.

Os três últimos usam automaticamente o cliente localizado pelo primeiro nó. Em caso de erro, a mensagem fica em `{{variables.ixc_erro}}`.

---

## Fonte de contatos: faturas a vencer

No gatilho **Disparo agendado**, a fonte **"IXC — Faturas a vencer"** busca as faturas por data de vencimento e dispara o fluxo para cada cliente. Configure:

- **Quais cobranças** — *A vencer* ou *Vencidas*;
- **Quantos dias** — a vencer EM *n* dias ou vencidas HÁ *n* dias;
- **Disparos por minuto** — vazão dos envios, para evitar bloqueio do WhatsApp.

Cada disparo chega com as variáveis prontas: `{{variables.ixc_cliente_nome}}` · `{{variables.ixc_fatura_valor}}` · `{{variables.ixc_fatura_vencimento}}` · `{{variables.ixc_fatura_linha_digitavel}}` · `{{variables.ixc_fatura_id}}` · `{{variables.ixc_cliente_id}}`

### Exemplo: régua de cobrança com desbloqueio em confiança

1. Gatilho **Disparo agendado** + fonte **IXC — Faturas a vencer** (*Vencidas*, HÁ 3 dias);
2. **Enviar Mensagem**: "Olá {{variables.ixc_cliente_nome}}, sua fatura de R$ {{variables.ixc_fatura_valor}} venceu em {{variables.ixc_fatura_vencimento}}. Segue o código para pagamento:" + `{{variables.ixc_fatura_linha_digitavel}}`;
3. Botão **"Já paguei / preciso de prazo"** → nó **IXC: Desbloqueio de confiança** religa a internet na hora e confirma com `{{variables.ixc_desbloqueio_mensagem}}`.

O mesmo trio de nós (Localizar cliente → Faturas em aberto → Desbloqueio) monta o autoatendimento por palavra-chave — ou deixe tudo com o Agente de IA.

> 📗 Para dominar o editor, veja os tutoriais da categoria **Fluxos** — do primeiro fluxo ao gatilho de disparo agendado.

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