IncomingMessageReceivedEventListener (ecom-api-iagent 12.4.0 API)

```
public interface IncomingMessageReceivedEventListener
```
This interface is an extension point to take any action after a message has been received but before being processed by the knowledge base to be categorized and pushed to the central backlog. The extension point is also able to cancel the message processing by throwing an exception.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`void`	`incomingMessageReceived(IncomingMessageReceivedEvent incomingMessageReceivedEvent)`	The method is called after the message has been received but before it is being processed by the knowledge base to be categorized and pushed to the central backlog.

- Method Detail
  - incomingMessageReceived
```
void incomingMessageReceived(IncomingMessageReceivedEvent incomingMessageReceivedEvent)
                      throws PermanentMessagingException,
                             TemporaryMessagingException
```
    The method is called after the message has been received but before it is being processed by the knowledge base to be categorized and pushed to the central backlog.
    
    Parameters:
    
    incomingMessageReceivedEvent - The IncomingMessageReceivedEvent provides additional information about the received incoming message.
    
    Throws:
    
    PermanentMessagingException - Throw a PermanentMessagingException to indicate a permanent error. The message will be removed from the incoming source without being processed. The message will be archived by the novomind iAGENT system.
    
    TemporaryMessagingException - Throw a TemporaryMessagingException to indicate a temporary error. The message will stay on the incoming source and retrieved again after a short period of time.