Integrações do Sistema

Especificação de conectores externos, fluxos de webhooks, APIs de terceiros, sincronização de pixels e automações.

1. Integração Hotmart

O DevCod Agency integra-se nativamente com a Hotmart para sincronização automática de vendas e controle de acesso a infoprodutos.

Assinatura HMAC: Toda requisição POST no endpoint /api/webhooks/hotmart é validada contra o token secreto de webhook do tenant (armazenado em IntegrationConfig). Se a assinatura não bater com o cabeçalho X-Hotmart-Signature, a requisição é rejeitada (401).
Resolução de Tenant: O processador resolve o tenant de forma determinística: primeiro busca o ID do produto na tabela global IntegrationConfig para achar o tenant associado; caso não encontre, realiza busca cruzada no CRM pelo e-mail do comprador.
Ações de Ingestão: Ao receber a aprovação, o CRM muda o status do Lead para Cliente, calcula touchpoints de atribuição para ROI, atualiza relatórios financeiros de receita e dispara os pixels de conversão.

O sistema fornece suporte completo à Meta Graph API para publicação e agendamento automático de conteúdos nos perfis do tenant:

Publicações no Facebook: O método publishToFacebook permite postar atualizações textuais e fotos com links de forma imediata ou agendada (via UNIX timestamp) nas Facebook Pages.
Publicações no Instagram: Integração com a API de publicação de conteúdo de contêiner de mídia do Instagram Business para postar posts e imagens.
Lead Ads (Facebook): Mapeamento direto de FB Lead Ads convertendo preenchimentos diretamente em contatos do CRM DevCod sem precisar de intermediários.
Segurança e Tokens: O campo pageAccessToken é criptografado em repouso no banco usando algoritmos de criptografia de segredo JSON, garantindo que as chaves de integração não fiquem expostas publicamente.

Configurações nativas de análise de dados e tráfego pago baseadas em variáveis de ambiente e banco de dados por tenant:

Google Analytics 4 (GA4): Sincronização automatizada do ID de Medição (NEXT_PUBLIC_GA_MEASUREMENT_ID) para rastrear eventos de visualização de página e cliques em botões.
Serper.dev: Utilizado pelo Swarm de Agentes para realizar varreduras de busca no Google em tempo real durante a execução de pesquisas de concorrentes e auditorias de SEO.

Mapeamento de webhooks e robôs internos para manter os canais corporativos atualizados sobre as metas do sistema:

Telegram Admin Bot: Canal de notificação configurado via TELEGRAM_ADMIN_BOT_TOKEN para disparar resumos diários de vendas, faturamento de tenants e alertas do sistema.
Discord Webhook: Envio de webhooks formatados de eventos em tempo real (como novos cadastros e erros críticos do sistema) para canais específicos de monitoramento da equipe.

Conectores de alta performance para armazenamento e cache distribuído:

Supabase Storage & Auth: Integração de backend para persistência de arquivos estáticos, mídias e gestão de sessões de usuário.
Redis Upstash: Cache de alta performance e controle de limite de taxa distribuído (rate limiting) por IP e por tenant para evitar abusos e ataques de negação de serviço.

O DevCod Agency possui inteligência para sintetizar e transcrever áudios no endpoint /api/voice/speak-stream:

Limpeza de Texto: A rotina cleanTextForTTS remove tags HTML, links, emojis e marcações markdown antes de enviar ao sintetizador, poupando tokens de API.
Cache Local SHA-256: O backend gera um hash SHA-256 do texto solicitado e busca em cache local (public/voice-cache/). Se o áudio já existir, serve o arquivo de disco instantaneamente sem nova cobrança de API.