Manual do Sistema Sinci

Guia completo para operação do CRM, Inteligência Artificial e integrações.

1. Introdução

O Sinci é um sistema de CRM inteligente com arquitetura MVC projetado para otimizar o setor comercial de empresas B2B e B2C. Ele une o poder da Inteligência Artificial no atendimento pelo WhatsApp, gestão de catálogos digitais e sincronização bidirecional de dados com o ERP Bling.

Objetivo principal: Automatizar a triagem de leads, manter os catálogos atualizados com o estoque real e agilizar o fechamento de vendas direto no ERP.

2. Configurações Iniciais

Para o funcionamento correto do sistema, os parâmetros básicos precisam estar configurados no arquivo .env na raiz do projeto:

  • Credenciais de Banco de Dados: Conexão MySQL onde ficam armazenados clientes, produtos e históricos de interação.
  • Tokens do Bling: Autenticação da API do Bling para exportação e importação de dados.
  • Integração WhatsApp: Chaves de API para os serviços de disparo e webhook de recebimento de mensagens.

3. Atendimento IA (SDR)

A Inteligência Artificial atua como um SDR (Sales Development Representative) no WhatsApp. O objetivo primário não é fechar a venda, mas sim qualificar o lead e preparar o terreno para o consultor humano (Closer).

Fluxo de Funcionamento:
  1. O cliente envia uma mensagem e a IA inicia o fluxo de perguntas curtas (uma por vez).
  2. Identifica o perfil (CNPJ, segmento de atuação e modelo de negócio).
  3. Analisa a intenção de compra do cliente.
  4. Gatilho de Transferência: Assim que o cliente demonstra interesse claro em comprar (ex: "Quero comprar", "Pode me enviar valores?"), a IA encerra sua participação e transfere a conversa para um consultor.

O módulo de catálogo (hospedado na pasta /site_venda) é a vitrine virtual gerada automaticamente a partir dos produtos do sistema.

  • Exibe os produtos com fotos, preços e categorias sincronizadas do Bling.
  • Permite a montagem de um carrinho de compras por parte dos lojistas/clientes.
  • Ao finalizar o pedido no catálogo, os dados são automaticamente inseridos no painel Sinci e aguardam exportação.

5. Integração com Bling ERP

O coração operacional do sistema é a sua sincronização com o Bling, que roda muitas vezes de forma automática via rotinas (Cron Jobs).

Rotina/Arquivo Função Principal
cron_bling_estoque.php Verifica o estoque do Bling e atualiza no Sinci e no catálogo virtual automaticamente.
migrate_bling.php Realiza a carga inicial e atualização de produtos, descrições e preços da base do Bling para o CRM.
Exportação de Pedidos Ao fechar uma venda (ou via transbordo), o pedido é enviado para o Bling já formatado, reservando estoque e permitindo o faturamento.

6. Disparos e Automação

O Sinci também possui módulos de automação de marketing via WhatsApp para engajar a base (carteira de clientes importada em CSV, por exemplo).

  • Disparo em Massa: O arquivo cron_disparos.php pode ser configurado no servidor para processar filas de mensagens sem sobrecarregar a API, evitando bloqueios.
  • Templates: O sistema gerencia envios pré-aprovados para reativar clientes antigos, avisar de promoções ou repassar o contato para a IA realizar o engajamento.

7. Suporte Técnico

Em caso de dúvidas técnicas, erros de sincronização ou problemas com a IA, verifique primeiro:

  1. A saúde das conexões de API testando os arquivos na raiz (como test_api.php ou debug_token.php).
  2. Se a rotina Cron do painel de hospedagem (cPanel/HostGator/AWS) está executando no tempo correto.

Para suporte avançado, acione o administrador do sistema pelo canal interno da empresa.