--- url: https://next.zammad.org/sr/reference/rest-api/articles.md --- # Чланак ## Уопштено Нека својства чланака можда нису једноставна и могу имати доста опција - испод наведени списак би требало да вам помогне у томе. ### `content_type` Zammad подржава `text/html` за HTML форматирани текст или `text/plain` за обичан текст. Ово вам омогућава боље опције форматирања ако су вам потребне. Zammad web интерфејс обично користи `text/html`. ### `type` Zammad подржава велики број типова чланака. Испод наведени списак може бити непотпун у зависности од ваше инсталације и евентуално инсталираних додатака / прилагођених измена. Ако није другачије наведено, сви типови чланака испод су **комуникациони чланци** и тиме утичу на израчунавање SLA у подразумеваним поставкама Zammad-а. Разлика је у томе што комуникациони чланци омогућавају аутоматско одговарање. Које тачно акције су доступне зависи од типа чланка и нпр. листа примилаца. `email` : Ово вам омогућава креирање долазних или одлазних имејл чланака. Међутим, ово у великој мери зависи од изабраног `sender`. `phone` : Означава напомене позива. `web` : Обично га користе само клијенти. Овај тип се користи када ваш клијент користи web интерфејс за креирање чланака. `note` : Када комуникација не одговара (нпр: интерне белешке) изаберите белешку. Zammad такође користи овај тип чланка као подразумевани резервни. Ово није **комуникациони чланак**. `sms` : Ова врста се користи у Zammad SMS интеграцији. `chat` : Технички, овај тип чланка је плацехолдер и доступан је искључиво путем API-ја. `fax` : Технички, овај тип чланка је плацехолдер и доступан је искључиво путем API-ја. `twitter status` и `twitter direct-message` : Ови типови чланака користи их Twitter канал Zammad-а. Технички, можете их користити за аутоматско одговарање на постојеће захтеве путем Twitter-a. `facebook feed post` и `facebook feed comment` : Ови типови чланака користи Facebook канал Zammad-а. Технички, можете их користити за аутоматско одговарање на постојеће захтеве путем Facebook-а. `telegram personal-message` : Користи га Telegram канал Zammad-а. Технички, можете их користити за аутоматско одговарање на постојеће захтеве путем Telegram-а. ### `internal` Овај атрибут вам омогућава да подесите видљивост чланака. За видљивост само интерно користите `true`, а за видљивост и клијентима користите `false`. ::: warning **Видљивост: интерно не значи да је тихо** Ако поставите чланак на `internal: true`, али изаберете да пошаљете имејл, имајте у виду да ће тај имејл и даље бити послат! ::: ### `sender` Означава који је корисник креирао чланак. Можете изабрати: * `Agent` * `Customer` * `System` ::: warning У зависности од горе наведеног избора, неки типови чланака можда неће бити доступни или ће се понашати другачије. Имајте у виду да `System` онемогућава корисницима да читају садржај (ово функционише слично Zammad-овим окидачима који се приказују у тикетима). ::: ## Приказ чланака по тикету Потребна дозвола: `ticket.agent` **или** `ticket.customer` `GET`-захтев послат: `/api/v1/ticket_articles/by_ticket/{ticket id}` ::: details ```json // HTTP-Code 200 OK [ { "id": 9, "ticket_id": 5, "type_id": 1, "sender_id": 2, "from": "David Bell ", "to": "support@fastlane.inc", "cc": null, "subject": null, "reply_to": null, "message_id": null, "message_id_md5": null, "in_reply_to": null, "content_type": "text/html", "references": null, "body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magnam aliquam quaerat voluptatem.
\nDavid Bell
\n\n
\nDavid Bell", "internal": false, "preferences": {}, "updated_by_id": 10, "created_by_id": 10, "origin_by_id": null, "created_at": "2021-08-02T11:57:18.068Z", "updated_at": "2021-08-02T11:57:18.068Z", "attachments": [], "inline_attachments": [], "type": "email", "sender": "Customer", "created_by": "david@example.com", "updated_by": "david@example.com", "time_unit": null }, { "id": 10, "ticket_id": 5, "type_id": 1, "sender_id": 1, "from": "Emily Wilson via ", "to": "David Bell ", "cc": null, "subject": null, "reply_to": null, "message_id": null, "message_id_md5": null, "in_reply_to": null, "content_type": "text/html", "references": null, "body": "Hi David,
\n
\nUt enim aeque doleamus animo, cum corpore dolemus, fieri tamen permagna accessio potest, si aliquod aeternum et infinitum impendere malum nobis opinemur.
\n\n
\n--
\nGreetings,
\n
\nEmily Wilson
", "internal": false, "preferences": {}, "updated_by_id": 5, "created_by_id": 5, "origin_by_id": null, "created_at": "2021-08-03T09:57:18.121Z", "updated_at": "2021-08-03T09:57:18.121Z", "attachments": [], "inline_attachments": [], "type": "email", "sender": "Agent", "created_by": "emily@fastlane.inc", "updated_by": "emily@fastlane.inc" } ] ``` ::: ## Приказ специфичног чланка Потребна дозвола: `ticket.agent` **или** `ticket.customer` `GET`-захтев послат: `/api/v1/ticket_articles/{article id}` ::: details ```json // HTTP-Code 200 OK { "id": 9, "ticket_id": 5, "type_id": 1, "sender_id": 2, "from": "David Bell ", "to": "support@fastlane.inc", "cc": null, "subject": null, "reply_to": null, "message_id": null, "message_id_md5": null, "in_reply_to": null, "content_type": "text/html", "references": null, "body": "Hi,
\n
\nQui liber cum et mortem contemnit, qua qui est imbutus quietus esse numquam potest. Praeterea bona praeterita grata recordatione renovata delectant.
\n\n
\nDavid Bell", "internal": false, "preferences": {}, "updated_by_id": 10, "created_by_id": 10, "origin_by_id": null, "created_at": "2021-08-02T11:57:18.068Z", "updated_at": "2021-08-02T11:57:18.068Z", "attachments": [], "inline_attachments": [], "type": "email", "sender": "Customer", "created_by": "david@example.com", "updated_by": "david@example.com", "time_unit": null } ``` ::: ## Креирај Потребна дозвола: `ticket.agent` **или** `ticket.customer` `POST`-захтев послат: `/api/v1/ticket_articles` ::: tip Ако желите да креирате чланке у име других корисника (нпр. за белешку телевфонског позива), користите атрибут `origin_by_id`. За ово је обавезна дозвола `ticket.agent`. ::: ### Чланак :::: details ::: tabs key:reqres \=== Захтев ```json { "ticket_id": 5, "subject": "Call note", "body": "Called the customer and discussed their issues.
Turns out these were caused by invalid configurations - solved.", "content_type": "text/html", "type": "phone", "internal": false, "sender": "Agent", "time_unit": "15" } ``` \=== Одговор ```json // HTTP-Code 201 Created { "id": 33, "ticket_id": 5, "type_id": 5, "sender_id": 1, "from": "Lauren Brooks", "to": null, "cc": null, "subject": "Call note", "reply_to": null, "message_id": null, "message_id_md5": null, "in_reply_to": null, "content_type": "text/html", "references": null, "body": "Called the customer and discussed their issues.
Turns out these were caused by invalid configurations - solved.", "internal": false, "preferences": {}, "updated_by_id": 3, "created_by_id": 3, "origin_by_id": null, "created_at": "2021-11-08T16:13:35.962Z", "updated_at": "2021-11-08T16:13:35.962Z", "attachments": [], "inline_attachments": [], "type": "phone", "sender": "Agent", "created_by": "lauren@fastlane.inc", "updated_by": "lauren@fastlane.inc" } ``` ::: :::: ### Чланак са приложеним фајловима :::: details ::: tabs key:reqres \=== Захтев ```json { "ticket_id": 5, "to": "", "cc": "", "subject": "some subject", "body": "Please see attached file...", "content_type": "text/plain", "type": "note", "internal": true, "time_unit": "25", "attachments": [ { "filename": "portal.txt", "data": "VGhlIGNha2UgaXMgYSBsaWUhCg==", "mime-type": "text/plain" }, { "filename": "{filename}", "data": "{file content base64 encoded}", "mime-type": "{attachments mime-type}" } ] } ``` \=== Одговор ```json // HTTP-Code 201 Created { "id": 35, "ticket_id": 5, "type_id": 10, "sender_id": 1, "from": "Lauren Brooks", "to": "", "cc": "", "subject": "some subject", "reply_to": null, "message_id": null, "message_id_md5": null, "in_reply_to": null, "content_type": "text/plain", "references": null, "body": "Please see attached file...", "internal": true, "preferences": {}, "updated_by_id": 3, "created_by_id": 3, "origin_by_id": null, "created_at": "2021-11-09T12:02:55.434Z", "updated_at": "2021-11-09T12:02:55.434Z", "attachments": [ { "id": 17, "filename": "portal.txt", "size": "19", "preferences": { "Mime-Type": "text/plain" } } ], "inline_attachments": [], "type": "note", "sender": "Agent", "created_by": "lauren@fastlane.inc", "updated_by": "lauren@fastlane.inc" } ``` ::: :::: ### Чланак са уграђеним сликама Уметнуте слике можете користити тако што ћете навести data URI-је у свом HTML коду. У одговору су наведене под `inline_attachments`, док `attachments` садржи само обичне прилоге. :::: details ::: tabs key:reqres \=== Захтев ```json { "ticket_id": 5, "to": "", "cc": "", "subject": "some subject", "body": "Let's see the phoenix ", "content_type": "text/html", "type": "note", "internal": false, "time_unit": "12" } ``` \=== Одговор ```json // HTTP Code 201 Created { "id": 37, "ticket_id": 5, "type_id": 10, "sender_id": 1, "from": "Lauren Brooks", "to": "", "cc": "", "subject": "some subject", "reply_to": null, "message_id": null, "message_id_md5": null, "in_reply_to": null, "content_type": "text/html", "references": null, "body": "Let's see the phoenix ", "internal": false, "preferences": {}, "updated_by_id": 3, "created_by_id": 3, "origin_by_id": null, "created_at": "2021-11-09T12:10:49.375Z", "updated_at": "2021-11-09T12:10:49.375Z", "attachments": [], "inline_attachments": [ { "id": 19, "filename": "image1.png", "size": "3735", "preferences": { "Content-Type": "image/png", "Mime-Type": "image/png", "Content-ID": "5.e384b84e-bfef-49f7-af22-8546fb99f8dc@fqdn", "Content-Disposition": "inline" } } ], "type": "note", "sender": "Agent", "created_by": "lauren@fastlane.inc", "updated_by": "lauren@fastlane.inc" } ``` ::: :::: ## Дохватање прилога Сада када имате све те прилоге унутар ваших тикета, можда ћете хтети да преузмете неке од њих. `GET`-захтев послат: `/api/v1/ticket_attachment/{ticket id}/{article id}/{attachment id}` Одговор: `{fajl slike}` ::: tip Ако нисте сигурни које чланке садржи тикет, прво их [молимо излистајте](#list-articles-by-ticket). :::