Frenet — Status na planilha (cron)

O que faz

A cada hora, lê códigos de rastreio em uma Google Sheets, consulta a Frenet e — somente quando o status muda — envia WhatsApp e grava a coluna STATUS.

Ideal quando as etiquetas são geradas no painel Frenet (sem webhook) e você quer polling sem CRM.

Fluxo

1. Agendamento (0 * * * *)
2. Google Sheets — lê Página1!A2:D1000
3. Loop por linha (rastreio, nome, telefone, status)
4. Pula linha vazia ou status terminal
5. Frenet — POST /tracking/trackinginfo (ShippingServiceCode + código)
6. Se o status mudou → WhatsApp + atualiza coluna D

Planilha

| Coluna | Campo | |--------|--------| | A | Código de rastreio | | B | Nome do cliente | | C | Telefone com DDI (55…) | | D | STATUS (idempotência) |

Cabeçalho em D1 = STATUS.

Como o STATUS é definido

1. Preferência: EventDescription da Frenet (como chega)
2. Se vazio: label oficial do EventType (0 Postado, 1 Em trânsito, 2 Atraso, 3 Devolvido, 4 Extravio, 5 Saiu para entrega, 9 Entregue, 18 Aguardando coleta)
3. Sem eventos, mas com TrackingUrl → Postado (primeiro aviso)
4. Sem eventos e sem URL → não envia / não grava

Terminais (não reconsultam): texto em D com entregue, devolvid ou extravio.

Pré-requisitos

• Serviço Frenet conectado (token da loja)
• Serviço Google Sheets conectado
• Instância WhatsApp conectada
• Planilha com colunas A–D

Como configurar (após clonar)

1. Clone este template na sua empresa
2. Nós Google Sheets: selecione o serviço OAuth e a planilha; substitua YOUR_SPREADSHEET_ID nas URLs (ou use o seletor de planilha no nó)
3. Nó Frenet: selecione o serviço e confira ShippingServiceCode (padrão F_3 = Jadlog Package)
4. Nó WhatsApp: selecione a instância
5. Ative o cron (e/ou teste manual)
6. Preencha a planilha e dispare um teste

Testar

1. Telefones reais na coluna C
2. Disparo manual ou aguarde o horário
3. Histórico: gs-read → loop-1 → fr-track → js-status → wa-1 / gs-write

Problemas comuns

| Sintoma | O que checar | |---------|----------------| | Instância disconnected | Reconectar WhatsApp | | Sem mensagem | Sem TrackingUrl/eventos, ou STATUS já igual | | HTTP 400 Frenet | ShippingServiceCode incorreto para o código |