naftiko: 1.0.0-alpha2
info:
  label: Regal Reporting Webhooks
  description: >-
    Subscribe to Regal Reporting Webhooks. Regal POSTs 40+ event types
    (call/SMS/MMS/email/voicemail lifecycle, agent activity, task and
    contact lifecycle, scheduled callbacks, custom objects) to a
    customer-hosted HTTPS endpoint. Endpoints must respond within 5
    seconds or the event is dropped — there are no retries.
  tags:
    - Regal
    - Webhooks
    - Reporting
    - Events
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
  - namespace: env
    keys:
      REGAL_WEBHOOK_URL: REGAL_WEBHOOK_URL
      REGAL_WEBHOOK_TOKEN: REGAL_WEBHOOK_TOKEN
capability:
  exposes:
    - type: webhook
      namespace: reporting-webhooks-receiver
      port: 8081
      description: >-
        HTTPS receiver for Regal Reporting Webhook deliveries. Configure the
        public URL of this receiver in the Regal app under Settings >
        Integrations.
      resources:
        - path: /webhooks/regal
          name: regalWebhookReceiver
          description: Accepts all Regal reporting webhook events on a single endpoint.
          operations:
            - method: POST
              name: receiveevent
              description: Accept a Regal reporting webhook event and dispatch by name.
              outputParameters:
                - type: object
                  mapping: $.
              authentication:
                type: apikey
                key: Authorization
                value: '{{env.REGAL_WEBHOOK_TOKEN}}'
                placement: header