Você precisa captar leads por uma campanha de mídias digitais que levem o interessado para uma página na web (landing page) que contém um formulário para que o interessado informe seus dados de contato (nome, email e telefone).
Geralmente as landing pages são construídas em Word Press e você utiliza um formulário que encaminha os dados do interessado para uma conta de email.
Gerenciar os leads em uma conta de email é muito trabalhoso. Assim, o HighLeads automatiza o processo de captação de leads. Ele lê a conta de email (IMAP), armazena as informações dos leads em um banco de dados e gerencia essas informações para a prospecção de futuros clientes.
Você pode ter várias landing pages apontando para a mesma conta de email. O HighLeads envia um aviso de 'Novo Contato' para as contas de email que você indicar para cada landing page.
O HighLeads também possui uma lista de emails para contatos outbound (via email marketing). Quando um contato inbound é recebido é verificado se este contato existe a lista outbound, associando o Consultor responsável pelo contato.
O Highleds possui um serviço backend para o serviço de API e o frontend - interface para o gerenciamento dos leads. Esses serviços podem ser executados no mesmo servidor que você publica as suas landing pages.
O serviço backend foi desenvolvido utilizando o framework laravel/lumen. Isso porque geralmente você hospeda sua landing page em servidores "shared hosts" que possuem o Word Press instalado, fornecem conta de email e serviço de banco de dados. Assim, é mais fácil colocar tudo em um mesmo servidor.
O HighLeads-backend roda com o PHP 8.0.27 e laravel/lumen 9.1.5.
- instale o Composer (https://getcomposer.org/download/)
- faça o download do PHP 8 e configure o ambiente (path) (https://www.php.net/downloads.php)
- verifique se as extensões no php.ini estão habilitadas (imap, mbstring, pdo_mysql, fileinfo)
- faça o download do HighLeads-backend
- execute o comando "composer install"
Para configurar o HighLeads-backend siga os passos:
- renomeie o arquivo .env.example para .env
- edite o arquivo .env e preencha as informações de conexão ao banco de dados, servidor IMAP e SMTP
- para gerar a chave JWT (JWT_SECRET) execute o comando "php artisan jwt:secret"
- execute a criação do banco de dados e seed com o comando "php artisan migrate:fresh --seed" - você pode editar os seeders para colocar mais dados para testes.
- para executar o servidor local execute o comando "php artisan serve"
- para acessar a aplicação abra seu navegador e digite o endereço: http://localhost:8000
Para acessar a documentação da API HighLeads-backend vá ao endereço: http://localhost:8000/api/documentation e altere o endereço para http://localhost:8000/docs
A documentação segue o padrão Swagger.
Para publicar qualquer alteração na documentação utilize o comando "php artisan swagger-lume:generate" e "php artisan swagger-lume:publish".
Para obter a lista das rotas: "php artisan route:list".
O HighLeads-backend executa dois serviços cron:
- para ler os emails (IMAP)
- para enviar os emails
Para alterar o agendamento dos serviços altere em app/Console/Kernel.php. Hoje estão configurados para execução de 10 em 10 minutos.
Para executar o serviços "php artisan schedule:run" ou "php artisan schedule:work".
O serviço IMAP lê os emails encaminhados pelo formulário da landing page, recupera as informações do formulário, verifica se o email está na lista negra (tabela blacklist), grava as informações no banco de dados e encaminha um email para o responsável pela landing page (registrado na tabela sites).
O serviço de email é responsável pelo envio dos emails armazenados na tabela emails..
Para executar os testes do HighLeads-backend execute o comando "composer tests". Os testes são executados sem o middleware de autenticação (token). Para a execução dos teste as tabelas devem estar truncadas.
Ainda em desenvolvimento.
Para testar a API, se tiver problema de CORS o middleware CorsMiddleware faz a liberação para que a API possa ser acessada por diferentes clientes. Se quiser pode remover o arquivo CorsMiddleware.php (pasta Http\Middleware) e remova-o do bootstrap/app.php. (fonte: https://dev.to/tadeubdev/php-curtas-resolvendo-cors-origins-no-lumen-23ih).
Para detalhes das tabelas veja na pasta \database\migrations.
Ao Contato pode ser atribuído os seguintes status:
- [1] - Novo: quando o contato é inserido no banco de dados e nenhuma ação foi iniciada
- [2] - Em prospecção: quando uma ação de conversão em vendas foi iniciada
- [3] - Qualificado: quando o contato está em processo de venda efetiva
- [4] - Encerrado - Positivo: quando o contato converteu em venda
- [5] - Encerrado - Negativo: quando o contato não converteu em venda
Um Score pode ser atribuído ao Contato para identificar aqueles mais propensos para aquisição. O Score é atribuído com um valor de 0 a 10.
O Usuário pode ter o perfil:
- [1] - Usuário Administrador
- [2] - Consultor
Você pode cadastrar emails para contato Outbound e classificá-los em Categorias para utilizar em suas Campanhas de email Marketing. O cadastro do contato outbound fica associado ao Consultor que o inseriu. Se o contato preencher o formulário de Inbound o mesmo será associado ao Consultor automaticamente.
Na importação do contato Outbound é necessário preencher uma planilha com os seguintes campos: nome, empresa, posição, telefone e cidade. Estes campos devem estar separados por vírgulas no arquivo TXT ou CSV. Na importação você deve definir a categoria dos contatos Outbound.
Durante a importação é verificado se o email é válido conforme a formatação e se existe um servidor de email para o endereço. Entretant, não é verificado se a caixa postal existe. O email que não esteja validado não é inserido na base de contatos Outbounds.
Para verificar completamente um endereço email utilizar sites que validem quanto a existência da conta de email como https://verificaemail.com.br/.
É importante que os emails da sua lista de Outbound esteja verificada. Os emails não verificados não podem ser incluídos em Campanhas de email Marketing.
O HighLeads também pode ser utilizado para envio de Campanhas de email Marketing, selecionando os contatos Outbounds.
Para o envio de emails o HighLeads considera a prioridade "0" como envio imediato e prioridade "1" entra na fila de envios. A prioridade "10" é utilizada para o envio de emails das Campanhas.
Exemplo:
- Mensagens de alteração de senha tem prioridade "0"
- Mensagens de novo usuário tem prioridade "0"
- Mensagens de teste de envio de campanha tem prioridade "0"
- Mensagens de aviso de novo contato tem prioridade "1"
- Mensagens de campanhas tem prioridade "10"
No arquivo .ENV é configurado o total de emails que podem ser enviados por dia (APP_EMAIL_DAY) e a quantidade de emails (APP_EMAIL_MAX) que são enviados a cada agendamento de envio. Esses valores são necessários para que a sua conta de email não seja sujeita a bloqueios (ou pelo menos para tentar não ser bloqueada). Para grandes envios de emails procure um serviço apropriado (veja em https://github.com/jonathandion/awesome-emails).
Quando o limite de envios de email por dia (APP_EMAIL_DAY) é alcançado, somente as mensagens com prioridade "0" e "1" são enviadas.
Os parâmetros APP_EMAIL_DAY e APP_EMAIL_MAX devem ser estabelecidos conforme as restrições de seu provedor. Vale lembar que uma campanha com muitos emails pode demorar a ser totalmente enviada, portanto, envie campanhas focadas para limitar a quantidade de emails.
O HighLeads utiliza templates para o envio de emails. Os templates são armazenados na pasta resources/templates.
- Crie um arquivo compactado TAR do HighLeads da sua instalação local
- Crie um subdominio no shared host. Utilize o nome api-highleads (por exemplo: https://api-highleads.dominio.com.br)
- Copie o arquivo compactado para a pasta do subdominio no shared
- Acesse o servidor pelo SSH e vá para a pasta do subdominio
- Descompacte o arquivo com o comando tar -xvf <nome_do_arquivo_compactado.tar>
- Certifique que o .htacess foi copiado para a pasta raiz do subdominio
- Pronto. Teste acessando a url https://api-highleads.dominio.com.br no navegador
- No cPanel do servidor shared host acesse 'Trabalhos Cron'
- Crie um serviço cron onde o Comando seja como: /usr/local/bin/php pasta_do_subdominio/artisan schedule:run
- Configure a frequência do serviço cron. Lembre que no HighLeads está configurado para execução de 10/10 minutos
O frontend está disponível em https://github.com/macabral/highleads-frontend.
Laravel Lumen is a stunningly fast PHP micro-framework for building web applications with expressive, elegant syntax. We believe development must be an enjoyable, creative experience to be truly fulfilling. Lumen attempts to take the pain out of development by easing common tasks used in the majority of web projects, such as routing, database abstraction, queueing, and caching.
The Lumen framework is open-sourced software licensed under the MIT license.