Templates de Comunicação AT — Salk Medical

Versão 3.0 — Maio 2026. Os 7 e-mails do IT-050-MS agora são automatizados (handler at-mail-automation). Este documento lista o que cada um faz, quando dispara e quando você usa templates manuais (WhatsApp/voz).

Os 7 e-mails automáticos (IT-050-MS)

Cada e-mail dispara automaticamente quando você muda a OS para o estágio gatilho. Você não envia manualmente — exceto pra correções ou follow-up extra.

Os templates HTML ficam em /home/skmcom/public_html/at-mail/templates/ no servidor. Texto editável sem deploy de código (a próxima execução do at-poller já usa o template novo).

Template 1 — Solicitação de Instalação

• Gatilho: estágio Triagem Técnica → AT Alocada (cat 22)
• Destinatário: AT Autorizada — campo UF — AT — E-mail técnico da Company com TYPE_ID=AT_AUTORIZADA
• Anexo: PDF "Manual da AT Autorizada Externa"
• Merge fields: os_num, cliente_nome, endereco, produto, subgrupo, ns, pdv_protheus, custo_total, link_ras

Conteúdo essencial:

Solicitação de Instalação — OS {{os_num}}

Olá,

Solicitamos os serviços de instalação para o cliente abaixo:

Cliente:     {{cliente_nome}}
Endereço:    {{endereco}}
Equipamento: {{produto}} (NS {{ns}})
Subgrupo:    {{subgrupo}}
Pedido:      {{pdv_protheus}}
Valor:       R$ {{custo_total}}

Link para preencher o RAS após instalação: {{link_ras}}

Anexo: Manual da AT Autorizada Externa (PDF)

Equipe AT Salk Medical

Template 2 — Apresentação da AT

• Gatilho: AT Alocada → Aguarda Entrega ao Cliente
• Destinatário: Cliente (Contact da OS)

Sua instalação — apresentação da equipe técnica

Olá {{contato}},

A instalação do seu equipamento {{produto}} será realizada pela equipe abaixo:

AT Autorizada: {{at_nome}}
Contato:       {{at_contato}}
Telefone:      {{at_telefone}}
Previsão:      {{prev_visita}}

Qualquer dúvida estamos à disposição.

Salk Medical — Atendimento Técnico

Template 3 — Comunicado de Embarque

• Gatilho: Aguarda Entrega ao Cliente → Em Instalação
• Destinatário: Cliente + AT (ambos)

Equipamento embarcado — OS {{os_num}}

Informamos que seu equipamento foi embarcado:

Nota Fiscal:        {{nota_fiscal}}
Data Emissão:       {{data_emissao_nf}}
Previsão Entrega:   {{prev_entrega}}

Salk Medical

Template 4 — Envio da OS à AT Autorizada

• Gatilho: mesma transição do Template 3 (Aguarda Entrega → Em Instalação)
• Destinatário: AT Autorizada

Envio da OS — equipamento entregue

OS {{os_num}} pronta para instalação:

Cliente:     {{cliente_nome}}
Equipamento: {{produto}} (NS {{ns}})
Endereço:    {{endereco}}

Link RAS para preenchimento: {{link_ras}}

Equipe AT Salk Medical

Template 5 — Comunicado de Entrega

• Gatilho: Em Instalação
• Destinatário: Cliente

Equipamento entregue — instalação iniciada

Olá {{contato}},

Confirmamos a entrega do equipamento {{produto}}.

A equipe técnica {{at_nome}} ({{at_telefone}}) entrará em contato para confirmar a instalação.

Previsão: {{prev_visita}}

Salk Medical

Template 6 — Solicitação de Compra (interno)

• Gatilho: RAS Recebido + Aceite → Processo Financeiro
• Destinatário: Compras — compras@managergrupo.com.br

Solicitação de Compra — pagamento AT

Solicitamos pagamento à AT Autorizada referente à OS {{os_num}}:

AT Autorizada: {{at_nome}}
CNPJ:          {{at_cnpj}}
Valor NA-005:  R$ {{vlr_servico}}
Cliente:       {{cliente_nome}}
RAS arquivado: {{ras_link}}

Salk Medical — Atendimento Técnico

Template 7 — Autorização de Faturamento (interno)

• Gatilho: Processo Financeiro → Encerrado
• Destinatário: Financeiro — financeiro@managergrupo.com.br

Autorização de Faturamento — OS {{os_num}}

OS encerrada, autorizamos faturamento:

Cliente:        {{cliente_nome}}
Nota Fiscal:    {{nota_fiscal}}
Valor Total:    R$ {{custo_total}}
Status Garantia: {{status_gar}}

Salk Medical

Quando você usa templates manuais (NÃO automáticos)

WhatsApp — Cliente perguntou status da OS

Olá [Nome do contato],

Sua OS {nº} está em [estágio atual].
Previsão de [próxima ação]: [data].

Qualquer dúvida estou aqui.

Atenciosamente,
[Seu nome] — Salk Medical AT

WhatsApp — AT Autorizada não retornou aceite

Olá [contato AT],

Estamos aguardando aceite da Solicitação de Instalação OS {nº} enviada por e-mail em [data].

Pode confirmar recebimento e prazo de visita?

Atenciosamente,
[Seu nome] — Salk Medical AT

WhatsApp — Devolução de RAS incompleto

Olá [contato AT],

Recebemos o RAS da OS {nº} mas faltam algumas informações:

- [item 1 faltante]
- [item 2 faltante]
- [item 3 faltante]

Pode acessar o link da OS novamente e completar? Sistema fica esperando.

Link: {link_ras}

Obrigada,
[Seu nome] — Salk Medical AT

Voz — Cliente quer falar com um técnico

Direcione para o telefone da AT executora:

• Olhe na OS: campo AT Autorizada
• Clique na Company → leia UF — AT — Telefone técnico (formato E.164)

Não dê seu próprio telefone direto a menos que seja escalação ou problema grave.

Voz — AT Autorizada quer falar com gestão

Encaminhe para Zeni (UF_DEPARTMENT = AT Gestão). Telefone próprio + ramal corporativo.

Boas práticas

• Idioma: sempre Português BR formal-amistoso. Sem gírias, sem "tcharãn" — público é técnico hospitalar.
• Assinatura: sempre identifica nome + função + Salk Medical AT. Cliente precisa saber quem fala.
• Anexos: PDF "Manual da AT Autorizada Externa" só no Template 1 (automatizado). Outros anexos manuais só se cliente pedir.
• Tom: se houve atraso ou erro, assume responsabilidade primeiro ("Pedimos desculpa pelo atraso"), depois ação ("Estamos resolvendo isso agora") e por último explicação (se cabível).
• Confirmação: sempre confirme leitura quando crítico (resposta + emoji + "ok recebido").

Para administradores: editar os templates automáticos

Os 7 HTMLs estão em /home/skmcom/public_html/at-mail/templates/ — 1 arquivo por template:

01-solicitacao-instalacao.html
02-apresentacao-at.html
03-comunicado-embarque.html
04-envio-os-autorizada.html
05-comunicado-entrega.html
06-solicitacao-compra.html
07-autorizacao-faturamento.html

Editar via SSH (Squad Servidor cuida) ou via cPanel File Manager. Próxima execução do at-poller (até 60s) já usa o template novo. Não precisa restart nem deploy.

Variáveis disponíveis: {{os_num}}, {{cliente_nome}}, {{contato}}, {{endereco}}, {{produto}}, {{subgrupo}}, {{ns}}, {{pdv_protheus}}, {{custo_total}}, {{vlr_servico}}, {{nota_fiscal}}, {{data_emissao_nf}}, {{prev_entrega}}, {{at_nome}}, {{at_contato}}, {{at_telefone}}, {{prev_visita}}, {{status_gar}}, {{link_ras}}, {{ras_link}}.

Salk Medical — Templates Comunicação AT v3.0 — Maio 2026