GitHubReceba novidades do Hedhog no seu e-mail
Novos lançamentos, receitas e breaking changes — sem spam.
Receitas
As Receitas são guias práticos para conectar o Hedhog a serviços externos e personalizar seu comportamento. Elas foram escritas para quem acabou de instalar o Hedhog e precisa saber exatamente onde clicar, o que colar e quais URLs cada provedor realmente pede — não apenas uma lista de nomes de configurações.
Cada receita documenta as chaves de configuração reais usadas pela base de código atual (verificadas contra o código-fonte, não a versão idealizada), cada URL/redirecionamento que o console de um provedor vai pedir e o que está de fato implementado versus o que está no seed mas ainda não foi construído.
Visão Geral das Receitas
Procurando por Provedores de Fila, Autenticação Multifator ou Temas? Esses vêm com padrões funcionais prontos para uso e não exigem conectar um serviço externo — agora eles ficam em Preferências.
Receitas Disponíveis
| Receita | O que cobre |
|---|---|
| OAuth / SSO | Login social e corporativo via Google, GitHub, Microsoft, Facebook, Entra ID — incluindo as três URLs de callback (login/register/connect) que a maioria dos provedores realmente precisa |
| E-mail transacional com SMTP, Gmail (refresh token OAuth) e Amazon SES | |
| Armazenamento de Arquivos | Armazenamento de arquivos e objetos com Local, S3, GCS, Azure Blob e serviços compatíveis com S3 (MinIO, Wasabi, DigitalOcean Spaces) |
| Provedores de IA | Integração de LLM para o assistente de chat do core — OpenAI e Google Gemini |
| CAPTCHA | Proteção contra bots com reCAPTCHA, Cloudflare Turnstile e ALTCHA — atualmente limitado aos formulários públicos de inscrição de campanha |
| Mensagens de WhatsApp via uma instância auto-hospedada da Evolution API, através de uma ação de Integração de Webhook | |
| Pagamentos | Processamento de pagamentos com Stripe e Mercado Pago, incluindo a URL de webhook auto-configurada que você realmente precisa registrar |
Provedores de Fila, Autenticação Multifator e Temas foram movidos para Preferências — eles não precisam ser configurados para funcionar, já que vêm com padrões sensatos.
Onde Cada Configuração Fica
A interface de configurações do Hedhog nem sempre agrupa as coisas da forma que você imaginaria pelo nome da receita — Email e AI ficam escondidos dentro de "General", e algumas receitas não têm nenhum grupo de configurações dedicado. Confira aqui antes de vasculhar cada aba:
| Receita | Grupo em Settings → Configurations | Observações |
|---|---|---|
| OAuth / SSO | OAuth | Uma aba por provedor |
| General → Mail Configuration | Não é um grupo "Mail" separado | |
| Provedores de IA | General → AI Configuration | Não é um grupo "AI" separado |
| Armazenamento de Arquivos | File Storage | |
| Pagamentos | (nenhum) | Configurado via Commerce → Webhooks → Webhook Settings |
| CAPTCHA | (nenhum) | Configurado por lista de destinatários de campanha, não globalmente |
| (nenhum) | Configurado diretamente em uma ação de Integração de Webhook |
Como as Receitas Funcionam
A maioria das integrações do Hedhog compartilha o mesmo ciclo de vida:
- Crie um Perfil de Integração em Settings → Integration Profiles — escolha um tipo (email, storage, ai, oauth, payment, captcha, whatsapp) e um provedor, depois preencha os campos de configuração desse provedor
- Aponte uma configuração para ele em Settings → Configurations — geralmente um slug como
mail-integration-profile-id,file-storage-profile-id, ou um toggle OAuth por provedor - O módulo relevante lê essa configuração em tempo de requisição e constrói o adaptador correto a partir do JSON
configdo perfil — nenhuma alteração de código é necessária ao trocar de provedor mais tarde
Alguns recursos não usam Perfis de Integração — são configurações simples ou tabelas nativas que já funcionam com padrões sensatos. Veja Preferências.