HostFact API versie 3.1



Tickets

Tickets zijn te beheren via de controller 'ticket'.



edit

Met behulp van deze functie is het mogelijk om een ticket te bewerken.
Alleen ingevoerde parameters worden gewijzigd.
Voorbeeldbestand: /voorbeelden/ticket/ticket.edit.php


Invoerparameters:
Veldnaam Waarde Omschrijving
Identifier int De unieke ID van een ticket.
TicketID string Het ticketnummer.
Geef deze parameter niet mee wanneer het ticketnummer automatisch bepaald mag worden.
Debtor int Debiteur ID indien bekend. Standaard: 0 (= geen)
EmailAddress string E-mailadres van ticket klant
CC text CC e-mailadressen scheiden met , of |
Type 'ticket' of 'email' Ticket via klantenpaneel of per e-mail ontstaan.
Standaard: 'ticket'
Subject string Onderwerp
Owner int De unieke ID van een medewerker.
Standaard: 0 (= geen)
Priority int Prioriteit: 5 = laag, 0 = normaal , 1 = hoog
Standaard: 0 (normaal)
Status int Ticket status, zie variabelen-lijst.
Standaard: 0 (nieuw)
Comment text Interne notitie
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'
Verplichte velden: Identifier of TicketID

Voorbeeld invoer:
<?php

require_once("../hostfact_api.php");

$api = new HostFactAPI();

$ticketParams = array(
				'TicketID' 	=> 'T20180001',
				'Subject' 	=> 'Change subject of new ticket'
);

$response = $api->sendRequest('ticket', 'edit', $ticketParams);

print_r_pre($response);

?>

Voorbeeld uitvoer:
Array
(
    [controller] => ticket
    [action] => edit
    [status] => success
    [date] => 2022-11-24T12:00:00+02:00
    [success] => Array
        (
            [0] => Ticket T20180001 is bewerkt
        )

    [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] => Change subject of new ticket
            [Owner] => 1
            [Priority] => 0
            [Status] => 1
            [Comment] => 
            [Number] => 2
            [LastDate] => 2018-09-13 16:24:50
            [LastName] => HostFact - HostFact
            [TicketMessages] => Array
                (
                    [0] => 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
                                        )

                                )

                            [Base64Message] => PGh0bWw+DQo8aGVhZD4NCgk8dGl0bGU+PC90aXRsZT4NCjwvaGVhZD4NCjxib2R5PldpdGggYSByZXNwb25zZTwvYm9keT4NCjwvaHRtbD4NCg==
                            [SenderID] => 1
                            [SenderName] => HostFact
                            [SenderEmail] => info@hostfact.nl
                        )

                    [1] => 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
                )

        )

)