Skip to main content

Delivery configuration

The Deliver tab configures where and how reports are sent. Anaphora can deliver to multiple channels: email, webhooks, and S3 archiving.

Overview​

After composition, Anaphora delivers the report through the interfaces you configure:

Delivery interfaces​

Delivery interfaces are reusable destination configurations. Configure them once under Delivery Interfaces in the sidebar, then select them in any job. You can also select Create new in the job's Delivery Interface menu.

Available types​

InterfaceBest forFeatures
SMTPCorporate emailSSL/TLS, attachments
MailgunTransactional emailHigh volume, tracking
WebhookIntegrationsCustom payloads, any endpoint
S3 Object StorageArchival, complianceHistorical records, versioning

Reusability​

You can configure multiple interfaces of each type:

  • Different SMTP servers for different teams
  • Separate S3 buckets for different retention periods
  • Several webhooks for different integrations

S3 archiving​

S3 is useful for historical archives and compliance workflows.

In the job, set File type to PDF Report, HTML Report, or PDF & HTML Report.

Use cases​

ScenarioBenefit
Historical reference"What did this dashboard look like on date X?"
Compliance evidenceImmutable records for audit requirements
Long-term retentionStore reports beyond housekeeping limits
Cross-system integrationOther tools can access archived reports

Email delivery​

Anaphora sends reports by email through SMTP or Mailgun.

Email options​

FieldDescription
AttachmentsSelect Report as PDF to attach the PDF report to the email.
Message templateCustomizable email body with variables.
RecipientsList of email addresses to send the report to.
Recipients

Mark each recipient address as an Individual mailbox or a Group address. Click a recipient to change its type. Emails sent to individual mailboxes include a snooze and unsubscribe link in the footer. Group addresses do not include these links.

A snooze pauses the job's emails to that recipient for 5 minutes to 8 days. The recipient must pick a duration. The unsubscribe link stops the emails.

Webhook delivery​

Webhooks connect Anaphora to any HTTP endpoint for custom integrations.

Webhook configuration​

FieldDescription
Message templateCustomizable message body with variables.
JSON body templateDefine the JSON payload with variables. Shown instead of Message template when Define body in job instead is selected in the Webhook interface.

Webhook use cases​

IntegrationDescription
Ticketing systemsCreate tickets for alerts
Chat platformsCreate messages in collaboration tools
Data pipelinesFeed report data to analytics
Custom dashboardsUpdate external status pages

Multi-channel delivery​

Send the same report to multiple destinations:

Configuration​

  1. Click Delivery Interface
  2. Select an existing interface, or Create new
  3. Configure the destination
  4. Repeat for additional channels

Example: alert with archive​

Delivery 1: Webhook e.g. Slack (immediate notification)
Delivery 2: Email (stakeholder distribution)
Delivery 3: S3 (permanent archive)

Partial success​

With multi-channel delivery:

  • Anaphora tries each channel independently
  • Partial success (some channels succeed, others fail) is logged
  • The run and the Jobs list show Delivery issue. Job health counts a report that reached nobody as failed, and a report that reached some destinations as partly delivered.

The links in a delivered email, Slack message or webhook are private. Each run has a secret token, and the links carry it. The report files (PDF, HTML, images) open for a link with that token, or for a signed-in member of the run's space. Anyone else gets "not found".

Withheld reports​

When a text block of the report fails, or the report cannot be built, Anaphora does not deliver it. No recipient, bucket or webhook gets it. The Jobs list shows the job as Not delivered, and job health counts the run as failed. The run does not count as sent, so a throttled job sends the next run. See Composer.

With the S3 file type PDF & HTML Report, nothing is uploaded when the HTML copy cannot be built.

Testing delivery​

Every delivery config includes a test button: Run with test email for SMTP and Mailgun, Test run for Webhook and S3 Object Storage. Use it to verify the configuration before you save the job. Test run without delivery runs the job and shows the output without notifying any recipients. A test withholds a report with a broken text block in the same way, and says so. Anaphora logs all steps of the capture and delivery process for troubleshooting. Select Debug test run in the button menu to also receive a video of the capture process.

Next steps​