Workflow Troubleshooting

If you have some problems with the workflow functioning, check the following typical setup issues

Workflow Does Not Launch

  1. Check your workflow status in the workflow list (Automation → Workflows).

It should be Active (a green indicator is displayed next to the name).

Workflows list with a green status indicator for the Abandoned Cart workflow and a gray indicator for the Buyers workflow highlighted

If it’s Not active, click the Activate button.

Workflows list with the Activate button highlighted next to the Buyers workflow
  1. Check the event launching a workflow. If the workflow should be launched by the event transferred via API, make sure you transfer it and select it in the dropdown list in the Start configuration.
Start/Stop configuration dialog with the Event field highlighted, set to RfmTransition
  1. Check if the workflow launches were registered in the system.

See the workflow statistics.

Workflows list with the launch history icon highlighted, showing a dropdown of launch statistics for the Abandoned Cart workflow

If all statistics values are zero, the workflow was never run.

  1. Make sure there is an event that should launch the workflow in Automation → Event History. See whether the event is linked with the corresponding workflow.
Event history page with the Automation menu highlighted and an event row showing its Linked workflow underlined
  1. If the event is triggered by clicking on the button in the message, check whether the event and the button are linked.
Email editor with the Men's button selected and the Button block's Event type field set to Click_Men

Ensure that events in trigger configuration and in the message corresponding to each other.

Workflows list with the Automation menu highlighted and the Reminder workflow row showing Event-based FirstLessonCompleted underlined

Workflow Launch, but Works Incorrectly

  1. Check the settings of the workflow blocks.

Enter the workflow, click on each block and inspect its settings:

  • Have you selected the message in the Message field?
Email block settings panel with the Select message button highlighted and a Message is required error
  • Have you specified the correct variable in the Email field?
Email block settings panel with the Email field highlighted, set to the $emailAddress variable

It should match the variable you pass in the event (you can see your event parameters in Automation → Event history).

Event parameters dialog with the emailAddress field underlined in the JSON data
  1. Check the correctness of the workflow structure. All blocks should be connected to each other. For example, a common mistake is to connect two blocks through another one.
Workflow canvas with a Blocks must be connected with each other error shown in the Start block panel, with disconnected Start and Add to segment blocks highlighted
  1. If all settings are correct, but some users didn’t receive the messages from the workflow, inspect the contact information of these users. Maybe they are unsubscribed, blacklisted, over your sending limit, and so on. You can see this information in the Campaigns → Single reports section. Enter the contact ID in the search bar and see the details of delivery errors. Also, you can see contact information in Contacts → All contacts section.
Single reports page with the Campaigns menu highlighted, listing undelivered messages with error reasons underlined such as blacklisted and unverified domain

Delay Before a Triggered Email Arrives

A noticeable delay between the trigger event and the email arriving doesn’t always come from the recipient’s mail server. It can also originate inside the platform, while the message is queued for sending.

šŸ“˜

Note

This is the explanation of a single incident, not a service level guarantee. Reteno doesn’t publish p50/p95 figures for event ingestion, internal queueing or acceptance by the recipient’s mail server.

To have a specific delay investigated, send our support team the delivered .eml file with its full Received headers. You can also check the status of an instant message through the API.


These are the basic settings that you should check if you encounter problems. If, after review, you still have troubles, please contact our support team.


Did this page help you?