Difference between revisions of "Editing SystemEvents/Troubleshooting"

Revision as of 16:17, 10 September 2014

If a customer reports an issue or a problem with an event, there are a few ways you can assist the customer troubleshoot the issue.

Processed vs Unprocessed events

It is first important to understand the difference between an event that has been processed and one that has been created but not yet processed. There are a few reasons Emersion queue events and delay processing them. Examples include:

• SMSs to be sent only during 'safe' times. For example, not during the middle of the night.
• When an event sends a message to a service number it may also be configured to send a message to the primary contact of the account. If these are the same, Emersion's events system will create two events, but only send one. In this instance, two events are noted, only one is processed.

Where Events can be seen in Cumulus

There are three areas in Cumulus you may want to check in relation to troubleshooting events.

Customer Notes

In the Customer > Notes tab you can see a list of all Events that have been performed against the customer. You will also see events that were created but were failed to be sent for that customer along with any associated error messages.

Click View to see further details. Click Edit to edit or add further details to the Event note.

This requires the event to have Extended Logging enabled. See below how to enable Extended Logging for an event.

Events Message Queues

Navigate: Events > Message Queue

There are two message queues in Cumulus, one each for email and SMS events respectively. The queues show both Events that have processed and unprocessed. Processed events have been sent by the system. Unprocessed events have been created by the system but have not yet been sent.

The Message Queues show you all events across your entire customer base. Use the filters at the top of the screen to refine your list and find the events you are looking for.

Message Queue filters

On the Message queue, filter the results by:

• Account ID - Returns events for an account
• Account name - Returns events for an account
• Event type - Returns events for a given type of event
• Creation date - Returns events from the Creation date to the last date an event was processed
• Account profile name - Returns events for accounts attached to a given account profile
• Processed flag - Returns messages created by the system and are waiting to be sent (Processed = No) or created and have been sent by the system (Unprocessed = Yes).

Note: You must have SMS Events enabled by Emersion in order to use the SMS event functionality. This is not enabled by default since access fees and a charge per SMS applies. If you wish to enquire about the SMS events functionality, please contact Emersion Sales at sales@emersion.com.au

Event Reports

Navigate: Reports > Finance

There are two reports that can assist you regarding Events. These contain similar, but slightly different information on the event.

• Events email sending log
• Events SMS sending log

Message Queue filters

On the Message queue, filter the results by:

• Account name/ID - Returns events for an account
• Message phrase - Returns events with a specific word or word(s) in the subject, the sender or in the message content. This filter functions as a keyword search
• From and To dates - Returns events processed between a given date range
• Message sent flag - Returns messages created by the system and is waiting to be sent (Sent = No) or created and have been sent by the system (Sent = Yes)

Why do I need these?

We provide numerous ways for you to assist troubleshoot with your client the following types of issues:

Ascertain whether an Emails and SMSs was sent by Emersion - can be sent (processed), not yet sent (scheduled), was not sent (no record).

Emails and SMSs received from clients containing information that is inaccurate or incorrect - Verify what the message contained for an event that was sent on a given date.

Why an SMS or email wasn't received - Emersion has no control over messages once they leave Emersion's system. Emersion cannot guarantee delivery of an email or SMS.

Other Things to Check

Here are some basic checking that should always occur when a customer reports problems with an event.

1. Are the customer's details still correct?

Check the email address or phone number you have recorded against the customer.

2. Is the event sending the SMS or email to a different delivery address or number than the customer was expecting it to go to?

Some events can send SMSs to the email address or a number associated with the service while other events can only send messages to the primary contact of the Account. In most cases, Emersion allows you to choose from a list of options. Check the Event configuration to see how the event was set up by your Administrators.

3. Is the event Enabled?

Check the Event configuration.

Enabling Extended Logging

To enable the Extended Logging function for events, you will need to alter the Event configuration. You will need to do this for each event where Extended Logging is required. Please note that not all events use Extended Logging.

Navigate: Events > Template > Mappings - This will open the Event Action Mapping List.

Find the event you wish to enable Extended Event logging for

Under the Actions column, click Edit

On the Edit Event Action Mapping screen, change the Extended Event Logging setting to Enabled.

Save your changes.

Seeking Further Help

If after using the above resources, you are unable to resolve the problem, you can log a support ticket with Emersion. Include the customer ID, Event type, relevant dates & times, and all investigations you have undertaken to try to resolve the issue with the customer yourself. Please be aware that if you have not taken any steps at all to troubleshoot the issues with the events, we will simply return the ticket to you as Insufficient Info with direction to this article.