Processo Comercial Recomendo¶
Trigger¶
Rotina comercial diária para ativar contatos do network Recomendo sem criar um gerenciador paralelo ao Hermes.
O processo roda em dias úteis, de segunda a sexta, às 09:00 America/Sao_Paulo, pelo cron Hermes e64427b95d64 (Comercial - Recomendo diario). O disparo não envia WhatsApp automaticamente: ele gera resumo, mensagens prontas e comandos sugeridos para Felipe aprovar.
Steps¶
| Ordem | Ação | Dono | Ferramenta | Tempo estimado |
|---|---|---|---|---|
| 1 | Hermes executa a rotina e consulta o pipeline recomendo no CRM Cadencia. | Hermes | hermes cron + cadencia-cli | Até 5 min |
| 2 | Identifica contatos elegíveis, pendências e bloqueios. Ambiguidade de contato, telefone, oportunidade ou stage falha fechado e entra no resumo. | Hermes | CRM Cadencia | Até 5 min |
| 3 | Gera uma mensagem pronta por execução, com pendências consolidadas. Não envia mensagem real sem comando inequívoco de Felipe. | Hermes | Telegram | Até 5 min |
| 4 | Quando Felipe informa lead respondeu: <nome> | <resumo>, registrar resposta no CRM e preparar próximo passo. | Felipe + Hermes | Telegram + CRM Cadencia | Até 5 min |
| 5 | Quando Felipe informa manda agenda: <nome>, preparar mensagem com cal.com/felipe-salgueiro/recomendo-pdv e comando de atualização. | Felipe + Hermes | Telegram + Cal.com | Até 5 min |
| 6 | Quando Felipe confirma agenda enviada: <nome>, registrar activity e mover a oportunidade única para aguardando-pdv. | Hermes | CRM Cadencia | Até 5 min |
| 7 | Quando o contato agenda no Cal.com, o receiver enfileira meeting e o onboarding-consumer move a oportunidade de em-contato ou aguardando-pdv para reuniao-agendada. | Cal.com + onboarding-consumer | Cal.com webhook + VPS Master | Loop de 30 s |
| 8 | Se a reunião for remarcada ou o webhook BOOKING_CREATED chegar duplicado, manter a oportunidade em reuniao-agendada como operação idempotente. | onboarding-consumer | CRM Cadencia | Loop de 30 s |
| 9 | Se Felipe informa pdv marcado: <nome> | <data> <hora>, usar fallback manual para registrar activity e mover para reuniao-agendada. | Felipe + Hermes | Telegram + CRM Cadencia | Até 5 min |
| 10 | Se Felipe informa sem fit: <nome> | <motivo>, preparar movimento terminal para sem-fit. | Felipe + Hermes | Telegram + CRM Cadencia | Até 5 min |
Output¶
- Resumo diário no Telegram, uma vez por execução.
- Mensagem pronta para Felipe enviar ao lead, quando houver lead elegível.
- Atualização de activity no CRM quando Felipe informa resposta, agenda enviada, PDV marcado ou sem fit.
- Stage
aguardando-pdvpara contato que recebeu o link e ainda não agendou. - Stage
reuniao-agendadasomente quando há booking real do Cal.com ou fallback manual com data/hora.
Failure modes¶
| Falha | Comportamento correto | Recuperação |
|---|---|---|
| Contato ambíguo no CRM | Não mover stage nem sugerir envio automático | Resumo lista bloqueio; Felipe informa identificador mais preciso |
Oportunidade ausente no pipeline recomendo | Não criar movimento implícito | Criar/corrigir oportunidade antes de continuar |
Oportunidade em stage terminal (sem-fit, pdv-realizado, indicacao-gerada) | Falhar fechado; não voltar para reuniao-agendada | Felipe decide reabrir manualmente se for exceção consciente |
Link enviado sem confirmação agenda enviada | Não mover para aguardando-pdv | Felipe registra agenda enviada: <nome> |
| Booking duplicado do Cal.com | Processar idempotente como Reunião agendada (Recomendo, já estava) | Nenhuma ação |
| Webhook sem assinatura válida | Receiver responde 401 | Corrigir origem/segredo do webhook antes de confiar |
| Cron Hermes sem execução recente | Healthcheck alerta | Validar hermes cron runs e64427b95d64 --limit 1 no Dell |
| Fim de semana | Não executar rotina | Próximo disparo em dia útil |
SLA¶
- Execução programada: segunda a sexta, 09:00 America/Sao_Paulo.
- Resumo Hermes: até 5 min após início do cron.
- Consumer Cal.com: processa fila em loop de 30 s.
- Atualização manual via comandos de Felipe: até 5 min quando Hermes estiver ativo.
Refs cruzadas¶
pipeline-structure.md— estrutura geral dos funis comerciais no CRM Cadencia.programa-indicacao.md— regras gerais de indicação e rastreabilidade.rituais-solo.md— rituais comerciais operados por Stamper/Hermes.stamper/workers/hermes_recomendo/README.md— contrato runtime do cron Hermes.times/cs/workers/onboarding-consumer/README.md— consumer que fecha o loop webhook -> CRM.- Linear DEV-1794 — automação da rotina Recomendo via Hermes.
- Linear DEV-1795 — suporte CLI para reordenar/atualizar stages do pipeline.
Notas manuais¶
(Editar livremente abaixo — não gerenciado por skill.)