Pular para o conteúdo

API Pública, Webhooks e Rotinas Automáticas

As portas de entrada e saída pra sistemas de fora conversarem com o GestFone, e a maquinaria que roda sozinha, sem clique humano, cuidando de tarefas repetitivas 24 horas por dia.

11 funções

DonoGerenteMarketingFinanceiro

1 função deste capítulo não está pronta por inteiro. Ela está marcada com selo e aviso de atenção.

01

Feed público do catálogo em JSON

Pronto

Se a loja tem site próprio além do GestFone, não precisa manter dois catálogos sincronizados manualmente.

Endpoint que devolve o mesmo catálogo da vitrine em formato JSON, pra um site institucional externo consumir.

Como usar

  1. 1Peça pra quem desenvolve o site institucional consumir este endpoint com a chave de API da loja

Atenção

Protegido por chave de API própria — nunca deve ficar exposta no navegador do cliente final, só no servidor do site que consome.

DonoMarketing
/api/public/catalog/[storeSlug]
02

Recebimento de pedidos de assistência do site

Pronto

Pedido de conserto vindo do site institucional cai direto na fila de triagem, sem copiar e colar de formulário/e-mail.

Endpoint que recebe do site externo um pedido de conserto (nome, telefone, aparelho, problema) e cria uma solicitação pendente de triagem.

Atenção

Não vira Ordem de Serviço direto — fica como solicitação até alguém da loja triar e converter (ou rejeitar).

DonoGerente
/api/public/service-request/[storeSlug]
03

Arquivos e fotos servidos com isolamento por loja

Pronto

Garante que a foto de um cliente ou produto de uma loja nunca vaza pra outra loja que também usa o GestFone.

Proxy que exige sessão ativa e só serve arquivo cujo caminho bate com a loja do usuário logado.

Atenção

A validação de tipo de arquivo confere os 'bytes mágicos' reais, não confia no que o navegador declarou — impede arquivo malicioso disfarçado de imagem.

Dono
/api/uploads/{loja}/{pasta}/{arquivo}
04

Verificação pública de saúde do sistema

Pronto

Permite que monitoramento (ou o suporte técnico) confirme que o GestFone está no ar, sem entrar no sistema.

Endpoint simples que devolve status, versão e horário do servidor, sem exigir login.

Dono
/api/health
05

Agendador interno automático (a cada 30 minutos)

Pronto

O dono não precisa configurar nada — o sistema se auto-organiza sozinho, mesmo com ninguém logado.

Relógio embutido no próprio sistema que dispara, a cada 30 min, varredura de alertas, envio de mensagens pendentes, régua pós-venda e varredura de SLA.

Atenção

Tem 'kill switch' de emergência (variável de servidor) e cada uma das 4 tarefas roda isolada — se uma falhar, as outras três continuam.

Dono
06

Saudação automática de aniversário no WhatsApp

Pronto

O cliente recebe o 'parabéns' sem ninguém da equipe precisar lembrar da data.

Todo dia, verifica quem faz aniversário hoje e tem WhatsApp cadastrado, e enfileira mensagem de parabéns personalizada.

Atenção

É idempotente por cliente e dia — rodar duas vezes não manda em dobro.

DonoMarketing
/api/cron/birthday-greetings
07

Régua automática de relacionamento pós-venda

Pronto

Mantém contato pós-venda sistemático sem depender de alguém lembrar de mandar mensagem X dias depois.

Avança a sequência de mensagens programadas pós-venda (D1-D30, pedido de avaliação) pra todos os clientes inscritos.

Atenção

Processa até 200 clientes por ciclo — evita sobrecarregar o envio de uma vez só. É pausada automaticamente se o cliente responder de verdade.

DonoMarketing
/api/cron/cadence-tick
08

Entrega das mensagens com proteção anti-bloqueio

Pronto

O número de WhatsApp da loja fica protegido contra bloqueio por volume suspeito de envio.

Entrega de fato as mensagens da fila, respeitando um limite por loja a cada execução (padrão 20).

DonoMarketing
/api/cron/flush-outbox
09

Varredura de prazos de atendimento (SLA)

Pronto

Descobre automaticamente quando um prazo prometido ao cliente foi furado, sem auditar OS uma por uma.

Verifica se algum prazo prometido foi estourado e gera evento de responsabilização ligado ao funcionário responsável.

Atenção

Cada execução é isolada por loja — falha numa loja não trava a varredura das demais.

DonoGerente
/api/cron/sla-sweep
10

Geração automática de oportunidades de recompra

Funciona em parte

O time de vendas recebe lista pronta de 'quem abordar agora' em vez de vasculhar a base manualmente.

Roda pra todas as lojas ativas gerando 'oportunidades' de recompra no CRM.

Atenção

O motor tem 6 tipos possíveis de sinal de recompra cadastrados, mas só 4 deles rodam de verdade hoje — os outros 2 nunca são varridos. Não prometa que 'todo padrão de recompra' vira oportunidade automaticamente.

DonoMarketing
/api/cron/generate-opportunities
11

Segredo compartilhado protegendo todas as rotinas automáticas

Pronto

Ninguém de fora consegue disparar varredura ou reenvio de mensagens da loja sem conhecer a chave secreta.

Todo endpoint de rotina exige um segredo enviado no cabeçalho da requisição — sem ele configurado, o endpoint se recusa a rodar.

Atenção

O segredo só é aceito via cabeçalho HTTP, nunca na URL — evita vazar em log de acesso de proxy/CDN.

Dono
/api/cron/*

O que cada selo quer dizer

Pronto

Funciona hoje, do jeito que está escrito aqui.

Precisa configurar

O sistema faz, mas depende de uma conta, credencial ou credenciamento seu.

Funciona em parte

A tela existe, mas o caminho não fecha inteiro. Leia o aviso antes de confiar.

Ainda não

Está no plano, não existe hoje. Não conte com isso.

← Voltar ao índice do manual