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.php


Invoerparameters:
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
Verplichte velden: Identifier of TicketID en TicketMessages (minimaal 1)

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
                )

        )

)