Plug router for incoming Pipedrive webhook POSTs.

Normalizes Pipedrive payloads into ExPipedrive.Webhook.Event structs and delivers them to an optional ExPipedrive.Webhook.Handler module. The host application owns fan-out (Registry, PubSub, etc.) — core does not start any OTP processes for webhooks.

Requires the optional plug dependency. Add to your app:

{:plug, ">= 1.16.0"}

Without plug, this module is not compiled. Payload transformers (ExPipedrive.Webhook.Event and ExPipedrive.Webhook.Handler) remain available without Plug. This is the in-repository ex_pipedrive_web surface, reserved for extraction as an optional package.

Example

forward "/webhooks", to: ExPipedrive.Incoming.Handler,
  init_opts: [handler: MyApp.PipedriveWebhookHandler,
              auth_fn: fn -> [username: "pipedrive", password: secret] end]

See https://pipedrive.readme.io/docs/guide-for-webhooks for event types and payload shapes. :auth_fn is optional; when present it can be a zero-arity function returning Plug.BasicAuth options or those options directly.

Compatibility

on_event: fn {:updated_deal, payload} -> ... end remains supported for deal and person update events. New integrations should configure :handler and implement ExPipedrive.Webhook.Handler.