Gratis setup bij jaarabonnementen
Nu inschrijven!
Ticketberichten
API-referentie: Ticketberichten-endpoints
De Ticketberichten API documenteert de conversatielaag binnen tickets: berichtenlijst/-detail, concepten, AI-antwoorden, verzendflows, bijlagen, tracking callbacks, escalatie, runtime-acties en toewijzingen van bericht-onderwerpen.
Overzicht en huidige endpoints
Een ticketbericht is het communicatieverslag binnen een ticket. Gebruik deze endpoints voor inkomende en uitgaande berichtinhoud, AI-gegenereerde antwoorden, bijlagen en topic/actie-workflows. Levenscyclusoperaties van het bovenliggende ticket vindt u op de Tickets-endpointpagina.
TicketMessages
| Methode | Pad | Toegang | Doel |
|---|---|---|---|
| GET | /api/TicketMessages?ticketId={ticketId} | TicketAccess | Berichten voor één ticket weergeven met paginatie en sortering. |
| GET | /api/TicketMessages/{id} | TicketAccessOrPhoneAuth | Volledige details van een bericht lezen. Telefoon-authenticatie aanvragen moeten overeenkomen met het berichtkanaal. |
| GET | /api/TicketMessages/{id}/prompt | TicketAccess | De opgeslagen AI-prompt voor een bericht ophalen. |
| GET | /api/TicketMessages/{id}/draft | TicketAccess | Het huidige conceptantwoord voor een bericht ophalen. |
| POST | /api/TicketMessages | TicketCreateFromPhone | Een raw AP_TicketMessage aanmaken in een bestaand ticket. |
| POST | /api/TicketMessages/create-new | TicketCreateFromPhone | Een bericht aanmaken en indien gewenst ook het bovenliggende ticket. Ondersteunt inkomende berichten, concepten, antwoorden en doorsturingen. |
| PUT | /api/TicketMessages/{id} | TicketAccessOrPhoneAuth | Bewerkbare berichtvelden bijwerken zoals antwoordtekst, inhoud, adressen, conceptstatus, UID en aangepaste velden. |
| DELETE | /api/TicketMessages/{id} | TicketAccess | Een bericht verwijderen na tickettoegangscontrole. |
| POST | /api/TicketMessages/{id}/reply | TicketAccessOrPhoneAuth | Een AI-antwoord genereren en opslaan. |
| POST | /api/TicketMessages/{id}/preview | TicketAccess | Definitieve preview van e-mailbericht opbouwen zonder verzending. |
| POST | /api/TicketMessages/{id}/send | TicketAccess | Een voorbereide reactie verzenden. |
| POST | /api/TicketMessages/{id}/send-new | TicketAccess | Een nieuw opgesteld uitgaand e-mailbericht verzenden. |
| POST | /api/TicketMessages/{id}/send-forward | TicketAccess | Een doorgestuurde e-mail verzenden. |
| POST | /api/TicketMessages/{id}/correct-topics | TicketAccess | Topictoewijzingen vervangen en status van topicleren markeren. |
| POST | /api/TicketMessages/{id}/detect-topics | TicketAccess | Topicdetectie uitvoeren met optionele modelName en executeActions. |
| GET | /api/TicketMessages/{id}/promptDocuments | TicketAccessOrPhoneAuth | Promptdocumenten en optioneel historische ticket- of eindgebruikercontext ophalen. |
| POST | /api/TicketMessages/{id}/execute-hook | TicketAccessOrPhoneAuth | Geconfigureerde hook-acties uitvoeren voor hookName. |
| POST | /api/TicketMessages/{id}/execute-action | TicketAccess | Eén actie uitvoeren op basis van actionID. |
| GET | /api/TicketMessages/{id}/execute-single-action | TicketAccess | Eén actietype uitvoeren uit de action query. |
| GET | /api/TicketMessages/{id}/attachments | TicketAccess | Lijst van bijlagemetagegevens van een bericht. |
| POST | /api/TicketMessages/{id}/attachments | TicketAccess | Een multipart-bestandsveld uploaden met de naam file; uploadlimiet is 50 MB. |
| DELETE | /api/TicketMessages/{id}/attachments/{attachmentId} | TicketAccess | Een berichtbijlage verwijderen. |
| POST | /api/TicketMessages/{ticketToken}/escalate | Public | Het nieuwste bericht in een getokeniseerde ticketflow escaleren. |
| POST | /api/TicketMessages/{messageId}/escalate-by-id | TicketAccessOrPhoneAuth | Een bericht escaleren op basis van ID. |
| GET | /api/TicketMessages/{ticketToken}/like-dislike | Public | Feedback van eindgebruiker voor like/dislike registreren. |
| GET | /api/TicketMessages/ot | Public | Tracking pixel endpoint die open status markeert wanneer het token overeenkomt. |
| GET | /api/TicketMessages/unsubscribejobad | Public | Een vacature-advertentierecord, gerefereerd via aangepaste berichtvelden, afmelden. |
TicketMessageTopics
| Methode | Pad | Toegang | Doel |
|---|---|---|---|
| GET | /api/TicketMessageTopics?messageId={messageId} | TicketAccessOrPhoneAuth | Topics weergeven die aan één bericht zijn toegewezen. |
| GET | /api/TicketMessageTopics/{id} | TicketAccessOrPhoneAuth | Eén bericht-topiclink lezen. |
| POST | /api/TicketMessageTopics | TicketAccessOrPhoneAuth | Een bericht-topiclink aanmaken na kanaalbeleid-controle. |
| PUT | /api/TicketMessageTopics/{id} | TicketAccessOrPhoneAuth | Het bericht/topic-paar bijwerken na toegangscontrole. |
| DELETE | /api/TicketMessageTopics/{id} | TicketAccessOrPhoneAuth | Een bericht-topiclink verwijderen. |
Velden en DTO's
TicketMessageCreateDTO
Body voor POST /api/TicketMessages/create-new en gerelateerde aanmaakflows.
| Domein | Velden | Opmerkingen |
|---|---|---|
| Bovenliggend ticket en kanaal | ticketID, channel, channelID | ticketID is optioneel; als dit ontbreekt, kan de server het bovenliggend ticket aanmaken. channel moet Email, Chat, Phone, WhatsApp of Teams zijn. |
| Richting en afzender | incoming, senderType, isDraft | Bepaalt inkomende/uitgaande verwerking, afzenderclassificatie en conceptlevenscyclus. |
| E-mailadressen | fromAddress, fromName, toAddress, ccAddress, bccAddress | fromAddress maximale lengte is 320. |
| Telefoon-/berichtadressen | fromNumber, toNumber | Gebruikt door telefoon- en berichtkanalen. |
| Inhoud | messageDate, subject, textBody, htmlBody, message | E-mail-, chat- en telefooninhoudvelden. | Context en koppeling | pageScreenshot, pageURL, additionalInfo, customFieldsData, uid, aiPrompt, emailTemplateID, replyToMessageID, forwardFromMessageID | Voorwaartsconcepten wissen reply-koppeling; custom fields zijn een woordenboek. |
TicketMessageUpdateDTO
Body voor PUT /api/TicketMessages/{id}.
| Domein | Velden | Opmerkingen |
|---|---|---|
| Routeringsovereenkomst | messageID | Moet overeenkomen met het route-id bij volledige update. |
| Bewerkbaar antwoord | ai_ModifiedResponse, message, additionalInfo | Wordt gebruikt voor gewijzigde reacties en extra context. |
| Uitgaande e-mail | subject, toAddress, ccAddress, bccAddress | Bewerkbare bestemmeling- en onderwerpvelden. |
| Status en identiteit | isDraft, uid, customFieldsData | Conceptstatus, eindgebruiker-id en aangepaste data. |
TicketMessageDetailDTO en TicketMessageSummaryDTO
Terugggegeven door detail-/lijst-endpoints en gebruikt door UI-workflows.
| Domein | Velden | Opmerkingen |
|---|---|---|
| Identiteit | messageID, ticketID, dateCreated, customerID | Eigenaarschap en entiteit-id’s. |
| Afzender en kanaal | senderType, customerRepID, customerRepName, channelID, channelName | Medewerker- en kanaalcontext. |
| Inhoud en adressering | message, subject, headers, htmlBody, textBody, bodyPreview, fromAddress, toAddress, ccAddress, bccAddress | Berichtinhoud, preview en adresmetadata. |
| Tracking en bezorging | isOpened, isBounced, lastOpenDate, messageIdentifier | E-mailbezorging en open-tracking status. |
| AI- en workflowstatus | aiSpamStatus, aiTopicsStatus, aiReplyStatus, ai_GeneratedResponse, ai_ModifiedResponse, isEscalated | AI-status, gegenereerde inhoud en escalatiestatus. |
| Gerelateerde data | topics, actions, customFieldDefinitions, customFieldsData | Gerelateerde topic-, actie- en aangepaste velddata. |
Bijlagen, onderwerpen en actie-bodies
TicketMessageAttachmentDTO
Metadata die wordt teruggegeven door de bijlagenlijst-endpoints. Binaire data wordt gedownload via het Bestand-endpoint.
| Gebied | Velden | Opmerkingen |
|---|---|---|
| Identiteit | ticketMessageAttachmentID, messageID | Identificatie van de bijlage en het bijhorende bericht. |
| Bestandsmetadata | fileName, contentType, fileSizeBytes, createdDateTime | Metadata van het bestand. |
| Bron en conversie | isEndUserProvided, isCustomerRepProvided, convertedFromAttachmentID, contentId | Vlaggen voor de bron en metadata voor conversie/threading. |
| Download | accessToken | Gebruik GET /api/File/{accessToken:guid} om de bestandbytes op te halen. |
TicketMessageTopicDTO en actie-bodies
Onderwerptoewijzings-DTO’s en compacte actie-bodies voor requests.
| Gebied | Velden | Opmerkingen |
|---|---|---|
| Onderwerp-koppeling | ticketMessageTopicID, messageID, topicID, topicName | Identificatie en weergavenaam van bericht/onderwerp-toewijzing. |
| Correctiestatus | corrected, correctionDate, correctedByCustomerRepID, correctedByCustomerRepName | Houdt handmatige onderwerp-correcties bij. |
| AI reply body | additionalInfo, overrideModelID, allowInternetAccess | Body voor POST /reply. Overrulen van internettoegang geldt enkel voor e-mailkanaalgeneratie. |
| Send/actie-bodies | modifiedAnswer, oversizedAttachmentDecision, actionID, action, stage | Wordt gebruikt bij versturen, execute-action en execute-single-action routes. |
Voorbeeldrequests
Concept aanmaken
Antwoord genereren
Bijlage uploaden
Concept aanmaken
Maak een uitgaand concept aan
POST /api/TicketMessages/create-new
Authorization: Bearer <token>
Content-Type: application/json
{
"ticketID": 101,
"channel": "Email",
"channelID": 7,
"incoming": false,
"isDraft": true,
"subject": "Follow-up",
"message": "Bedankt voor uw vraag."
}
Antwoord genereren
Genereer een AI-antwoord
POST /api/TicketMessages/987/reply
Authorization: Bearer <token>
Content-Type: application/json
{
"additionalInfo": "Hou het antwoord kort.",
"allowInternetAccess": false
}
Bijlage uploaden
Een bestand toevoegen
POST /api/TicketMessages/987/attachments
Authorization: Bearer <token>
Content-Type: multipart/form-data
[email protected]Inhoudstafel
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