🎯 Primeiros Passos Apos a Instalacao
Apos conseguir fazer login, siga esta lista de verificacao para deixar o PulseHub pronto para producao.
1. Adicione Seu Primeiro Canal
Va ate Channels → Add Channel e selecione o tipo que corresponde ao seu caso de uso. Cada tipo de canal requer credenciais diferentes do seu provedor:
Apos adicionar um canal, sua URL de webhook e exibida no cartao. Voce ira cola-la no painel de desenvolvedor do seu provedor.
2. Configure o Webhook no Lado do Provedor
Todo provedor de canal precisa saber para onde enviar as mensagens recebidas. O formato e sempre:
https://yourdomain.com/webhooks/{channel_type}/{channel_id}
Consulte os guias especificos de cada canal para os passos exatos sobre onde colar esta URL.
3. Configure os Cron Jobs
Varios recursos so funcionam quando o executor de cron esta ativo:
| Recurso | Sem Cron | Com Cron |
|---|---|---|
| Email de entrada (IMAP) | Nunca consultado | Verificado a cada minuto |
| Regras de automacao | Executam sincronamente nas requisicoes web | Executam de forma confiavel a cada minuto |
| Retentativas de webhook com falha | Presas para sempre | Retentadas ate 5 vezes |
| Limpeza do banco de dados | Tabelas crescem indefinidamente | Podadas a cada hora |
Hospedagem compartilhada (cPanel / Plesk / DirectAdmin)
- Va ate Settings → Cron Job URL no PulseHub e copie a URL completa
- No seu painel de hospedagem, va ate Cron Jobs
- Defina o agendamento para A Cada Minuto (
* * * * *) - Cole isto como o comando:
wget -q -O /dev/null "https://yourdomain.com/cron.php?token=YOUR_CRON_SECRET&job=all"
Nenhum conhecimento de linha de comando necessario — basta copiar a URL das Configuracoes e cola-la no painel de hospedagem.
VPS / Servidor dedicado
* * * * * php /var/www/pulsehub/cron.php all >> /var/log/pulsehub_cron.log 2>&1
Veja a referencia completa de Cron Jobs.
4. Convide Sua Equipe
Va ate Agents → Invite Agent e crie contas para os membros da sua equipe de suporte:
- Admin — acesso total a todas as configuracoes, canais, automacoes e gerenciamento de agentes
- Agente — pode visualizar conversas, enviar mensagens, atribuir status e tags. Nao pode alterar configuracoes do sistema.
5. (Opcional) Habilitar Sugestoes de Resposta com IA
Va ate Settings → Workspace e cole sua chave de API da OpenAI. Com isso configurado, um botao ✨ AI Suggest aparece em cada thread de conversa.
6. Crie Sua Primeira Regra de Automacao
Va ate Automations → New Rule e crie uma regra de teste simples:
- Nome:
Tag urgent messages - Gatilho:
Message Received - Acao:
Add Tag→new
Veja o guia completo de Automacoes.
7. Incorpore o Widget de Chat Web (Opcional)
Se voce adicionou um canal de Chat Web, adicione este snippet ao seu site antes de </body>:
<script
src="https://yourdomain.com/public/js/webchat-widget.js"
data-channel="YOUR_CHANNEL_ID"
data-greeting="Hi! How can we help you today?"
data-color="#10b981">
</script>
Verificacao Rapida de Saude
- Envie uma mensagem de teste WhatsApp/SMS para seu numero conectado → aparece na caixa de entrada em segundos
- Envie um email de teste para sua caixa de entrada conectada → aparece apos a proxima execucao do cron (ate 1 minuto)
- Responda a mensagem de teste da caixa de entrada → chega no dispositivo do remetente
- Verifique a pagina de Analiticos → mostra pelo menos 1 conversa e 2 mensagens
- Teste o cron job — visite sua URL de cron no navegador para confirmar que executa sem erros