Gratis setup bij jaarabonnementen
Meld je vandaag aan!
Tickets
API-referentie: ticketendpoints
Overzicht en huidige endpoints
Tickets zijn klantgerichte containers voor gesprekken via e-mail, chat, telefoon, WhatsApp en Teams. Gebruik deze pagina voor ticketmetadata en levenscyclusstatus. Gebruik Ticketberichten voor de eigenlijke communicatiegegevens en antwoordworkflows.
Tickets
| Methode | Pad | Toegang | Doel |
|---|---|---|---|
| GET | /api/Tickets | TicketAccess | Verwerkte tickets oplijsten met filters, sorteren en paginatie. |
| GET | /api/Tickets/{id} | TicketAccess | Lees één ticket na controle van klant- en medewerkerstoegang. |
| POST | /api/Tickets | TicketCreateFromPhone | Maak een ticket aan vanuit TicketWriteDTO. Telefoon-auth calls zijn gekoppeld aan het tokenkanaal. |
| PUT | /api/Tickets/{id} | TicketAccess | Vervang bewerkbare ticketvelden. Wijzigingen in toewijzing zijn rolgebonden. |
| PATCH | /api/Tickets/{id} | TicketAccessOrPhoneAuth | Pas ticketvelden aan met JSON Patch; telefoon-auth kan het tokenkanaal niet wijzigen. |
| DELETE | /api/Tickets/{id} | TicketAccess | Verwijder een toegelaten ticket. |
| PUT | /api/Tickets/bulk | TicketAccess | Massaal status, toewijzing, spam-/onderwerp-leermodus of actie uitvoeren bijwerken. |
| PUT | /api/Tickets/{id}/assign | TicketAccess | Wijs een ticket toe aan de huidige medewerker en stuur eventueel telefoongesprekken door. |
| GET | /api/Tickets/{ticketId}/play | TicketAccess | Download opgeslagen audiobestanden van telefoongesprekken voor een ticket indien een opname bestaat. |
| GET | /api/Tickets/{id}/history-summary | TicketAccessOrPhoneAuth | Retourneer historische eindgebruikerscontext voor de ticket UID. |
| POST | /api/Tickets/createchatticket | Public | Maak een webchatticket aan na validatie van het kanaaltoken en de hostnaam. |
Velden en DTO's
TicketWriteDTO en TicketBaseDTO
Worden gebruikt bij aanmaak-, vervang- en patchachtige ticketlevenscyclus-operaties.
| Domein | Velden | Opmerkingen |
|---|---|---|
| Toewijzing | customerRepID | Optionele toewijzing. Bulkwijziging behandelt leeg/null als behouden, 0 als ontkoppelen en positieve waarden als toewijzing, afhankelijk van toegangsrechten. |
| Vereiste status | status, subject, channelType | channelType is verplicht en beperkt tot 20 tekens. |
| Vlaggen | escalated, isSpam, isImportant, isClosed, isProcessed | Ticketstatusvlaggen die gebruikt worden bij lijst-, detail- en workflowoperaties. |
| Levenscyclusdata | closeDate, endDate, followUpDate, lastMessageDate | Toekomstige opvolgtickets worden verborgen tenzij includeFollowUp=true. |
| Kanaal en identiteit | channelID, uid, preview, summary | uid is beperkt tot 254 tekens en koppelt tickets aan de eindgebruikershistoriek. |
| Telefoonmetadata | twilio_CallSid, fromNumber, toNumber | Wordt gebruikt voor het afspelen van oproepen en in toewijs- of doorstuurflows. |
TicketReadDTO
Wordt teruggegeven door de endpointen voor ticketlijsten en detail.
| Domein | Velden | Opmerkingen |
|---|---|---|
| Identiteit | ticketID, token, dateCreated | Primaire identificator, publieke token en aanmaakdatum. |
| Opgehaalde labels | customerRepName, channelName | Weergave van namen opgehaald via toewijzing en kanaalrelaties. |
| Gerelateerde context | aiFeedbackComments, endUsers, topics | Gerelateerde feedback, eindgebruikersprofielen en topicnamen. |
| Runtime-vlaggen | hasRecording, lastEndUserMessageID | Wordt gebruikt voor telefoonaudio en de context van het laatste eindgebruikersbericht. |
Query- en bulk-DTO's
TicketQueryParameters
Queryobject voor GET /api/Tickets.
| Domein | Velden | Opmerkingen |
|---|---|---|
| Statusfilters | status, isSpam, isClosed, includeFollowUp | status kan meerdere waarden accepteren. |
| Toewijzings- en channelfilters | customerRepID, channelType, channelIDs | channelIDs kan meerdere waarden accepteren. |
| Eindgebruikerfilters | uid, endUserID, search | search doorzoekt ticketbericht-tekst. |
| Sorteren en paginatie | sortBy, sortOrder, pageNumber, pageSize | Standaard sorteervolgorde is desc; standaardwaarden voor pagina zijn 1 en 10. |
BulkUpdateRequest
Body voor PUT /api/Tickets/bulk.
| Domein | Velden | Opmerkingen |
|---|---|---|
| Vereist | ticketIDs, action | Bulkacties omvatten status, spam, topicdetectie, actieverwerking en opruimflows. |
| Toewijzing | customerRepID | Weglaten/null behoudt, 0 maakt de toewijzing ongedaan, positieve waarden wijzen toe, onderhevig aan roletests. | Workflowcontext | hookName, topicIds | hookName standaard op PostTopicDetection; topicIds wordt gebruikt voor topicupdates. |
Ticket-endpointnotities
GET /api/Tickets
Lijst met verwerkte tickets voor de geauthenticeerde klant. Ondersteunt status, customerRepID, channelType, channelIDs, uid, search, endUserID, isSpam, isClosed, includeFollowUp, sortBy, sortOrder, pageNumber en pageSize.
GET /api/Tickets/{id}
Geeft één TicketReadDTO terug na permissiecontrole van klant en medewerker. Beperkte gebruikers moeten eigenaar zijn van de toewijzing; medewerkers kunnen toegewezen of niet-toegewezen tickets lezen.
POST /api/Tickets en webchatcreatie
POST /api/Tickets maakt een ticket aan op basis van TicketWriteDTO. POST /api/Tickets/createchatticket is anoniem en creëert uitsluitend een chatticket na validatie van het kanaaltoken en de hostnaam.
PUT/PATCH /api/Tickets/{id}
PUT vervangt bewerkbare TicketWriteDTO-velden. PATCH past JSON Patch toe. Wijzigingen in toewijzing worden beperkt door rol, en bij phone-auth kan de kanaaltoken niet worden aangepast.
DELETE /api/Tickets/{id}
Verwijdert een ticket na klant- en ticketpermissiecontrole. Geeft 204 bij succes of 404 als het ticket ontbreekt.
PUT /api/Tickets/bulk
BulkUpdateRequest vereist ticketIDs en action. Huidige acties die door de service worden uitgevoerd zijn onder andere invertstate, spam, notspam, read, close, open, delete, deletecleanup, detectspam, detecttopics, executeactions en updatetopics.
Toewijzen, afspelen en geschiedenisoverzicht
PUT /api/Tickets/{id}/assign wijst toe aan de huidige medewerker en kan telefoongesprekken doorverbinden. GET /api/Tickets/{ticketId}/play streamt belaudio. GET /api/Tickets/{id}/history-summary geeft historische eindgebruikerscontext terug.
Voorbeeldrequests
Open tickets weergeven
GET /api/Tickets?status=Open&pageNumber=1&pageSize=25
Authorization: Bearer <token>Meerdere tickets sluiten
PUT /api/Tickets/bulk
Authorization: Bearer <token>
Content-Type: application/json
{
"ticketIDs": [101, 102],
"action": "close"
}Eén ticket toewijzen
PUT /api/Tickets/101/assign
Authorization: Bearer <token>Inhoudsopgave
AnswerPal: AI-gedreven oplossingen voor klantenservice die je ondersteuning en communicatie moeiteloos versterken.
Snelle links
Contact
Voor ondersteunings-, commerciële en partnervragen kunt u mailen naar [email protected]
AnswerPal
Bisschoppenhoflaan 380
2100 Antwerpen
België
+32.36416685
BE 0862.692.858