Bitconn Auto Survey

Sales/CRM · v19.0.1.0.0 · GPL-2

Bitconn Auto Survey

Funcionalidades

• Ação no CRM para agendar pesquisa para o parceiro do lead
• Botão manual no card kanban do CRM
• Agendamento padrão de 48h após criação
• Status de envio (rascunho, agendado, enviado, respondido, cancelado, erro)
• Cron job para disparo automático dos e-mails agendados

Dependências

crm, survey

Documentação

Agendamento automático de pesquisas via CRM com disparo por e-mail

• Versão: 18.0.1.0.0
• Autor: Diego F. Rodrigues
• Website: bitconn.com.br
• Licença: GPL-2
• Dependências: crm, survey

---

Descrição

Módulo para Odoo 18 que permite agendar o envio de pesquisas (surveys) diretamente a partir do CRM. Os agendamentos são criados vinculados a leads/oportunidades e disparados automaticamente por e-mail na data programada (padrão: 48h após criação).

---

Funcionalidades

CRM - Agendamento de Pesquisas

• Botão no header do formulário da oportunidade: “Agendar Pesquisa” — abre wizard para selecionar pesquisa, contato, e-mail e data de envio.
• Menu no card kanban das oportunidades: opção “Agendar Pesquisa” no menu dropdown do card.
• Stat button no formulário do lead: exibe a contagem de pesquisas agendadas e abre a lista ao clicar.
• Server action no CRM: ação “Agendar Pesquisa” disponível na listagem e formulário de leads.

Modelo auto.survey.schedule

Registro de agendamento com os seguintes campos:

Campo	Descrição
name	Referência sequencial (SURV/2026/0001)
survey_id	Pesquisa a ser enviada
partner_id	Contato destinatário
lead_id	Lead/oportunidade de origem
email	E-mail do destinatário (auto-preenchido pelo contato)
scheduled_date	Data/hora agendada para envio (padrão: 48h)
sent_date	Data/hora do envio efetivo
state	Status do agendamento
user_input_id	Resposta da pesquisa vinculada
user_id	Responsável pelo agendamento
error_message	Mensagem de erro (quando aplicável)

Status do Envio

Status	Descrição
Rascunho	Agendamento criado, não confirmado
Agendado	Confirmado, aguardando data de envio
Enviado	E-mail disparado com sucesso
Respondido	Pesquisa respondida pelo contato
Cancelado	Agendamento cancelado manualmente
Erro	Falha no envio (mensagem de erro detalhada disponível)

Ações do Formulário

• Agendar — confirma o agendamento (rascunho → agendado)
• Enviar Agora — dispara imediatamente sem aguardar a data
• Cancelar — cancela o agendamento
• Voltar a Rascunho — retorna de cancelado/erro para rascunho
• Testar Link — abre a URL da pesquisa em nova aba (disponível após envio)

Views

• Lista com decorações por status (cores)
• Kanban agrupado por status com progressbar
• Formulário completo com chatter (tracking de alterações)
• Filtros e agrupamentos por status, pesquisa, data e responsável

Cron Jobs

Cron	Intervalo	Descrição
Enviar Pesquisas Agendadas	15 minutos	Busca agendamentos com status “Agendado” e scheduled_date <= agora, e dispara o envio
Verificar Respostas	1 hora	Verifica se pesquisas enviadas já foram respondidas e atualiza o status

Os crons podem ser ajustados via menu Pesquisas > Agendamentos > Configuração (somente administradores).

Template de E-mail

Template em PT-BR com:

• Saudação personalizada com nome do contato
• Botão “Responder Pesquisa” com link direto
• Assinatura do responsável

---

Menus

Pesquisas
└── Agendamentos
    ├── Agendamentos      (lista/kanban dos agendamentos)
    └── Configuração      (crons do módulo - somente admin)

---

Uso com Automações (base.automation)

O módulo pode ser integrado com regras de automação do Odoo para agendamento automático de pesquisas sem intervenção manual. Basta criar uma automação no CRM com ação “Executar código Python”.

Exemplo: Agendar pesquisa quando lead muda para estágio “Ganho”

1. Acesse Configurações > Técnico > Automação > Regras de Automação
2. Crie uma nova regra:
   • Modelo: Lead/Oportunidade
   • Gatilho: Quando atualizados
   • Campos monitorados: Estágio
   • Condição (antes): Estágio != Ganho
   • Condição (depois): Estágio = Ganho
3. Na ação, selecione Executar código Python com:

# ID da pesquisa desejada (ajuste conforme necessário)
SURVEY_ID = 1

for lead in records:
    if not lead.partner_id:
        continue
    env['auto.survey.schedule'].create({
        'survey_id': SURVEY_ID,
        'partner_id': lead.partner_id.id,
        'lead_id': lead.id,
        'email': lead.partner_id.email or lead.email_from,
        'scheduled_date': datetime.datetime.now() + datetime.timedelta(hours=48),
        'state': 'scheduled',
    })

Exemplo: Agendar pesquisa na criação do lead

SURVEY_ID = 1

for lead in records:
    if not lead.partner_id:
        continue
    env['auto.survey.schedule'].create({
        'survey_id': SURVEY_ID,
        'partner_id': lead.partner_id.id,
        'lead_id': lead.id,
        'email': lead.partner_id.email or lead.email_from,
        'scheduled_date': datetime.datetime.now() + datetime.timedelta(hours=24),
        'state': 'scheduled',
    })

Dica: Para encontrar o ID da pesquisa, acesse Pesquisas > Pesquisas, abra a pesquisa desejada, e verifique o ID na URL (ex: /survey/survey/1).

---

Estrutura do Módulo

bitconn_auto_survey/
├── __init__.py
├── __manifest__.py
├── README.md
├── data/
│   ├── ir_cron_data.xml              # Crons de envio e verificação
│   └── mail_template_data.xml        # Template de e-mail
├── models/
│   ├── __init__.py
│   ├── auto_survey_schedule.py       # Modelo principal de agendamento
│   └── crm_lead.py                   # Extensão do CRM lead
├── security/
│   └── ir.model.access.csv           # Permissões de acesso
├── views/
│   ├── auto_survey_schedule_views.xml  # Views (list, kanban, form, search, menus)
│   └── crm_lead_views.xml              # Extensões do CRM (kanban, form, server action)
└── wizard/
    ├── __init__.py
    ├── auto_survey_schedule_wizard.py       # Wizard de agendamento
    └── auto_survey_schedule_wizard_views.xml

---

Instalação

1. Certifique-se de que os módulos crm e survey estão instalados.
2. Adicione o diretório bitconn_addons ao --addons-path do Odoo.
3. Atualize a lista de módulos e instale Bitconn Auto Survey.

---

Licença

Este módulo é distribuído sob a licença GPL-2.0.

© 2026 Diego F. Rodrigues — bitconn.com.br