| Uwierzytelnianie | wymagane |
| Format odpowiedzi | json |
| Metoda HTTP | POST |
Dodanie zgłoszenia.
https://your-system-name.thulium.com/api/tickets
|
to
wymagany |
Adres e-mail odbiorcy (zgodnie ze zdefiniowaną w systemie skrzynką). |
|
from
opcjonalny |
Adres e-mail autora zgłoszenia. |
|
subject
wymagany |
Temat zgłoszenia. |
|
body
wymagany |
Treść zgłoszenia. |
|
body_type
opcjonalny |
Typ wiadomości zgłoszenia. Domyślna wartość: PLAIN. Przykładowa wartość: HTML|PLAIN
|
|
comment
opcjonalny |
Komentarz zgłoszenia. |
|
cc
opcjonalny |
Tablica adresów kopii. |
|
attachments
opcjonalny |
Tablica tokenów zwróconych przez zasób pliki tymczasowe. |
|
source
opcjonalny |
Źródło dodawanego zgłoszenia. Domyślna wartość: email. Przykładowa wartość: email|phone|sms|chat|www
|
|
direction
opcjonalny |
Kierunek dodawanego zgłoszenia. Możliwe wartości: w imieniu klienta (in_behalf_of) i wychodzący e-mail do klienta (out). Domyślna wartość: in_behalf_of. Przykładowa wartość: in_behalf_of|out
|
|
user_login
opcjonalny |
Login przypisanego użytkownika.
Przykładowa wartość: akowalski
|
|
customer_id
opcjonalny |
Identyfikator klienta z CRM.
Przykładowa wartość: 32122
|
|
tags
opcjonalny |
Tagi
Przykładowa wartość: "tags":["tag1", "tag2", "tag3"]
|
|
status_id
opcjonalny |
Identyfikator statusu zgłoszenia zwrócony przez zasób statusy |
|
substatus_id
opcjonalny |
Identyfikator podstatusu zgłoszenia zwrócony przez zasób statusy |
|
category_id
opcjonalny |
Identyfikator kategorii zgłoszenia zwrócony przez zasób kategorie |
|
ticket_queue_id
opcjonalny |
Identyfikator kolejki zgłoszeń. Jeśli nie jest podany, to kolejka jest wybierana na podstawie skrzynki odbiorczej. |
|
custom_fields
opcjonalny |
Obiekt z wartościami pól specjalnych.
Przykładowa wartość: "custom_fields":{"field_name_1":"value_1","field_name_2":"value_2"}
|
| POST | https://your-system-name.thulium.com/api/tickets |
| Dane | {"to":"mailbox@foo.bar","subject":"ticket subject","from":"john.doe@foo.bar","body":"email content","comment":"ticket comment","attachments":["61527075253ba62a76ca5c"],"cc":["cc_mail1@foo.bar","cc_mail2@foo.bar"]} |
{
ticket_id: 1232
}
<?php
$data = '{"to":"mailbox@foo.bar","subject":"ticket subject","from":"john.doe@foo.bar","body":"email content","comment":"ticket comment","attachments":["61527075253ba62a76ca5c"],"cc":["cc_mail1@foo.bar","cc_mail2@foo.bar"]}';
$request = curl_init('https://your-system-name.thulium.com/api/tickets');
curl_setopt($request, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json; charset=utf-8',
'Content-Length: ' . mb_strlen($data)
));
curl_setopt($request, CURLOPT_USERPWD, 'api_user:api_pass');
curl_setopt($request, CURLOPT_TIMEOUT, 30);
curl_setopt($request, CURLOPT_RETURNTRANSFER, true);
curl_setopt($request, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($request, CURLOPT_POSTFIELDS, $data);
$response = curl_exec($request);
if ($response) {
$httpCode = curl_getinfo($request, CURLINFO_HTTP_CODE);
if ($httpCode == 200){
print_r(json_decode($response));
} else {
echo $response;
}
} else {
trigger_error(curl_error($request), E_USER_WARNING);
}
curl_close($request);
public class Example {
public static void main(String[] args) throws Exception {
ThuliumRestClient restClient = new ThuliumRestClient("api_user", "api_pass", true);
ThuliumRestClient.ThuliumRestResponse response = restClient.post("https://your-system-name.thulium.com/api/tickets", "{\"to\":\"mailbox@foo.bar\",\"subject\":\"ticket subject\",\"from\":\"john.doe@foo.bar\",\"body\":\"email content\",\"comment\":\"ticket comment\",\"attachments\":[\"61527075253ba62a76ca5c\"],\"cc\":[\"cc_mail1@foo.bar\",\"cc_mail2@foo.bar\"]}");
System.out.println(response);
}
}
curl -u api_user:api_pass -k -X POST -H "Content-type: application/json" -d '{"to":"mailbox@foo.bar","subject":"ticket subject","from":"john.doe@foo.bar","body":"email content","comment":"ticket comment","attachments":["61527075253ba62a76ca5c"],"cc":["cc_mail1@foo.bar","cc_mail2@foo.bar"]}' "https://your-system-name.thulium.com/api/tickets"
echo '{"to":"mailbox@foo.bar","subject":"ticket subject","from":"john.doe@foo.bar","body":"email content","comment":"ticket comment","attachments":["61527075253ba62a76ca5c"],"cc":["cc_mail1@foo.bar","cc_mail2@foo.bar"]}' | http -a api_user:api_pass POST https://your-system-name.thulium.com/api/tickets