.. _TransitionAction ArticleSend:

Send an Article
###############

Summary
*******

This action allows you to send an article via email.

The name of the transition action is :ref:`ArticleSend <TransitionAction ArticleSend>`

Transition Action Module Configuration
**************************************

The following list shows the mandatory items.

+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Key                  | Example value                              | Description                                                                             | Mandatory                                                                                                                      |
+======================+============================================+=========================================================================================+================================================================================================================================+
| Attachments          | 'Attachment 1, Attachment 2, Attachment 3' | Comma separated names from attachments found in the system under Admin -> Attachments   | no                                                                                                                             |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| AttachmentIDs        | 15,42,34                                   | Comma separated ID list from attachments found in the system under Admin -> Attachments | no                                                                                                                             |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| AttachmentsReuse     | 1                                          | default: 0                                                                              | optional, 1 - Reuse of attachments stored in the dynamic field configured in Process::DynamicFieldProcessManagementAttachment. |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Bcc                  | Some Customer C <customer-c@example.com>   | must be an email                                                                        | required if both To and Cc are not present                                                                                     |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Body                 | 'the message text'                         | text                                                                                    | required                                                                                                                       |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Cc                   | Some Customer B <customer-b@example.com>   | must be an email                                                                        | required if both Bcc and To are not present                                                                                    |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Charset              | utf-8                                      | only utf-8                                                                              | yes, or ContentType                                                                                                            |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| ContentType          | text/plain; charset=utf-8                  |                                                                                         | yes, or MimeType and Charset                                                                                                   |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
|| From                || Some Agent <email@example.com>            || must be an email                                                                       || required if both Cc and Bcc are not present                                                                                   |
||                     ||                                           ||                                                                                        || Optionally, left blank the current queue sender                                                                               |
||                     ||                                           ||                                                                                        || is used, and can be overwritten by the Queue field.                                                                           |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| HistoryComment       | Some HistoryComment                        | text HistoryComment                                                                     | yes                                                                                                                            |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| HistoryType          | EmailAgent                                 | Valid ticket history type                                                               | yes                                                                                                                            |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| InReplyTo            | Some Customer B <customer-b@example.com>   | text                                                                                    | no                                                                                                                             |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| IsVisibleForCustomer | 1                                          | Is article visible for customer?                                                        | yes                                                                                                                            |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| MimeType             | text/plain                                 | text/plain or text/html                                                                 | yes, or ContentType                                                                                                            |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| NoAgentNotify        | 0                                          | 0 = send 1 = not send                                                                   | no, default: 1                                                                                                                 |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
|| Queue               || Misc                                      || Use sender address from Misc queue.                                                    || no.                                                                                                                           |
||                     ||                                           ||                                                                                        || Optional to To: field.                                                                                                        |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| QueueID              | 1                                          | Use sender address from the queue with ID 1                                             | no                                                                                                                             |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| References           | Some Customer B <customer-b@example.com>   | text                                                                                    | no                                                                                                                             |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| ReplyTo              | Some Customer B <customer-b@example.com>   | must be an emails                                                                       | no, if 'Reply-To' is used instead                                                                                              |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Salutation           | 'Salutation 1'                             | Use salutation to replace in Body by Tag <OTRS_TA_SALUTATION>                           | no                                                                                                                             |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| SalutationID         | 1                                          | Use salutation id to replace in Body by Tag <OTRS_TA_SALUTATION>                        | no                                                                                                                             |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| SenderType           | 'agent'                                    | agent,system,customer                                                                   | yes                                                                                                                            |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| SenderTypeID         | 1                                          | numerical id of sender type                                                             | or SenderType                                                                                                                  |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Signature            | 'Signature 1'                              | Use signature id to replace in Body by Tag <OTRS_TA_SIGNATURE>                          | no                                                                                                                             |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| SignatureID          | 1                                          | Use signature id to replace in Body by Tag <OTRS_TA_SIGNATURE>                          | no                                                                                                                             |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Subject              | an email subject                           | text                                                                                    | yes                                                                                                                            |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| To                   | Some Customer A <customer-a@example.com>   | must be an email                                                                        | required if both Cc and Bcc are not present                                                                                    |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Template             | 'Template 1'                               | Use template to replace in Body by Tag <OTRS_TA_TEMPLATE>                               | no                                                                                                                             |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| TemplateID           | 1                                          | Use template id to replace in Body by Tag <OTRS_TA_TEMPLATE>                            | no                                                                                                                             |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| UseTicketHook        | 0                                          | 0 = no ticket hook 1 = with ticket hook                                                 | optional, default: 1                                                                                                           |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+
| UserID               | 123                                        | no, will override the logged in user id                                                 | no                                                                                                                             |
+----------------------+--------------------------------------------+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+