HostFact API versie 3.1
Tickets
Tickets zijn te beheren via de controller 'ticket'.
addmessage
Middels deze functie kunt u een nieuw ticketbericht toevoegen aan een bestaand ticket.
Voorbeeldbestand: /voorbeelden/ticket/ticket.addmessage.phpInvoerparameters:
Veldnaam | Waarde | Omschrijving |
---|---|---|
Identifier | int | De unieke ID van een ticket. |
TicketID | string | Het ticketnummer. |
ticket_sent_message_to_cc | 'yes' of 'no' | Stuur bericht naar CC e-mailadressen. Standaard: 'no' |
ticket_sent_notification_or_email | 'yes' of 'no' | Stuur notificatie naar medewerker (e-mail). Standaard: 'no' |
ticket_close_after_reply | 'yes' of 'no' | Sluit ticket? Standaard: 'no' |
TicketMessages | array | Ticketberichten: |
- Date | date | Datum bericht |
- Message | text | Bericht inhoud (HTML) |
- SenderID | int | De unieke ID van een medewerker. Standaard: 0 (= geen) |
- SenderName | string | Naam ticketklant |
- SenderEmail | string | E-mailadres naam |
- Attachments | array | Bijlagen: |
- Filename | string | De bestandsnaam |
- Base64 | text | Base64 encoded string |
Voorbeeld invoer:
<?php require_once("../hostfact_api.php"); $api = new HostFactAPI(); $ticketParams = array( 'TicketID' => 'T20180001', 'TicketMessages' => array( array( 'SenderName' => 'Employee - Company X', 'Message' => 'Second message to ticket' ) ) ); $response = $api->sendRequest('ticket', 'addmessage', $ticketParams); print_r_pre($response); ?>
Voorbeeld uitvoer:
Array ( [controller] => ticket [action] => addmessage [status] => success [date] => 2022-11-24T12:00:00+02:00 [success] => Array ( [0] => Bericht is toegevoegd aan ticket T20180001 ) [ticket] => Array ( [Identifier] => 1 [TicketID] => T20180001 [Debtor] => 1 [DebtorCode] => DB0001 [EmailAddress] => info@company.com [CC] => [Type] => ticket [Date] => 2018-01-14 15:08:04 [Subject] => Ticket test [Owner] => 1 [Priority] => 0 [Status] => 1 [Comment] => [Number] => 3 [LastDate] => 2022-11-24 11:55:36 [LastName] => Employee - Company X - [TicketMessages] => Array ( [0] => Array ( [Identifier] => 3 [Date] => 2022-11-24 11:55:36 [Subject] => Ticket test [Attachments] => [Base64Message] => U2Vjb25kIG1lc3NhZ2UgdG8gdGlja2V0 [SenderID] => 0 [SenderName] => Employee - Company X [SenderEmail] => ) [1] => Array ( [Identifier] => 2 [Date] => 2018-09-13 16:24:50 [Subject] => Ticket test [Attachments] => Array ( [0] => Array ( [name] => example.txt [location] => documents/tickets/T20180001/example.txt [type] => unknown [extension] => txt [filesize] => 0.0400390625 ) ) [Base64Message] => PGh0bWw+DQo8aGVhZD4NCgk8dGl0bGU+PC90aXRsZT4NCjwvaGVhZD4NCjxib2R5PldpdGggYSByZXNwb25zZTwvYm9keT4NCjwvaHRtbD4NCg== [SenderID] => 1 [SenderName] => HostFact [SenderEmail] => info@hostfact.nl ) [2] => Array ( [Identifier] => 1 [Date] => 2018-01-14 15:08:04 [Subject] => Ticket test [Attachments] => [Base64Message] => PGh0bWw+DQo8aGVhZD4NCgk8dGl0bGU+PC90aXRsZT4NCjwvaGVhZD4NCjxib2R5PkhlbGxvLCB0aGlzIGlzIGEgdGlja2V0IHRlc3Q8L2JvZHk+DQo8L2h0bWw+DQo= [SenderID] => 1 [SenderName] => HostFact [SenderEmail] => info@hostfact.nl ) ) [Translations] => Array ( [Status] => Open [Priority] => Normaal ) ) )