ADONAI IMÓVEIS GUARUJÁ · VERSÃO 0.1.0

Vamos preparar o robô C2S.

Projeto próprio para a nova conta Cloudflare e para o chip pré-pago da campanha. Quando o cliente responder, a equipe continua a conversa pessoalmente.

Esta é a primeira versão para configuração. O pacote não contém token, senha nem número de chip preenchidos. A conexão com a conta real do C2S e o teste no WhatsApp ainda precisam ser feitos.

1. O que vem no pacote

ArquivoUso
1-SUBIR-NO-CLOUDFLARE.zipUpload do novo projeto Pages, com painel e API.
2-INSTALAR-D1.sqlInstalação das tabelas no novo banco D1.
3-EXECUTOR-WINDOWS.zipPrograma que conecta o chip da campanha e realiza os envios.
4-CODIGO-FONTE.zipFonte completo, demonstração, testes e documentação.
5-REGRAS-E-CONSUMO.mdRegras da fila, frequência de consultas e orçamentos diários.

2. Criar o banco D1

  1. Entre na nova conta Cloudflare e crie um banco D1 chamado adonai-c2s.
  2. Abra a área de consultas SQL desse banco novo.
  3. Abra 2-INSTALAR-D1.sql, copie todo o conteúdo e execute no novo D1.
  4. Guarde o nome e o identificador do banco para vincular ao projeto.

3. Subir o novo painel

  1. Crie um projeto Cloudflare Pages para a campanha C2S.
  2. Na opção de upload direto, envie somente 1-SUBIR-NO-CLOUDFLARE.zip. Não envie o pacote externo completo.
  3. Nas configurações do projeto, adicione um vínculo de banco D1 com o nome exato DB, apontando para adonai-c2s.
  4. Cadastre as variáveis abaixo no ambiente de produção. Tokens e senhas devem ficar como segredos.
  5. Faça novo deployment depois de configurar o vínculo e as variáveis.

4. Variáveis de produção

Nome exatoValor
PANEL_USERNAMEUsuário escolhido para entrar no painel.
PANEL_PASSWORDSenha própria, com pelo menos 12 caracteres.
SESSION_SECRETSegredo aleatório de pelo menos 32 caracteres. Use uma senha gerada por gerenciador de senhas.
EXECUTOR_TOKENOutro segredo aleatório de pelo menos 32 caracteres. O mesmo valor será informado ao configurar o programa no Windows.
C2S_TOKENToken de integração que permite consultar os leads da Adonai no C2S.
ROBOT_SENDER_PHONENúmero do chip exclusivo com país e DDD, apenas dígitos. Exemplo de formato: 55 + DDD + celular.
ROBOT_LIVE_ENABLEDfalse inicialmente. É a habilitação de campanhas reais.
ROBOT_TEST_ENABLEDfalse inicialmente. Habilite somente na conferência de um número próprio.
ROBOT_TEST_RECIPIENTNúmero próprio para o teste, diferente do chip remetente. País e DDD, apenas dígitos.
PROJECT_API_DAILY_BUDGET20000. Orçamento diário próprio de chamadas autenticadas do projeto.

Não coloque esses valores nos arquivos públicos, no HTML ou no código-fonte. A chave do C2S fica no servidor. No PC, só fica o token específico do executor.

5. Conferir a primeira amostra

  1. Abra o novo endereço do painel e entre com seu usuário e senha.
  2. Na tela Conexões, use Conferir D1 e C2S.
  3. Em Campanha, inicie a atualização da base. A carga avança por páginas enquanto a aba estiver visível. Pode pausar e retomar.
  4. Confira nomes, telefones, corretor, interesse anterior e motivo. Valide principalmente como a sua conta representa arquivado definitivo.
  5. Abra Mensagem, ajuste o rascunho da abordagem e salve. A prévia por cliente não envia nada.

A importação consulta os diferentes status para identificar atendimentos ativos e negócios fechados. Só os arquivados elegíveis entram na fila de contatos. O C2S não é alterado por este robô.

6. Conectar o chip no Windows

  1. Extraia 3-EXECUTOR-WINDOWS.zip numa pasta nova e instale Node.js 22.13 ou superior.
  2. Abra 1-Instalar-C2S.cmd e aguarde a instalação.
  3. Abra 2-Configurar-C2S.cmd, informe a URL do novo painel, o token do programa e escolha o modo 1, só conectar.
  4. Abra 3-Iniciar-Robo-C2S.cmd e vincule o chip exclusivo no QR Code.

7. Primeiro teste e primeiro lote

  1. Configure o destinatário próprio e ROBOT_TEST_ENABLED=true no Cloudflare. Faça novo deployment.
  2. Feche o programa normal e execute 4-Testar-WhatsApp-C2S.cmd. É um único teste, separado da fila. Confira o celular.
  3. Desligue ROBOT_TEST_ENABLED quando terminar.
  4. Com os dados, remetente, mensagem e teste conferidos, habilite ROBOT_LIVE_ENABLED=true e faça novo deployment.
  5. Configure o Windows no modo 2, campanha. Comece pelo lote pequeno que vocês escolherem no painel.

8. Como o consumo foi limitado

Arquivos estáticos não passam pela API. O relógio roda no navegador. Painel em campanha: uma atualização a cada 15 segundos; parado: a cada 60 segundos; aba oculta: sem atualização automática. O programa parado consulta a cada 60 segundos. Resumos usam contadores no banco, sem varrer a base inteira.

Orçamentos próprios: 20 mil chamadas, 3 milhões de linhas lidas, 60 mil linhas gravadas e 5 mil consultas ao C2S por dia. Existe uma reserva para registrar resultados e comandos essenciais quando o orçamento comum se esgota. A tela Consumo é estimativa da aplicação; compare com as métricas oficiais da conta.

Se algo não conectar