For the complete documentation index, see llms.txt. This page is also available as Markdown.

Send

Task for sending Advanced Message Queuing Protocol = AMQP messages.

Task version: 3.0.0

Required Frends version: 5.7+

Required .NET version: 8.0

Compatible Agents: Crossplatform

Task Parameters

Name
Description

Message : AmqpMessage

AMQP message string.

Default: - Example: Example message.

Message.BodyAsString : String

The message body.

Default: - Example: foobar!

QueueOrTopicName : String

Name of target queue or topic.

Default: - Example: Queue

MessageProperties : AmqpProperties

The Immutable properties of the Message.

Default: - Example: AbsoluteExpiryTime, ContentEncoding, ContentType, CorrelationId, CreationTime, GroupId, GroupSequence, ReplyToGroupId, ReplyTo, Subject, UserId, To

MessageProperties.MessageId : String

Message's id.

Default: Guid.NewGuid().ToString() Example: 43c8c21c-f1db-41d6-be68-5b476b24e46d

MessageProperties.AbsoluteExpiryTime : Nullable<DateTime>

Message's AbsoluteExpiryTime.

Default: - Example: 1.1.0001 0.00.00

MessageProperties.ContentEncoding : String

Message's ContentEncoding.

Default: - Example: UTF8

MessageProperties.ContentType : String

Message's ContentType.

Default: - Example: text/plain

MessageProperties.CorrelationId : String

Message's CorrelationId.

Default: - Example: 43c8c21c-f1db-41d6-be68-5b476b24e46d

MessageProperties.CreationTime : Nullable<DateTime>

Message's CreationTime.

Default: - Example: 24.8.2022 12.00.00

MessageProperties.GroupId : String

Message's GroupId.

Default: - Example: 0

MessageProperties.GroupSequence : UInt32

Message's GroupSequence.

Default: 0 Example: 0

MessageProperties.ReplyToGroupId : String

Message's ReplyToGroupId.

Default: - Example: 0

MessageProperties.ReplyTo : String

Message's ReplyToGroupId.

Default: - Example: 0

MessageProperties.Subject : String

Message's Subject.

Default: - Example: foo bar

MessageProperties.UserId : Byte[]

Message's UserId.

Default: - Example: 0

MessageProperties.To : String

Message's To.

Default: - Example: foo

ApplicationProperties : ApplicationProperty[]

Application properties section of an AMQP messages.

Default: - Example: foo, bar

Name
Description

BusUri : String

The URI for the AMQP Message bus, username and key must be url encoded.

Default: "amqps://:@:" Example: amqps://:@:

ClientCertificate : SearchCertificateBy

Select whether certificate is used and where it can be found.

Possible values:

  • None: Select whether certificate is used and where it can be found.

  • Issuer: Select whether certificate is used and where it can be found.

  • File: Select whether certificate is used and where it can be found.

Default: None Example: None

CertificateIssuer : String

Issuer of certificate.

Default: - Example: Issuer

CertificateFilePath : String

Path where .pfx (certificate) file can be found.

Default: - Example: c:\Windows\foo.pfx

🗝CertificatePassword : String

Password for the certificate.

Default: - Example: 123

DisableServerCertificateValidation : Boolean

Disable server certificate validation when TLS is used. False means certificate is validated. If connection is not secured with tls this option does not do anything.

Default: False Example: false

Name
Description

Timeout : Int32

Timeout in seconds for receiving or sending Message to the queue.

Default: 30 Example: 30

LinkName : String

Link name.

Default: {{Guid.NewGuid().ToString()}} Example: 9e2646fe-bbc7-482d-a5dc-679dc5caf951

ThrowErrorOnFailure : Boolean

Determines error handling behavior. If true, throws an exception when task fails.

If false, returns error information in the Result object instead of throwing.

Default: True Example: true

ErrorMessageOnFailure : String

Custom error message to use when ThrowErrorOnFailure is false and an error occurs.

If null or empty, the original exception message will be used.

This allows for user-friendly error messages in automated workflows.

Default: - Example: Failed to send message

Task Result

Name
Description

Success : Boolean

True if Message was sent successfully. Example: true

Error : Error

Error information when the sending message fails and ThrowErrorOnFailure option is set to false. Contains detailed error message and additional debugging information. Example: { "Message": "Sending failed", "AdditionalInfo": { "ExceptionType": "ArgumentException" } }

Error.Message : String

Primary error message describing what went wrong during sending message. Can be either the original exception message or a custom message if specified in options. Example: Error in message properties

Error.AdditionalInfo : Exception

Additional contextual information about the error such as exception type and stack trace. Contains structured data that can be useful for automated error handling and logging. Example: { "ExceptionType": "ArgumentException", "StackTrace": "..." }

Task Changelog

Changelog for Task Frends.AMQP.Send.

[3.0.0] - 2026-07-20

Changed

  • [Breaking] The Connection tab is now the second parameter (after Input), and Options is the third. This matches the standard Frends task parameter order.

  • Added support for cancellation: the task now respects cancellation tokens passed by the Frends platform.

[2.0.0] - 2025-09-24

Added

  • New Connection tab with AMQP connection parameters.

  • ThrowErrorOnFailure option in Options tab with default value false

  • ErrorMessageOnFailure option in Options tab for custom error messages

  • Error object in Result with Message and AdditionalInfo properties for detailed error reporting

Changed

  • [Breaking] Moved Properties from AmqpMessageProperties tab to Input tab, renamed to MessageProperties

  • [Breaking] Moved ApplicationProperties from AmqpMessageProperties tab to Input tab

  • [Breaking] Moved BusUri from Input tab to Connection tab

  • [Breaking] Moved SearchClientCertificateBy from Options tab to Connection tab, renamed to ClientCertificate

    • Enum value DontUseCertificate renamed to None

  • [Breaking] Moved Issuer from Options tab to Connection tab, renamed to CertificateIssuer

  • [Breaking] Moved PfxFilePath from Options tab to Connection tab, renamed to CertificateFilePath

  • [Breaking] Moved PfxPassword from Options tab to Connection tab, renamed to CertificatePassword

  • [Breaking] Moved DisableServerCertValidation from Options tab to Connection tab, renamed to DisableServerCertificateValidation

  • Improved error handling with structured Error object in Result

[1.0.1] - 2022-08-26

Changed

  • Dependencies update AMQPNetLite Version=2.2.0 to 2.4.4 Newtonsoft.Json Version=12.0.3 to 13.0.1 System.ComponentModel.Annotations 4.6.0 to 5.0.0

[1.0.0] - 2022-02-17

Added

  • Initial implementation

Last updated

Was this helpful?