> For the complete documentation index, see [llms.txt](https://docs.ecotone.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ecotone.tech/messaging/messaging-concepts/consumer.md).

# Consumer

When [Message Endpoints](/messaging/messaging-concepts/message-endpoint.md) are connected to channels and instantiated, they produce one of the following instances:

* `Event Driven Consumer`
* `Polling Consumer`

## Event Driven Consumer

Event Driven Consumers are automatically called when the message arrives on the channel.\
They are connected in synchronous manner, which leads to [Endpoint](/messaging/messaging-concepts/message-endpoint.md) being called just after [Message](/messaging/messaging-concepts/message.md) arrives on the [channel](/messaging/messaging-concepts/message-channel.md).

{% hint style="info" %}
Do not be confused by Event-Driven name. This does not means it handles only Events. The name comes Messaging Patterns and means that Consumer will be triggered by a any type of Message instead of trying to poll it by it's own.\
Synchronous Command, Event or even a Query Handlers are actually Event Driven Consumers.
{% endhint %}

## Polling Consumer

Polling consumers let actively poll for [Messages](/messaging/messaging-concepts/message.md) rather than process messages in an event-driven manner.\
The Polling Consumer is created, when Endpoint is connected to `Pollable Channel.`\
Polling Consumer is running in separate process.

{% hint style="info" %}
You will see how easily they are connected in [Asynchronous section](/modelling/asynchronous-handling/scheduling.md).
{% endhint %}

## Consumer Abstraction

The `consumer abstraction` (Polling/Event Driven), which is automatically created based on connected channel takes responsibility from the developer, to create and maintain consumers manually.\
This process becomes dynamic and automatic and with low cost create possibility to pretty easily move from asynchronous code to synchronous and vice versa.\
Testing asynchronous code can be really cumbersome, but thanks to the abstraction, we can replace asynchronous channel with synchronous in tests. Which will lead to situation where endpoint in tests will be directly called, because `Event Driven Consumer` will be created.\\

{% hint style="info" %}
The main idea behind `Ecotone` is to handle integration logic.\
Developer should not need to bother with creating consumers, testing asynchronous code.\
The best code is the code, which is not aware of being asynchronous code.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ecotone.tech/messaging/messaging-concepts/consumer.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.