{ "chave": "confirmacao-diaria", "versao": "1.6", "nome": "Confirmação diária", "descricao": "Uma vez por dia, convida pelo WhatsApp quem ainda não confirmou a consulta de hoje ou de amanhã.", "escopo": "por-tenant", "roles": [ { "nome": "botfn-confirmacao-diaria", "grants": [ "agendamento:list", "campanha:disparar", "cliente:read:full", "profissionais:read" ] } ], "agentes": [ { "chave": "confirmacao_diaria", "descricao": "Procura os agendamentos de hoje e de amanhã sem confirmação e envia o convite para confirmar pelo WhatsApp.", "tipo": "script", "roles": [ "botfn-confirmacao-diaria" ], "triggers": [ { "cron": "0 12 * * *", "enabled": true } ], "config": { "script": "// confirmacao_diaria — agente `script` (MACRO). Comportamento = ESTE arquivo (DADO).\n//\n// UMA vez por dia (trigger cron), junta os agendamentos ainda NÃO confirmados pelo paciente\n// (sem RSVP, não confirmados pela recepção, públicos, fora de status terminal) dentro de uma\n// JANELA que vai de HOJE até o PRÓXIMO DIA DE ENVIO — e dispara UMA campanha WhatsApp com o\n// HSM `confirmar_presenca` (1 destinatário por agendamento). A RESPOSTA do botão volta sozinha\n// pelo time `confirmacao-presenca`.\n//\n// JANELA / DIAS SEM ENVIO (config `dias_sem_envio`, default [0,6] = domingo e sábado):\n// - Se HOJE é um dia sem envio, o agente NÃO dispara nada (loga e sai limpo).\n// - Senão, a janela vai de hoje até o próximo dia de envio a partir de amanhã (inclusive).\n// Com o default, seg–qui cobre hoje+amanhã; SEXTA cobre sexta+sábado+domingo+segunda.\n//\n// RESULTADO (result()): o agente declara um RESUMO SEGURO (contagens/flags, sem PII) que\n// aparece no drill-down da execução na Central — pra o operador acompanhar sem ler log.\n// Também marca `acao_bloqueada` quando uma call() falha (ex.: egress off) — assim um agente\n// sandboxado/quebrado NÃO se disfarça de \"0 pendentes / ok\".\n//\n// PERSONALIZAÇÃO (obrigatória p/ o HSM): a Meta exige TODOS os 4 params não-vazios; o agente\n// resolve cliente_nome (1º nome) + profissional_apelido, pega servico_nome (NOME DO PACOTE\n// quando é pacote) e formata data_hora — sempre com fallback não-vazio.\n//\n// Injetados: event, config, context, call()->{ok,status_code,body}, log(), result().\n\nvar cfg = config || {};\nvar minLeadMin = (cfg.min_lead_minutos !== undefined && cfg.min_lead_minutos !== null) ? cfg.min_lead_minutos : 120;\nvar tzOffset = cfg.tz_offset || '-03:00';\nvar statusPular = cfg.status_pular || ['Cancelado', 'Falta', 'Atendido', 'Realizado'];\nvar diasSemEnvio = cfg.dias_sem_envio || [0, 6]; // 0=domingo ... 6=sábado (fuso da clínica)\nvar perPage = cfg.per_page || 100;\nvar canalPolicy = cfg.canal_policy || 'so_whatsapp';\nvar templateSlug = cfg.template_slug || 'confirmar_presenca';\nvar nomeCampanha = cfg.nome_campanha || 'Confirmação diária';\nvar LOTE_MAX = 500;\nvar MAX_PAGINAS = 30;\nvar DIA_MS = 86400000;\n\nfunction unwrap(r) {\n if (!r || !r.ok) return null;\n var b = r.body;\n return (b && b.data !== undefined) ? b.data : b;\n}\nfunction offsetMin(s) {\n var m = /^([+-])(\\d{2}):(\\d{2})$/.exec(String(s));\n if (!m) return -180;\n var val = parseInt(m[2], 10) * 60 + parseInt(m[3], 10);\n return m[1] === '-' ? -val : val;\n}\nfunction pad(n) { return (n < 10 ? '0' : '') + n; }\nfunction partesLocais(ms) {\n var d = new Date(ms + offsetMin(tzOffset) * 60000);\n return {\n data: d.getUTCFullYear() + '-' + pad(d.getUTCMonth() + 1) + '-' + pad(d.getUTCDate()),\n dia: pad(d.getUTCDate()), mes: pad(d.getUTCMonth() + 1),\n hh: pad(d.getUTCHours()), mm: pad(d.getUTCMinutes())\n };\n}\n// Dia da semana LOCAL (fuso da clínica): 0=domingo ... 6=sábado.\nfunction diaSemanaLocal(ms) {\n return new Date(ms + offsetMin(tzOffset) * 60000).getUTCDay();\n}\nfunction dataHoraBR(p) { return p.dia + '/' + p.mes + ' às ' + p.hh + ':' + p.mm; }\n\n// Nome do serviço p/ a mensagem: NOME DO PACOTE quando é pacote; senão procedimento/produto.\nfunction servicoNome(ag) {\n var venda = ag.venda;\n if (!venda || !venda.itens || !venda.itens.length) return null;\n for (var i = 0; i < venda.itens.length; i++) {\n if (venda.itens[i] && venda.itens[i].pacote_nome) return venda.itens[i].pacote_nome;\n }\n for (var j = 0; j < venda.itens.length; j++) {\n var it = venda.itens[j] || {};\n if (it.procedimento_nome) return it.procedimento_nome;\n if (it.produto_nome) return it.produto_nome;\n }\n return null;\n}\n\n// --- enrich: 1º nome do paciente + apelido do profissional (com cache) ---\nfunction primeiroNome(nome) {\n var s = String(nome || '').trim();\n if (!s) return null;\n var i = s.indexOf(' ');\n return i > 0 ? s.substring(0, i) : s;\n}\nvar _cliCache = {};\nfunction clienteNome(id) {\n if (!id) return null;\n var k = String(id);\n if (_cliCache[k] !== undefined) return _cliCache[k];\n var d = unwrap(call('buscar_cliente', { cliente_id: k }));\n _cliCache[k] = (d && d.nome) ? primeiroNome(d.nome) : null;\n return _cliCache[k];\n}\nvar _profCache = {};\nfunction profApelido(id) {\n if (!id) return null;\n var k = String(id);\n if (_profCache[k] !== undefined) return _profCache[k];\n var d = unwrap(call('buscar_profissional', { id: k }));\n _profCache[k] = d ? (d.apelido || d.nome || null) : null;\n return _profCache[k];\n}\n\n// ---- referências temporais (epoch absoluto + fuso da clínica) ----\nvar nowMs = Date.now();\n\n// Set de dias sem envio (fuso da clínica).\nvar semEnvio = {};\nfor (var w = 0; w < diasSemEnvio.length; w++) semEnvio[Number(diasSemEnvio[w])] = true;\n\n// HOJE é dia sem envio? -> não dispara nada.\nif (semEnvio[diaSemanaLocal(nowMs)]) {\n log('confirmacao_diaria: hoje é dia sem envio (dow=' + diaSemanaLocal(nowMs) + ') — nada disparado');\n result({ pulado: 'dia_sem_envio', dow: diaSemanaLocal(nowMs), campanhas: 0, destinatarios: 0 });\n return { ok: true, pendentes: 0, campanhas: 0, pulado: 'dia_sem_envio', dow: diaSemanaLocal(nowMs) };\n}\n\n// Fim da janela = próximo DIA DE ENVIO a partir de amanhã (pula os dias sem envio).\nvar k = 1;\nwhile (k <= 7 && semEnvio[diaSemanaLocal(nowMs + k * DIA_MS)]) k++;\n\nvar cutoffMs = nowMs + minLeadMin * 60000;\nvar hoje = partesLocais(nowMs).data;\nvar fimData = partesLocais(nowMs + k * DIA_MS).data;\nvar ini = hoje + 'T00:00:00' + tzOffset;\nvar fim = fimData + 'T23:59:59' + tzOffset;\n\nvar pular = {};\nfor (var s = 0; s < statusPular.length; s++) pular[String(statusPular[s]).toLowerCase()] = true;\n\n// ---- 1) coleta paginada + recorte ----\nvar pendentes = [];\nvar pagina = 1;\nwhile (pagina <= MAX_PAGINAS) {\n var raw = call('listar_nao_confirmados', {\n data_inicio: ini, data_fim: fim,\n confirmado: 'false', rsvp_cliente: 'sem_resposta',\n per_page: perPage, page: pagina\n });\n // Chamada BLOQUEADA/falhou (egress off, 403, 5xx, timeout) NÃO é \"lista vazia\": torna\n // visível em vez de fingir 0 pendentes (o agente sandboxado não se disfarça de verde).\n if (raw && !raw.ok) {\n log('confirmacao_diaria: FALHA ao listar (HTTP ' + (raw.status_code || '?') + ' ' + (raw.error || '') + ')');\n result({ acao_bloqueada: true, etapa: 'listar_nao_confirmados', http: raw.status_code || null,\n erro: raw.error || 'chamada não-ok', campanhas: 0, destinatarios: 0 });\n return { ok: false, erro: 'listar_falhou', http: raw.status_code || null };\n }\n var lista = unwrap(raw);\n if (!lista || !lista.length) break;\n for (var kk = 0; kk < lista.length; kk++) {\n var ag = lista[kk];\n if (!ag || !ag.id) continue;\n if (ag.visibilidade && String(ag.visibilidade) !== 'publica') continue;\n if (ag.status && pular[String(ag.status).toLowerCase()]) continue;\n if (!ag.cliente_id) continue;\n var startMs = Date.parse(ag.data_inicio);\n if (isNaN(startMs)) continue;\n var loc = partesLocais(startMs);\n if (loc.data < hoje || loc.data > fimData) continue; // fora da janela [hoje..fimData]\n if (loc.data === hoje && startMs < cutoffMs) continue; // hoje respeita o lead mínimo\n ag.__loc = loc;\n pendentes.push(ag);\n }\n if (lista.length < perPage) break;\n pagina++;\n}\n\n// contagem por dia (pro resumo do operador).\nfunction contarPorDia(arr) {\n var m = {};\n for (var i = 0; i < arr.length; i++) { var d = arr[i].__loc.data; m[d] = (m[d] || 0) + 1; }\n return m;\n}\n\nif (!pendentes.length) {\n log('confirmacao_diaria: nenhum agendamento pendente (janela ' + ini + '..' + fim + ', lead ' + minLeadMin + 'min)');\n result({ pendentes: 0, campanhas: 0, destinatarios: 0, janela: hoje + '..' + fimData });\n return { ok: true, pendentes: 0, campanhas: 0, janela: { de: ini, ate: fim }, min_lead_minutos: minLeadMin };\n}\n\n// ---- 2) monta destinatários (1 por agendamento; os 4 params do HSM, não-vazios) ----\nvar destinatarios = [];\nfor (var p = 0; p < pendentes.length; p++) {\n var a = pendentes[p];\n var vars = {\n cliente_nome: clienteNome(a.cliente_id) || 'paciente',\n servico_nome: servicoNome(a) || 'consulta',\n profissional_apelido: profApelido(a.profissional_id) || 'a clínica',\n data_hora: dataHoraBR(a.__loc)\n };\n destinatarios.push({\n cliente_id: String(a.cliente_id),\n variaveis: vars,\n referencia_tipo: 'agendamento',\n referencia_id: String(a.id)\n });\n}\n\n// ---- 3) dispara em lotes de até 500 ----\nvar campanhas = 0, enviados = 0, falhaLote = null;\nvar multi = destinatarios.length > LOTE_MAX;\nfor (var base = 0; base < destinatarios.length; base += LOTE_MAX) {\n var lote = destinatarios.slice(base, base + LOTE_MAX);\n var nome = nomeCampanha + ' (' + hoje + ')' + (multi ? ' #' + (campanhas + 1) : '');\n var r = call('disparar_campanha', {\n nome: nome,\n canal_policy: canalPolicy,\n template_slug: templateSlug,\n variaveis_base: {},\n destinatarios: lote,\n referencia_tipo: 'agendamento',\n dedup_por_referencia: true,\n dedup_janela_horas: 12, // anti duplo-disparo: pula o mesmo agendamento na janela; re-nudge diario (24h) passa\n rascunho: false\n });\n if (r && r.ok) { campanhas++; enviados += lote.length; }\n else {\n falhaLote = { http: (r && r.status_code) || null, erro: (r && r.error) || 'disparo não-ok' };\n log('confirmacao_diaria: FALHA no lote ' + (campanhas + 1) + ' HTTP ' + (r && r.status_code));\n }\n}\n\nlog('confirmacao_diaria: ' + pendentes.length + ' pendente(s) -> ' + campanhas + ' campanha(s), ' + enviados + ' destinatário(s)');\nvar resumo = {\n pendentes: pendentes.length,\n campanhas: campanhas,\n destinatarios: enviados,\n por_dia: contarPorDia(pendentes),\n janela: hoje + '..' + fimData\n};\nif (falhaLote) { resumo.acao_bloqueada = true; resumo.etapa = 'disparar_campanha'; resumo.http = falhaLote.http; resumo.erro = falhaLote.erro; }\nresult(resumo);\nreturn {\n ok: !falhaLote, pendentes: pendentes.length, campanhas: campanhas, destinatarios: enviados,\n janela: { de: ini, ate: fim }, min_lead_minutos: minLeadMin\n};\n", "min_lead_minutos": 120, "tz_offset": "-03:00", "status_pular": [ "Cancelado", "Falta", "Atendido", "Realizado" ], "dias_sem_envio": [ 0, 6 ], "per_page": 100, "canal_policy": "so_whatsapp", "template_slug": "confirmar_presenca", "nome_campanha": "Confirmação diária", "acoes": [ { "nome": "listar_nao_confirmados", "capability": "agendamento.listar_agendamentos", "kind": "internal" }, { "nome": "buscar_cliente", "capability": "clientes.buscar_cliente", "kind": "internal" }, { "nome": "buscar_profissional", "capability": "estabelecimento.buscar_profissional", "kind": "internal" }, { "nome": "disparar_campanha", "capability": "interacoes.agendar_campanha", "kind": "internal" } ] } } ], "knobs": [] }