Roteiro de Treinamento — Assistência Técnica no Bitrix24
Empresa: Salk Medical / Mendel Medical Versão: 3.0 — Maio 2026 (pós Sprint #8: Híbrido Company+SPA, NA-005 automático, RAS digital, 7 e-mails, SSO Authentik) Audiência: novos colaboradores da AT (gestão, executoras) — assume zero conhecimento prévio
Como usar este roteiro
5 sessões de ~45 minutos. Cada sessão tem objetivo, prática e validação (perguntas que o aprendiz responde no fim). Faça em ordem.
Tempo total: 3-4 horas distribuídas em 2-3 dias.
Sessão 1 — O Bitrix24 (não é o Protheus)
Objetivo. Entender que o sistema de trabalho da AT mudou: agora o operacional acontece no Bitrix24. Protheus continua sendo registro oficial fiscal (Pedido de Venda, NF) mas o dia-a-dia da AT vive no Bitrix24.
Conceitos.
- CRM Bitrix24 — sistema de gestão de relacionamento. No nosso caso, gestão de OSs, empresas, contatos
- Smart Process (SPA) — pipeline customizado. O SPA "Assistência Técnica" (ID interno 1068) tem 5 pipelines: Instalação, Manutenção, Vistoria, Help Desk, Peças. Cada OS é um item dentro do SPA
- Company — cadastro de empresa. AT Autorizada é Company com
TYPE_ID=AT_AUTORIZADA. Cliente é Company padrão. Representante é Company comTYPE_ID=REPRESENTANTE - Contact — pessoa física dentro de uma empresa (interlocutor)
- Activity — registro de atividade no timeline (call, email, task)
Prática.
- Acessar
https://salkmedical.bitrix24.com.brvia SSO Authentik - Navegar entre CRM → Empresas → Contatos + Automação → AT
- Procurar uma Company qualquer pela busca global
- Abrir uma OS existente (qualquer pipeline AT) e olhar a estrutura: campos, abas, timeline, layout em seções
Validação.
- Qual o ID interno do SPA AT?
- Quais 5 categorias o SPA AT tem?
- Onde está o ciclo de Qualificação de AT Autorizada (qual SPA)?
- TYPE_ID de Representante é qual valor?
Sessão 2 — A vida de uma OS de Instalação
Objetivo. Percorrer mentalmente um caso real do começo ao fim. Entender quando cada estágio se aplica e o que faz o sistema mover.
Cenário. Cliente X compra um Foco Teto Duplex. O comercial inclui PDV no Protheus marcando como "instalação por nossa conta". A AT precisa instalar.
Sequência conversada.
- PDV Recebido — Você (executora AT) recebe notificação (futuramente automática via Pr7; hoje manual). Cria item no pipeline Instalação, preenche cliente/equipamento.
- Triagem Técnica — Você seleciona a AT Autorizada da região (Company AT da UF do cliente). Define prioridade, severidade, classifica ocorrência. Stage Gate v2 te força a preencher os 10 campos obrigatórios.
- AT Alocada — Aguarda Aceite — Quando você muda para este estágio, o robô at-poller (em até 60s) dispara E-mail 1 para o e-mail técnico da AT (UF
AT — E-mail técnicoda Company). E-mail vai com PDF "Manual da AT Autorizada Externa" anexado + link público pra RAS. - Aguarda Entrega — BackOffice cuida do embarque + nota fiscal. Você acompanha. Robô dispara E-mails 2, 3, 4 automaticamente.
- Em Instalação — Equipamento entregue, AT no cliente fazendo instalação. Robô dispara E-mail 5.
- RAS Recebido + Aceite — AT preenche RAS digital pelo link público. Sistema atualiza OS automaticamente. Você usa o Checklist Validação RAS (doc separado) para conferir qualidade.
- Processo Financeiro — Você libera faturamento. Robô dispara E-mail 6 para Compras.
- Encerrado — NFe emitida. Robô dispara E-mail 7 para Financeiro. OS finalizada.
Prática.
Crie uma OS de teste em Automação → AT → Instalação:
- Título: "TREINAMENTO — DELETAR"
- Cliente: você mesmo
- Empresa: qualquer Company
- Produto: qualquer
- Sub-Grupo: qualquer
- Nº Série: "TESTE-123"
Tente mover para Triagem. Stage Gate vai te bloquear. Anote quais campos ele exige.
Depois preencha os campos faltantes e mova.
No final, delete a OS-teste (3 pontinhos → Excluir).
Validação.
- Quantos e-mails automáticos saem no fluxo Instalação? Para quem?
- O que é Stage Gate v2 e como destravar?
- Em que estágio o RAS digital é preenchido pela AT? Pelo Bitrix24 ou link externo?
Sessão 3 — NA-005 e cálculo automático
Objetivo. Entender que você não calcula NA-005 manual mais. Sistema faz.
Tabela NA-005 (memorize as bases):
- Hora trabalhada: R$ 180,00
- KM Urbano: R$ 2,80
- KM Rodoviário: R$ 1,80
- Diária: R$ 220,00
- Pedágio: valor real
- Instalação por equipamento: R$ 180 a R$ 810 (varia por produto)
Prática.
Abra uma OS de Manutenção qualquer (ou crie uma de teste). Preencha:
- Horas: 4,5
- KM Urbano: 8
- KM Rodoviário: 0
- Diárias: 0
- Pedágio: 0
- Valor Instalação: 0
Salve. Espere até 1 minuto.
Volte ao card. O Valor do Serviço deve aparecer = 4,5 × 180 + 8 × 2,80 = R$ 832,40.
Agora altere Horas para 5,5. Espere 1 minuto. Valor do Serviço deve recalcular = 5,5 × 180 + 8 × 2,80 = R$ 1012,40.
Validação.
- Quanto fica
Valor do Serviçopara: 6h + 15 km urb + 30 km rod + 1 diária + R$ 25 pedágio + R$ 540 instalação? (resposta: R$ 6 × 180 + 15 × 2,80 + 30 × 1,80 + 1 × 220 + 25 + 540 = R$ 1907,00) - Quando o sistema arredondaria 5,5 horas para 6? (resposta: nunca mais — PRECISION=2 nos UFs double desde Sprint #7)
- Onde estão as constantes NA-005 versionáveis? (resposta:
at-na005-constants.jsonno servidor)
Sessão 4 — Cadastro de AT Autorizada (Híbrido)
Objetivo. Saber cadastrar uma AT nova do zero, no modelo Híbrido.
Conceito-chave. AT Autorizada vive em DOIS lugares:
- Company (cadastro permanente — CNPJ, dados bancários, cobertura) com
TYPE_ID=AT_AUTORIZADA - SPA "Qualificação AT" (workflow periódico — IQS, treinamentos, datas de qualificação)
A mesma Company pode ter N itens de Qualificação ao longo dos anos (re-qualificação anual conforme SGQ).
Prática.
- Cadastre uma Company AT fictícia:
- CRM → Empresas → + Adicionar - Razão Social: "AT Fictícia Treinamento — DELETAR" - TYPE_ID: AT Autorizada - Preencher todos os UFs AT — (cobertura, famílias, bancário, contato técnico, telefone)
- Crie o primeiro ciclo de Qualificação:
- Automação → AT → Qualificação AT → + Item - Vincular à Company recém-criada - Data início qualificação: hoje - IQS-CCP / QSP / TDS / DOC: preencher valores fictícios (cada um 0-25) - Estágio: deixe em "Em Avaliação"
- Verifique que a Company aparece em CRM → Empresas → filtro TYPE_ID=AT Autorizada
- Delete os 2 itens de teste no fim
Validação.
- Por que o cadastro está separado em Company + SPA? (resposta: SGQ exige re-qualificação periódica e histórico auditável; padrão Bitrix24)
- Onde fica o e-mail técnico que vai receber Solicitação de Instalação? (resposta:
UF — AT — E-mail técnicona Company) - Como uma empresa pode ser AT + Representante simultaneamente? (resposta: TYPE_ID=REPRESENTANTE + flag boolean
Rep — Tem AT própria = Sim+ preencher UFsAT —)
Sessão 5 — Reclamações e SLA 30 dias
Objetivo. Entender o SPA Reclamações (1090) — PS-022.
Conceito. Toda reclamação formal de cliente (não confundir com SAC = dúvida) tem prazo de 30 dias para resposta. O Bitrix24 calcula Data Limite Resposta automaticamente.
Prática.
- Acesse Automação → AT → Reclamações → + Item
- Preencha:
- Cliente e Empresa - Canal Recebimento: WhatsApp - Tipo: Reclamação - Descrição: texto livre
- Salve. Aguarde 1 minuto.
- Volte ao card. O campo
Data Limite Respostaestá preenchido =today + 30 dias. Mágica do at-poller.
Validação.
- Qual a diferença entre Reclamação, SAC e Devolução? (resposta: tipo enum no card)
- Onde fica o número único da reclamação? (resposta: numerator
REC-NNN/AAAAno card) - O que acontece quando faltam 7 dias para o prazo? (resposta: at-poller notifica o RD — Responsável Designado)
Encerramento
Após as 5 sessões:
- [ ] Tour pelo Bitrix24 confortável
- [ ] Criou e deletou pelo menos 3 itens de teste (OS Instalação, Qualificação AT, Reclamação)
- [ ] NA-005 calculou pelo menos 1 vez para você
- [ ] Stage Gate v2 te bloqueou pelo menos 1 vez (e você destravou)
- [ ] Sabe onde olhar quando dá erro (poll-log.txt, gestão AT, este roteiro)
Próximo passo. Acompanhar 3 OSs reais com gestão AT olhando junto (observar, não operar). Depois assumir 1 caso real.
Salk Medical — Roteiro Treinamento AT v3.0 — Maio 2026