Skip to main content

Automations

Automations are a powerful way to automate your business processes. They can be used to send messages, update patient records, and more. You can create automations that are triggered by events in your system, such as a new patient record being created or a message being sent. You can also create automations that are triggered by external events, such as a timer.


Triggers

The trigger determines what causes the automation to run.

FHIR Resource Events

FHIR resource events allow the automation to be triggered by a change in a FHIR resource. The resource type and event type are selected from dropdowns. The resource type is the type of FHIR resource that will trigger the automation. The event type is the type of change to the resource that will trigger the automation. The event type can be Created, Updated, or Deleted. The automation will run when the specified resource type is created, updated, or deleted.

Timers

Timers allow the automation to be triggered on a schedule. The timer can be configured to run on a recurring basis against a selected report. When selected each resource in the report will fire the automation. It is important to carefully select the report to ensure accuracy.

Filters

Filters allow the automation to be run only when certain conditions are met. The filters are based on the FHIR resource that triggered the automation. The resource type, field, and operator are selected from dropdowns. The operator is the type of comparison that will be performed. The value is the value that will be compared to the resource field. The automation will only run if the value in the resource field passes the comparison.

Multiple filters can be added to an automation. If multiple filters are added, the automation will only run if all of the filters pass.

Actions

An "action" refers to a specific task that the system performs automatically when certain conditions are met. Actions can be things like sending messages, creating tasks, adding patients to campaigns, or updating information. These actions can be customized to fit your specific needs and can also involve connecting with other systems or services. Overall, actions are like the "what happens next" part of your automation, ensuring things get done in context to your triggers and filters.

Logs

The automation logs provide a detailed history of every execution, giving you visibility into what triggered the automation, whether it executed successfully, and what actions were performed.

Accessing Logs

When you navigate to an automation, you'll find a set of options in the top right corner next to the "save" button, represented by three dots. Within this dropdown menu, you'll discover various choices, including the option to access logs specific to that automation.

Log Information

Each log entry contains:

  • Timestamp: When the automation was triggered
  • Trigger Source: What resource or event triggered the automation
  • Execution Status: Whether the automation completed successfully
  • Action Results: Details of each action performed
  • Error Messages: Any issues encountered during execution
  • Execution Time: How long the automation took to complete

Using Logs for Troubleshooting

Logs are invaluable for:

  • Verifying if automations are firing as expected
  • Identifying why an automation might have failed
  • Understanding which conditions or filters prevented execution
  • Monitoring the frequency and patterns of automation triggers
  • Auditing automated actions for compliance and quality assurance

Log Retention

  • Standard logs are retained for 30 days
  • Extended retention is available for enterprise customers
  • Logs can be exported for permanent storage or analysis

Best Practices

  • Check logs after creating or modifying an automation
  • Set up regular log reviews for critical automations
  • Use log data to optimize automation performance and reliability
  • Investigate any patterns of failures or unexpected behaviors