AI agents: use the documentation index at llms.txt to locate machine-readable pages. This section is indexed by https://docs.particular.net/nservicebus/llms.txt. The markdown version of this page is served as plain text. An MCP server at /mcp serves the same content via the search_docs and read_doc tools; it is read-only and needs no credentials. Markdown versions of documentation pages are available by appending .md to the page URL. Directory URLs use index.md. They are served as text/plain because some retrieval backends reject text/markdown.

Third-Party Integration

Component:
NServiceBus

Endpoints can receive messages from external systems (such as BizTalk, TIBCO, etc). To ensure those messages can be handled correctly by NServiceBus, additional information might be required which is otherwise provided by NServiceBus automatically.

Deserialization

To deserialize a message coming from a third-party system, NServiceBus needs to know the .NET type to use.

See Message type detection for details.

The RabbitMQ, SQL, and Azure Service Bus native integration samples demonstrate inferring message type from the message body.

Visualization

To visualize messages from third-party systems correctly within ServicePulse, additional headers are necessary.

  • NServiceBus.ConversationId - used to show related messages in the Flow Diagram and Sequence Diagram. If this header is not provided, the message won't be included in the conversation it started, but a ConversationId will be generated for subsequent messages sent using NServiceBus.
  • NServiceBus.OriginatingEndpoint - used in all views, to show the logical endpoint that sent the message. This should be the name of the third-party endpoint sending the message. For example, BizTalk.ProcessOrder.

Related Articles

In this article