Laboratório em bancada

Laboratório: EspoCRM em produção local com funil de vendas e integração de e-mail

Você terá um EspoCRM funcional em uma VM Linux, com funil de vendas, envio/recebimento de e-mails e automação básica. O laboratório leva cerca de 2 horas.

Ligado ao treinamento CRM de código aberto com EspoCRM

Duração estimada: 120 min
Passos: 13
Validações: 5

Objetivo

Demonstrar a instalação completa do EspoCRM em ambiente local, integrando banco de dados MariaDB, PHP, Apache, configuração de entidades, funil de vendas, e-mail SMTP/IMAP, e um workflow simples. O objetivo é que você entenda o ciclo operacional do CRM de código aberto, desde a infraestrutura até a automação comercial.

Topologia

Uma máquina virtual Linux (192.168.56.10) roda Apache, PHP, MariaDB e EspoCRM. Usuários acessam via navegador na mesma rede. O EspoCRM conecta-se a um servidor SMTP/IMAP externo (exemplo: mail.dominio.local).

┌─────────────────────────────┐n│  Usuário (192.168.56.20)    │n└─────────────┬───────────────┘n              │ HTTP/HTTPSn┌─────────────▼───────────────┐n│ EspoCRM VM (192.168.56.10)  │n│ Apache + PHP + MariaDB      │n└─────────────┬───────────────┘n              │ SMTP/IMAPn┌─────────────▼───────────────┐n│ mail.dominio.local          │n└─────────────────────────────┘

Equipamentos e software

Item	Requisito, licença ou versão
Máquina virtual Linux (Ubuntu Server)	2 vCPU, 2GB RAM, 20GB disco, 1 interface de rede, Ubuntu 22.04 LTS ou superior
EspoCRM	AGPLv3 · 7.5.6
MariaDB	GPLv2 · a versão estável atual
Apache HTTP Server	Apache 2.0 · a versão estável atual
PHP	PHP License · consulte a documentação do EspoCRM para requisitos

Roteiro

Preparar o sistema operacional
Atualize o sistema e instale utilitários básicos. Isso garante ambiente limpo e atualizado.
```
sudo apt update && sudo apt upgrade -ynsudo apt install unzip wget nano -y
```
O que você deve ver: Sistema atualizado, utilitários instalados.
Instalar Apache
O EspoCRM depende de um servidor web. Apache é o mais comum em ambientes Linux.
```
sudo apt install apache2 -y
```
O que você deve ver: Apache instalado e rodando em http://localhost.
Instalar PHP e extensões
EspoCRM exige PHP e módulos específicos. Consulte a documentação para versões suportadas.
```
sudo apt install php php-mysql php-xml php-mbstring php-zip php-curl php-gd php-imap -y
```
O que você deve ver: PHP e extensões instaladas.
Instalar MariaDB
O banco de dados armazena todas as entidades e registros do CRM.
```
sudo apt install mariadb-server -y
```
O que você deve ver: MariaDB instalado e rodando.

Configurar banco de dados para EspoCRM

Crie banco e usuário dedicados para isolar o ambiente do CRM.

sudo mysql -u rootnCREATE DATABASE espocrm CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;nCREATE USER 'espouser'@'localhost' IDENTIFIED BY 'senha-forte';nGRANT ALL PRIVILEGES ON espocrm.* TO 'espouser'@'localhost';nFLUSH PRIVILEGES;nEXIT;

O que você deve ver: Banco e usuário criados.

Baixar e descompactar EspoCRM

Obtenha o pacote oficial do EspoCRM e coloque-o no diretório do Apache.

cd /var/www/htmlnsudo wget https://github.com/espocrm/espocrm/archive/refs/tags/7.5.6.zipnsudo unzip 7.5.6.zipnsudo mv espocrm-7.5.6 espocrmnsudo chown -R www-data:www-data espocrmnsudo chmod -R 755 espocrm

O que você deve ver: Arquivos do EspoCRM no diretório /var/www/html/espocrm.

Configurar Apache para EspoCRM
Crie um VirtualHost dedicado para isolar o acesso ao CRM.
```
sudo nano /etc/apache2/sites-available/espocrm.conf
```
O que você deve ver: Arquivo de configuração criado.

Conteúdo do VirtualHost

Insira as diretivas para servir o EspoCRM.

<VirtualHost *:80>n    ServerAdmin admin@dominio.localn    DocumentRoot /var/www/html/espocrmn    ServerName crm.dominio.localn    <Directory /var/www/html/espocrm>n        AllowOverride Alln        Require all grantedn    </Directory>n    ErrorLog ${APACHE_LOG_DIR}/espocrm_error.logn    CustomLog ${APACHE_LOG_DIR}/espocrm_access.log combinedn</VirtualHost>

O que você deve ver: VirtualHost configurado.

Ativar site e módulos do Apache
Habilite o novo site e o mod_rewrite, necessário para URLs amigáveis.
```
sudo a2ensite espocrmnsudo a2enmod rewritensudo systemctl reload apache2
```
O que você deve ver: Site ativado, Apache recarregado.
Instalar EspoCRM via navegador
Acesse http://crm.dominio.local e siga o instalador web. Informe dados do banco, admin e-mail e senha.
O que você deve ver: Tela de login do EspoCRM ao final.
Configurar entidade Oportunidade e Funil de Vendas
No menu de administração, ajuste os estágios do funil de vendas conforme o processo comercial desejado.
O que você deve ver: Funil de vendas visível e ajustado em Oportunidades.
Configurar e-mail SMTP/IMAP
No menu de e-mail, configure conta SMTP/IMAP para envio e recebimento de e-mails comerciais.
O que você deve ver: Envio e recebimento de e-mails funcionando no CRM.
Criar workflow simples
No menu de automação, crie um workflow que envie e-mail automático ao criar uma nova oportunidade.
O que você deve ver: Workflow criado e acionado ao criar novas oportunidades.

Como saber que funcionou

Teste	Comando	Critério
Acessar EspoCRM via navegador	`http://crm.dominio.local`	Tela de login carregada.
Login com usuário admin		Dashboard do EspoCRM exibido.
Criar nova oportunidade		Registro aparece no funil de vendas.
Enviar e-mail pelo CRM		E-mail enviado e recebido na caixa de destino.
Workflow dispara ao criar oportunidade		E-mail automático enviado conforme regra definida.

Troubleshooting

Sintoma	Causa provável	Correção
Erro 500 ao acessar EspoCRM	Permissões de arquivos incorretas ou módulos PHP faltando	Verifique permissões em /var/www/html/espocrm e instale módulos PHP necessários.
Não conecta ao banco de dados	Credenciais ou permissões erradas no MariaDB	Revise usuário, senha e privilégios conforme passo 5.
URLs amigáveis não funcionam	mod_rewrite não habilitado ou AllowOverride ausente	Habilite mod_rewrite e ajuste AllowOverride para All no VirtualHost.
E-mails não enviados	Configuração SMTP incorreta	Revise dados SMTP e teste conexão no menu de e-mail do EspoCRM.
Workflow não dispara	Condições do workflow incorretas	Revise as regras e condições do workflow criado.