Webhook sending and template rendering for Framework effects.

Provides webhook sending capabilities with URL templating, payload templating, and custom header support. Maintains backward compatibility with simple URL configuration.

Configuration

Simple Configuration (Backward Compatible)

config :framework, :webhook_endpoints, %{
  "user.created" => "https://api.example.com/webhooks/user_created"
}

Enhanced Configuration (with Templating)

config :framework, :webhook_config, %{
  # Template directory for webhook payloads
  templates_dir: "priv/webhook_templates",

  # Enhanced endpoint configuration
  endpoints: %{
    "user.created" => %{
      url: "https://api.example.com/tenants/{{tenant_id}}/webhooks/user_created",
      headers: %{
        "X-Tenant-ID" => "{{tenant_id}}",
        "Authorization" => "Bearer {{api_token}}"
      },
      template: "user_created"  # Optional: use JSON template file
    },
    "billing.charge" => %{
      url: "https://{{tenant_slug}}.billing.com/webhooks/charge",
      headers: %{"X-API-Key" => "{{billing_api_key}}"},
      template: "billing_charge"
    }
  }
}

Template System

Webhook payload templates are JSON files with variable interpolation:

• Template files: templates_dir/<template_name>.json
• Variables in templates use {{variable_name}} syntax
• All JSON values can be templated (strings, nested objects, arrays)

URL and Header Templating

Both URLs and custom headers support {{variable_name}} substitution:

• URL: "https://api.{{environment}}.com/webhooks/{{event_type}}"
• Headers: "X-Tenant-ID": "{{tenant_id}}"